ZoneMarkers

**ZoneMarkers** is a robust mod for Arma Reforger that gives server owners the power to draw large, persistent, and highly configurable colored zones directly onto the in-game map. These world-sized overlays are perfect for visually enforcing boundaries, marking special event areas, or defining team territories, and they remain a consistent size regardless of map zoom.


## Key Features

*   **Fully Customizable Zones:** Define zones by setting a simple grid line value. Customize the text, color, and transparency for each zone.
*   **Standard & Seeding Modes:** Automatically switch between two different sets of boundaries based on player count. Create larger, open battlefields for standard play and smaller, more focused combat areas for server seeding.
*   **Scenario-Specific Profiles:** Define unique zone configurations for every map and mission you run, all within a single, easy-to-manage JSON file. The mod intelligently detects the running scenario and applies the correct profile.
*   **Dynamic Faction Colors:** Zones can automatically adopt the color of the northernmost or southernmost faction's HQ, giving players an immediate visual cue of territorial control.
*   **Live Reload Command:** The `#zonemarkers -reload` command allows admins to update the configuration file and see changes in-game instantly, without a server restart, making fine-tuning a breeze.

## Configuration Guide for Server Owners

Getting started with ZoneMarkers is simple.

1.  **Run the Mod Once**
    After adding the mod to your server, start it once. The mod will automatically generate a configuration file and a helpful README here:
    *   `$profile:/ZoneMarkers/zonemarkers_config.json`
    *   `$profile:/ZoneMarkers/zonemarkers_readme.txt`

2.  **Find Your Scenario Key**
    The most important step is to configure zones for your specific mission. Check your server's RPT log file for a message like this:
    > `[ZoneMarkers][ConfigManager] IMPORTANT: System will use scenario configuration key: 'CTI_Campaign_Arland'`
    
    This key (`CTI_Campaign_Arland` in the example) is what you must use in the `m_ScenarioConfigs` section of your JSON.

3.  **Edit the JSON**
    Open `zonemarkers_config.json` and customize it. If the mod cannot find a profile for your current scenario key, it will use the `m_DefaultScenario` profile as a fallback.
    
    Here is an example structure for the Arland map:

    ```json
    {
      "m_GlobalSettings": {
        "m_bEnableZoneMarkers": true,
        "m_sLogLevel": "NORMAL"
      },
      "m_ScenarioConfigs": {
        "CTI_Campaign_Arland": {
          "m_aZones": [
            {
              "m_sZoneId": "Arland_North_Zone",
              "m_bIsEnabled": true,
              "m_bIsNorthFacingZone": true,
              "m_bUseDynamicHQColorOverride": true,
              "m_sStandardGridLineLimit": "30",
              "m_sStandardText": "NORTHERN OUT OF BOUNDS",
              "m_sStandardColorRGB": "0.4,0.4,0.8,0.30",
              "m_sStandardFactionKeyForColor": "",
              "m_sSeedingGridLineLimit": "25",
              "m_sSeedingText": "SEEDING ACTIVE",
              "m_sSeedingColorRGB": "0.8,0.8,0.2,0.45",
              "m_sSeedingFactionKeyForColor": ""
            },
            {
              "m_sZoneId": "Arland_South_Zone",
              "m_bIsEnabled": true,
              "m_bIsNorthFacingZone": false,
              "m_bUseDynamicHQColorOverride": true,
              "m_sStandardGridLineLimit": "5",
              "m_sStandardText": "SOUTHERN OUT OF BOUNDS",
              "m_sStandardColorRGB": "0.8,0.4,0.4,0.30",
              "m_sStandardFactionKeyForColor": "",
              "m_sSeedingGridLineLimit": "15",
              "m_sSeedingText": "SEEDING ACTIVE",
              "m_sSeedingColorRGB": "0.8,0.8,0.2,0.45",
              "m_sSeedingFactionKeyForColor": ""
            }
          ]
        }
      },
      "m_DefaultScenario": {
        "m_aZones": []
      }
    }
    ```

## Admin Commands

*   `#zonemarkers -reload`
    *   Forces the server to re-read and apply the `zonemarkers_config.json` file. Requires Admin/GM permissions.
*   `#zonemarkers`
    *   Displays a simple help message with available commands.

## Future Development

This mod is being actively enhanced. Support for additional zone shapes (such as circles, rectangles, and vertical bands) is planned for future updates to provide even greater mapping flexibility.