> For the complete documentation index, see [llms.txt](https://lng.gitbook.io/lng-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lng.gitbook.io/lng-docs/home/kill-rewards/getting-started/profiles-lngstudio-advancedkillrewards-akr_serverconfig..md).

# profiles\LNGStudio\AdvancedKillRewards\AKR\_ServerConfig.

````

The `AKR_ServerConfig.json` is the main server configuration file for Advanced Kill Rewards. It controls player stat tracking, kill rewards, global announcements, UI backgrounds, boss/special creature tracking, safezones, hotzones, penalties, bounties, killstreak tags, and legacy KillRewards conversion.

Config location:
`profiles/LNGStudio/AdvancedKillRewards/AKR_ServerConfig.json`

## 🖥️ UI & Menu Settings

These settings control the player-facing AKR menus.

| Property | Type | Description |
| :--- | :--- | :--- |
| `UI_BackgroundPath` | `String` | Sets the custom background image for the main Tracker menu. |
| `UI_LeaderboardBackgroundPath` | `String` | Sets the custom background image for the Leaderboard menu. |
| `UI_PreviewWeapon` | `String` | Sets the item classname shown as the 3D preview object in the Tracker menu. |

```json
{
    "UI_BackgroundPath": "AdvancedKillRewards/data/LNG.edds",
    "UI_PreviewWeapon": "M4A1",
    "UI_LeaderboardBackgroundPath": "AdvancedKillRewards/data/LeaderboardLNG.edds"
}
````

> 💡 To use your own UI background:
>
> 1. Create or convert your image to `.edds`.
> 2. Pack it inside a client-side server mod.
> 3. Use the mod path in the config (e.g., `"MyServerMod/data/MyTrackerBackground.edds"`).
>
> Players must load the mod containing the `.edds` file. Server owners can then restart the server or use the admin config reload if available.

### 📢 Messaging & Global Announcements

These settings control how AKR sends messages to players.

| **Property**               | **Type** | **Description**                                                     |
| -------------------------- | -------- | ------------------------------------------------------------------- |
| `MessageSystem`            | `Int`    | `1` = DayZ chat messages. `2` = screen/UI notifications.            |
| `ZombieGlobalMessage`      | `Int`    | `0` = regular infected/animal/AI kill feed disabled. `1` = enabled. |
| `PlayerGlobalMessage`      | `Int`    | `0` = regular PvP kill feed disabled. `1` = enabled.                |
| `MilestoneGlobalMessage`   | `Int`    | Broadcasts when a player earns a milestone reward.                  |
| `SniperBonusGlobalMessage` | `Int`    | Broadcasts when a player earns a long-range sniper bonus.           |
| `MeleeBonusGlobalMessage`  | `Int`    | Broadcasts when a player earns a melee/knife bonus.                 |
| `SpecialKillGlobalMessage` | `Int`    | Broadcasts when a player kills a configured special target.         |

JSON

```
{
    "MessageSystem": 2,
    "ZombieGlobalMessage": 0,
    "PlayerGlobalMessage": 1,
    "MilestoneGlobalMessage": 1,
    "SniperBonusGlobalMessage": 1,
    "MeleeBonusGlobalMessage": 1,
    "SpecialKillGlobalMessage": 1
}
```

### 🎯 Score, Bonuses & Combat Rules

These settings control how players earn extra score from combat.

| **Property**              | **Type** | **Description**                                                                  |
| ------------------------- | -------- | -------------------------------------------------------------------------------- |
| `SniperDistanceThreshold` | `Float`  | Distance in meters required for a sniper bonus.                                  |
| `SniperMultiplier`        | `Float`  | Score multiplier applied when the sniper bonus is earned.                        |
| `MeleeMultiplier`         | `Float`  | Score multiplier applied when a kill is made with melee/knife damage.            |
| `ZombieKillsbyCar`        | `Int`    | `0` = vehicle kills on infected/AI do not count. `1` = they count.               |
| `DoublePointsDays`        | `Array`  | Days of the week where kills receive double points (`1` = Monday, `7` = Sunday). |

JSON

```
{
    "SniperDistanceThreshold": 300.0,
    "SniperMultiplier": 2.0,
    "MeleeMultiplier": 2.0,
    "ZombieKillsbyCar": 1,
    "DoublePointsDays": [6, 7]
}
```

### 💀 Death, Penalties & Safezone Punishment

These settings control what happens when players die or commit safezone PvP.

| **Property**               | **Type** | **Description**                                                                                    |
| -------------------------- | -------- | -------------------------------------------------------------------------------------------------- |
| `Statslose`                | `Int`    | `0` = players keep stats on death. `1` = death wipes PvP, PvE, animal, AI, and special kill stats. |
| `PointLoseByDeath`         | `Int`    | Score deducted when a player dies.                                                                 |
| `PlayerKillNegativeReward` | `Int`    | Score deducted from a player who kills another player inside a safezone.                           |
| `LoseMoney`                | `Int`    | Optional banking fine value (keeps AKR independent of a hard banking dependency).                  |

JSON

```
{
    "Statslose": 0,
    "PointLoseByDeath": 100,
    "PlayerKillNegativeReward": 500,
    "LoseMoney": 1000
}
```

### 🛑 Zones, Safezones & Hotzones

The `ActiveZones` array lets you create custom circular zones using X/Z map coordinates.

| **Property**      | **Type** | **Description**                                                                                          |
| ----------------- | -------- | -------------------------------------------------------------------------------------------------------- |
| `ZoneName`        | `String` | Name of the zone.                                                                                        |
| `X` and `Z`       | `Float`  | Center position of the zone on the map.                                                                  |
| `Radius`          | `Float`  | Zone size in meters.                                                                                     |
| `IsSafeZone`      | `Int`    | `0` = hotzone/normal zone. `1` = safezone.                                                               |
| `PointMultiplier` | `Float`  | Score multiplier used inside the zone (Safezones usually use `0.0`. Hotzones can use values like `2.0`). |

JSON

```
{
    "ActiveZones": [
        {
            "ZoneName": "Trader Safezone",
            "X": 4000.0,
            "Z": 4000.0,
            "Radius": 150.0,
            "IsSafeZone": 1,
            "PointMultiplier": 0.0
        },
        {
            "ZoneName": "NWAF Hotzone",
            "X": 4500.0,
            "Z": 10000.0,
            "Radius": 500.0,
            "IsSafeZone": 0,
            "PointMultiplier": 2.0
        }
    ]
}
```

### 🤠 Bounty System

The bounty system marks dangerous players based on killstreaks.

| **Property**      | **Type** | **Description**                                              |
| ----------------- | -------- | ------------------------------------------------------------ |
| `BountyEnabled`   | `Int`    | `0` = disabled. `1` = enabled.                               |
| `BountyThreshold` | `Int`    | Killstreak required before a player becomes a bounty target. |
| `BountyReward`    | `Int`    | Score awarded to the player who kills the bounty target.     |

JSON

```
{
    "BountyEnabled": 1,
    "BountyThreshold": 5,
    "BountyReward": 1000
}
```

### 🏷️ 3D Tags, Killstreaks & Nemesis

These settings control optional floating 3D player tags.

| **Property**               | **Type** | **Description**                                                                 |
| -------------------------- | -------- | ------------------------------------------------------------------------------- |
| `NemesisTag`               | `Int`    | `0` = disabled. `1` = enabled.                                                  |
| `NemesisTagKillsRequiered` | `Int`    | How many times the same player must kill someone before becoming their nemesis. |
| `EnableKillStreakTag`      | `Int`    | `0` = disabled. `1` = enabled.                                                  |
| `ShowKillStreakAmount`     | `Int`    | `0` = show custom tag text. `1` = show actual kill count.                       |
| `KillStreakTag`            | `String` | Custom text shown when `ShowKillStreakAmount` is disabled.                      |
| `killstreakIcon`           | `String` | DayZ icon path used by the tag.                                                 |
| `TagColorARGB`             | `Int`    | ARGB color value used for the floating tag.                                     |

JSON

```
{
    "NemesisTag": 1,
    "NemesisTagKillsRequiered": 10,
    "EnableKillStreakTag": 1,
    "ShowKillStreakAmount": 1,
    "KillStreakTag": "NEMESIS",
    "killstreakIcon": "set:dayz_gui image:circle",
    "TagColorARGB": -65536
}
```

### 👹 Special Creature & Boss Tracking

AKR can track custom modded enemies as named special targets using the `AdvancedSpecialCreatures` array for clean boss tracking with display names.

| **Property**        | **Type** | **Description**                                                           |
| ------------------- | -------- | ------------------------------------------------------------------------- |
| `DisplayName`       | `String` | Name shown in the player UI.                                              |
| `ClassName`         | `String` | Creature classname to track.                                              |
| `ShowOnTracker`     | `Int`    | `0` = hidden from personal tracker. `1` = shown on personal tracker.      |
| `ShowOnLeaderboard` | `Int`    | `0` = does not count toward leaderboard. `1` = counts toward leaderboard. |

JSON

```
{
    "AdvancedSpecialCreatures": [
        {
            "DisplayName": "Heavy Boss",
            "ClassName": "ZmbM_usSoldier_heavy",
            "ShowOnTracker": 1,
            "ShowOnLeaderboard": 1
        }
    ]
}
```

*(If this array is empty, no special target rows will appear in the player tracker).*

### 🧟 Extra Creature Category Support

These arrays let server owners force custom modded creatures into normal AKR categories.

| **Property**                        | **Type** | **Description**                                                    |
| ----------------------------------- | -------- | ------------------------------------------------------------------ |
| `ExtraCreaturesToCountasZombies`    | `Array`  | Custom infected/AI classnames that should count as infected kills. |
| `ExtraCreaturesToCountasBears`      | `Array`  | Custom bear classnames that should count as bear kills.            |
| `ExtraCreaturesToCountasWolves`     | `Array`  | Custom wolf classnames that should count as wolf kills.            |
| `ExtraCreaturesToCountasHerbivores` | `Array`  | Custom deer, elk, cows, pigs, or other herbivore classnames.       |
| `ExtraCreaturesToCountasWolfs`      | `Array`  | Legacy spelling field for compatibility.                           |
| `ExtraCreaturesToCountasHervivores` | `Array`  | Legacy spelling field for compatibility.                           |

JSON

```
{
    "ExtraCreaturesToCountasBears": [
        "MPG_Bear_2_3",
        "MPG_Bear_2_4"
    ],
    "ExtraCreaturesToCountasWolves": [
        "MyMod_WolfBoss"
    ],
    "ExtraCreaturesToCountasHerbivores": [
        "MyMod_Deer_Heavy"
    ]
}
```

### 🎁 Milestone Reward Boxes

The `KillRewardBoxes` array controls kill milestone rewards.

| **Property**    | **Type** | **Description**                                                               |
| --------------- | -------- | ----------------------------------------------------------------------------- |
| `RewardName`    | `String` | Name shown in the Reward Intel menu.                                          |
| `KillsRequired` | `Int`    | Kill count required to earn this reward.                                      |
| `DropOnGround`  | `Int`    | `0` = tries to place reward into inventory. `1` = drops at the player’s feet. |
| `BoxClass`      | `String` | Container classname to spawn.                                                 |
| `LootItems`     | `Array`  | Items placed inside the reward crate.                                         |

JSON

```
{
    "KillRewardBoxes": [
        {
            "RewardName": "Rookie Supplies",
            "KillsRequired": 10,
            "DropOnGround": 1,
            "BoxClass": "WoodenCrate",
            "LootItems": [
                "BandageDressing",
                "WeaponCleaningKit",
                "TacticalBaconCan"
            ]
        }
    ]
}
```

### 🛡️ Admin & Debug Settings

| **Property**      | **Type** | **Description**                                                                         |
| ----------------- | -------- | --------------------------------------------------------------------------------------- |
| `AdminSteamIDs`   | `Array`  | Steam64 IDs allowed to use AKR admin actions (like config reload).                      |
| `DebugMode`       | `Int`    | `0` = disabled. `1` = enables admin debug popups/logging for tracking, penalties, etc.  |
| `Version`         | `Int`    | Used internally by AKR for config updates. Do not manually change.                      |
| `ConvertKRConfig` | `Int`    | `0` = disabled. `1` = runs the legacy KillRewards conversion tool. (Disable after use). |

JSON

```
{
    "Version": 15,
    "DebugMode": 0,
    "ConvertKRConfig": 0,
    "AdminSteamIDs": [
        "76561198267894929"
    ]
}
```

### 💻 Condensed Example Configuration

JSON

```
{
    "Version": 15,
    "DebugMode": 0,
    "ConvertKRConfig": 0,
    "UI_BackgroundPath": "AdvancedKillRewards/data/LNG.edds",
    "UI_PreviewWeapon": "M4A1",
    "UI_LeaderboardBackgroundPath": "AdvancedKillRewards/data/LeaderboardLNG.edds",
    "AdminSteamIDs": [
        "76561198267894929"
    ],
    "MessageSystem": 2,
    "ZombieGlobalMessage": 0,
    "PlayerGlobalMessage": 1,
    "MilestoneGlobalMessage": 1,
    "SniperBonusGlobalMessage": 1,
    "MeleeBonusGlobalMessage": 1,
    "SpecialKillGlobalMessage": 1,
    "SniperDistanceThreshold": 300.0,
    "SniperMultiplier": 2.0,
    "MeleeMultiplier": 2.0,
    "ZombieKillsbyCar": 1,
    "DoublePointsDays": [6, 7],
    "Statslose": 0,
    "PointLoseByDeath": 100,
    "PlayerKillNegativeReward": 500,
    "BountyEnabled": 1,
    "BountyThreshold": 5,
    "BountyReward": 1000,
    "NemesisTag": 1,
    "NemesisTagKillsRequiered": 10,
    "EnableKillStreakTag": 1,
    "ShowKillStreakAmount": 1,
    "KillStreakTag": "NEMESIS",
    "killstreakIcon": "set:dayz_gui image:circle",
    "TagColorARGB": -65536,
    "AdvancedSpecialCreatures": [
        {
            "DisplayName": "Heavy Boss",
            "ClassName": "ZmbM_usSoldier_heavy",
            "ShowOnTracker": 1,
            "ShowOnLeaderboard": 1
        }
    ],
    "KillRewardBoxes": [
        {
            "RewardName": "Rookie Supplies",
            "KillsRequired": 10,
            "DropOnGround": 1,
            "BoxClass": "WoodenCrate",
            "LootItems": [
                "BandageDressing",
                "WeaponCleaningKit"
            ]
        }
    ]
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://lng.gitbook.io/lng-docs/home/kill-rewards/getting-started/profiles-lngstudio-advancedkillrewards-akr_serverconfig..md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.