GTG Live Map & Position Log

**Real-time tactical awareness is here!** The **[GTG] Live Map & Position Logger** is a powerful server-side utility that integrates your Arma Reforger server with the **[GTG] Live Map** service, providing an unparalleled tactical overview for your community.

Track player positions, analyze operations with a replay feature, visualize hotspots with heatmaps, and much more.

**This mod does NOT display a map in-game.** It is a server-side tool that **sends position data** to the web-based live map service.

---

### **Features**
*   **Live Position Tracking:** Continuously sends player positions, GUIDs, names, and faction data to the [GTG] Live Map API.
*   **Low Performance Impact:** Optimized to send data in efficient batches at configurable intervals.
*   **Easy Configuration:** A simple `config.json` file is all you need to connect your server.
*   **Secure:** Uses a unique API key for each server, ensuring your data is sent to the correct map.

---

### **Setup and Configuration (Required)**

Follow these simple steps to connect your server:

#### **Step 1: Get Your API Key**
1.  Go to **[map.gtg-arma.de](https://map.gtg-arma.de)** and log in with your Discord account.
2.  Navigate to your **Dashboard**.
3.  Click **"Add New Server"**, fill in the details, and create your server.
4.  You will be presented with a unique **API Key**. **Copy this key immediately** and store it securely.

#### **Step 2: Install and Enable the Mod**
1.  Subscribe to this mod in the workshop.
2.  Add the mod to your Arma Reforger server's mod list and ensure it is enabled.

#### **Step 3: Create the Configuration File**
1.  On your game server machine, navigate to your server's profile folder.
2.  Create a new JSON file at the following location:  
    `{Your_Server_Profile_Folder}/profile/GTG_LiveMap_config.json`

3.  Paste the following content into the file:

    ```json
    {
        "contextURL": "https://map.gtg-arma.de/api/v1/positions",
        "APIToken": "PASTE_YOUR_API_KEY_HERE",
        "intervalLog": 1,
        "intervalAPI": 1
    }
    ```

#### **Step 4: Configure the File**
1.  **`contextURL`**: This should **always** be `https://map.gtg-arma.de/api/v1/positions`. Do not change this unless instructed otherwise.
2.  **`APIToken`**: Replace `"PASTE_YOUR_API_KEY_HERE"` with the API Key you copied from the dashboard in Step 1.
3.  **`intervalLog`** & **`intervalAPI`**: These values (in seconds) control how often data is collected and sent. A value of `1` is recommended for real-time tracking. You can increase this value (e.g., to `5`) to reduce the update frequency if needed.

#### **Step 5: Restart Your Server**
After saving the configuration file, restart your Arma Reforger server. The mod will now begin sending position data to your personal live map.

---

### **Important Notes**

*   **Damage & Kill Logs:** This mod **only** handles position data. For full functionality, including kill-feeds and damage events on the map, you also need to install the [ReforgerJSLogging](https://reforger.armaplatform.com/workshop/6572332E971992EF-ReforgerJSLogging) mod and configure the log-fetcher (FTP/SFTP) in your server's dashboard on **[map.gtg-arma.de](https://map.gtg-arma.de)**.
*   **One API Key per Server:** Each API key is unique to a single server instance. Do not reuse the same key for multiple servers. Generate a new key for each new server in the dashboard.
*   **Support:** For questions or support, please join our [GTG Discord Server](https://discord.com/invite/gtg-german-tactical-group).