> 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/readme.md).

# Welcome to Advanced Kill Rewards

## Advanced Kill Rewards (BETA)

Welcome to **Advanced Kill Rewards**, a modern kill tracking, reward, leaderboard, bounty, and player shop system for DayZ servers.

AKR was built to give server owners more control over how players earn score, unlock rewards, chase milestones, hunt special targets, and spend their progress.

**Note to Server Owners:** NO REPACKS. This is an actively developed mod and will continue receiving updates, fixes, and new systems.

***

### Core Features

* **Full Stat Tracking:** Tracks PvP kills, infected kills, wolves, bears, herbivores, Rogue AI/eAI kills, score, deaths, killstreaks, nemesis data, special target kills, and shop purchases.
* **Milestone Rewards:** Create kill milestones that reward players with crates, loot boxes, or custom reward containers.
* **Reward Crate Support:** Rewards can be delivered to inventory or dropped on the ground. If inventory delivery fails, AKR can safely overflow rewards to the ground.
* **Live Leaderboard:** Shows the Top 15 hunters on the server using an optimized RPC stream instead of heavy JSON spam.
* **Player Tracker PDA:** Players can view their stats, score, next reward, reward loot preview, and tracked targets.
* **Reward Intel Menu:** Players can open a details menu showing milestone rewards, reward contents, active bonuses, special targets, and server reward rules.
* **AKR Shop:** A built-in player shop where players can spend score, kills, special kills, configured currency items, or trophy/item turn-ins.
* **Advanced Creature Tracking:** Track custom bosses, modded creatures, extra infected, extra bears, extra wolves, extra herbivores, and special target kills.
* **Custom Boss Counters:** Add custom creatures with clean display names so players see counters like *Target: Heavy Boss* instead of raw classnames.
* **Config Versioning:** Configs auto-upgrade when new settings are added, helping preserve existing server setups.
* **Legacy KillRewards Import:** Optional migration support for older KillRewards configs and player data.

***

### Combat, Score & Bonus Systems

* **Sniper Bonus:** Long-range kills can apply a score multiplier after the configured distance threshold.
* **Melee / Knife Bonus:** Melee kills can apply a separate score multiplier.
* **Double Points Days:** Configure specific days of the week for automatic double point events.
* **Vehicle Farming Control:** Server owners can disable infected/AI score farming from vehicle kills.
* **Hotzones:** Configure custom world zones that apply score multipliers.
* **Safezones:** Configure safezones where player kills can give zero points and apply penalties.
* **Death Penalties:** Optional stat wipes, score loss on death, and automatic killstreak resets.
* **Bounty System:** Players can become bounty targets after reaching a configured killstreak threshold.
* **Bounty Rewards:** Players who kill an active bounty target can receive a configured payout.

***

### 3D Tags, Streaks & Nemesis

* **Killstreak Tags:** Players on high killstreaks can receive 3D floating tags.
* **Nemesis Tags:** If the same player kills you enough times, they can become your Nemesis.
* **Anti-ESP Behavior:** Tags use visibility checks so they are not intended to work as wallhacks.
* **Tag Customization:** Server owners can configure tag text, whether the streak number is shown, tag color, and tag icon.

Config options include:

* **NemesisTag**
* **NemesisTagKillsRequiered**
* **EnableKillStreakTag**
* **ShowKillStreakAmount**
* **KillStreakTag**
* **killstreakIcon**
* **TagColorARGB**

***

### AKR Shop

AKR includes a configurable shop menu opened from the player tracker PDA. Server owners can create rewards that cost score, kills, special kills, currency items, or custom item turn-ins.

Shop config file: **profiles\LNGStudio\AdvancedKillRewards\AKRShop.json**

#### Shop Settings

* **ShopEnabled** - Enable or disable the AKR Shop.
* **ShopTitle** - Change the shop title shown in the UI.
* **ShopSubtitle** - Change the subtitle shown under the shop title.
* **DropPurchasesOnGround** - Default delivery mode for purchases.
* **AllowOverflowDrop** - If enabled, purchases can drop to the ground when inventory delivery fails.
* **AnnouncePurchasesToBuyer** - Sends the buyer a purchase notification.
* **RubleCurrencies** - Define currency item classnames and their values.

#### Shop Item Options

Each shop item can use:

* **Itemname** - Display name shown to players.
* **Itemclassname** - Classname of the reward item.
* **Description** - Description shown in the shop.
* **Category** - Category text shown in the shop details.
* **limit** - Purchase limit per player. Use 0 for unlimited.
* **Quantity** - Amount to give.
* **QuantityMode** - 0 = number of physical items, 1 = total internal quantity.
* **ItemQuantity** - Internal quantity per item, useful for mags, ammo, drinks, and consumables.
* **FillToMaxQuantity** - Fill the item to its maximum quantity.
* **DropOnGround** - Per-item delivery override. -1 uses global shop setting, 0 tries inventory, 1 drops on ground.
* **RequieredScore** - Score required to unlock the item.
* **RequieredKillCount** - Total regular kills required to unlock the item.
* **RequieredSpecialKillsCount** - Special target kills required to unlock the item.
* **Price** - Cost array for score, kills, special kills, currency, or item turn-ins.

#### Shop Price Options

Shop prices can combine multiple payment types:

* **ScorePrice** - Score removed on purchase.
* **KillsPrice** - Regular kill count removed on purchase.
* **SpecialKillsPrice** - Special target kills removed on purchase.
* **RublesPrice** - Currency value required using configured currency items.
* **itemClassnamePrice** - Required item classname for item turn-ins.
* **qty** - Quantity of that item required.

Example:

```json
{
    "Itemname": "Boss Trophy Cache",
    "Itemclassname": "SeaChest",
    "Description": "A premium cache unlocked by special target progress.",
    "Category": "Boss Rewards",
    "limit": 1,
    "Quantity": 1,
    "QuantityMode": 0,
    "ItemQuantity": 0,
    "FillToMaxQuantity": 0,
    "DropOnGround": -1,
    "RequieredScore": 1000,
    "RequieredKillCount": 50,
    "RequieredSpecialKillsCount": 1,
    "Price": [
        {
            "itemClassnamePrice": "BossHead",
            "qty": 2,
            "RublesPrice": 10000,
            "ScorePrice": 0,
            "KillsPrice": 0,
            "SpecialKillsPrice": 0
        }
    ]
}
```

### Creature & Boss Tracking

AKR can track vanilla and modded kills across multiple categories.

#### Tracked Categories

* PvP eliminations
* Infected
* Wolves
* Bears
* Herbivores
* Rogue AI / eAI
* Custom special creatures
* Custom boss targets

#### Custom Creature Config Options

* AdvancedSpecialCreatures - Modern custom target system with clean display names.
* DisplayName - Name shown to players in the tracker.
* ClassName - Creature classname to track.
* ShowOnTracker - Show this target on the player tracker.
* ShowOnLeaderboard - Count this target toward leaderboard special kill totals.
* SpecialTrackedCreatures - Legacy classname tracking support.
* ExtraCreaturesToCountasZombies - Extra classes counted as infected.
* ExtraCreaturesToCountasBears - Extra classes counted as bears.
* ExtraCreaturesToCountasWolves - Extra classes counted as wolves.
* ExtraCreaturesToCountasWolfs - Legacy wolf spelling support.
* ExtraCreaturesToCountasHerbivores - Extra classes counted as herbivores.
* ExtraCreaturesToCountasHervivores - Legacy herbivore spelling support.

AKR uses classname checks and inheritance checks to better support modded creatures.

***

### Reward Milestones

Milestone rewards are configured in:

profiles\LNGStudio\AdvancedKillRewards\AKR\_ServerConfig.json

Reward tier options:

* RewardName - Name shown to players.
* KillsRequired - Required kills for the milestone.
* DropOnGround - 0 tries inventory first, 1 drops on ground.
* BoxClass - Reward crate/container classname.
* LootItems - Items placed inside the reward crate/container.

Players can view configured milestones and reward previews in the Reward Intel menu.

***

### Messaging & Notifications

AKR supports configurable messaging behavior.

#### MessageSystem

* 1 - Standard DayZ chat messages.
* 2 - UI screen notifications.

#### Global Announcement Toggles

* ZombieGlobalMessage - Regular infected/animal kill feed.
* PlayerGlobalMessage - Regular PvP kill feed.
* MilestoneGlobalMessage - Milestone reward announcements.
* SniperBonusGlobalMessage - Long-range bonus announcements.
* MeleeBonusGlobalMessage - Melee/knife bonus announcements.
* SpecialKillGlobalMessage - Special target kill announcements.

By default, regular infected/animal global messages are disabled to reduce spam.

***

### UI Menus & Customization

Players can bind the following controls in DayZ keybind settings:

* Open Kill Tracker - Opens the player tracker PDA.
* Open Leaderboard - Opens the Top 15 leaderboard.
* Reload AKR Config (Admin) - Admin hotkey to reload AKR config live.

The Tracker menu also includes buttons for:

* More Details / Reward Intel - Shows milestones, bonus rules, special targets, and reward previews.
* AKR Shop - Opens the configurable player shop.

#### UI Config Options

These are configured in:

profiles\LNGStudio\AdvancedKillRewards\AKR\_ServerConfig.json

* UI\_BackgroundPath - Background image for the player Tracker PDA.
* UI\_PreviewWeapon - Classname used for the preview model on the tracker.
* UI\_LeaderboardBackgroundPath - Background image for the Leaderboard menu.
* killstreakIcon - Image set/icon path used for 3D streak tags.
* TagColorARGB - ARGB color used for 3D tags.
* KillStreakTag - Custom streak tag text.
* ShowKillStreakAmount - Show the exact streak number or only the configured tag text.

#### Shop UI Config Options

These are configured in:

profiles\LNGStudio\AdvancedKillRewards\AKRShop.json

* ShopTitle - Text shown at the top of the AKR Shop.
* ShopSubtitle - Subtitle shown under the shop title.
* Category - Item category text shown in the shop details.
* Description - Item description shown in the shop details.

The AKR Shop uses a built-in dark panel UI. It does not currently use a custom background image path.

***

### How To Add Custom UI Backgrounds

You can customize the Tracker and Leaderboard backgrounds.

#### Important

The image must be available to the client. Do not point the config to a file that only exists in your server profile folder. The texture should be packed inside a client-loaded mod.

#### Steps

1. Create your custom background as an .edds texture.
2. Pack it into your server/client mod, for example:

   MyServerMod\data\MyTrackerBackground.edds
3. Make sure all players load the mod that contains the texture.
4. Open:

   profiles\LNGStudio\AdvancedKillRewards\AKR\_ServerConfig.json
5. Change the tracker background:

   `"UI_BackgroundPath": "MyServerMod/data/MyTrackerBackground.edds"`
6. Change the leaderboard background:

   `"UI_LeaderboardBackgroundPath": "MyServerMod/data/MyLeaderboardBackground.edds"`
7. Restart the server, or use the admin reload keybind after the asset is already available to clients.

Example:

JSON

```
"UI_BackgroundPath": "AdvancedKillRewards/data/PlayerTracker.edds",
"UI_LeaderboardBackgroundPath": "AdvancedKillRewards/data/Leaderboard.edds",
"UI_PreviewWeapon": "M4A1"
```

***

### Admin Debugging

* DebugMode can be enabled for live kill, reward, and penalty debugging.
* Debug mode is disabled by default to prevent player/admin spam.
* Server owners can temporarily enable it while testing configs, then turn it back off for live servers.

***

### Legacy KillRewards Migration

Upgrading from the old KillRewards mod? AKR includes a legacy migration tool for old reward boxes and player data.

How to Import:

1. Ensure your old config folder exists at:

   \**profiles\KillReward\_Config\**
2. Make sure your old files exist:

   KRWeponbox\_Config.json

   KRZombie\_Config.json
3. Make sure old player files are inside:

   \**profiles\KillReward\_Config\PlayerDB\**
4. Start your server once with AKR installed to generate the new files.
5. Shut down the server.
6. Open:

   profiles\LNGStudio\AdvancedKillRewards\AKR\_ServerConfig.json
7. Change:

   `"ConvertKRConfig": false`

   to:

   `"ConvertKRConfig": true`
8. Start your server.

AKR will read the old box/player data, convert it into the AKR format, import legacy players, and automatically set ConvertKRConfig back to false when finished.

***

### Config Files

* AKR\_ServerConfig.json - Main tracking, rewards, bonuses, zones, UI, messaging, tags, bounty, and creature settings.
* AKRShop.json - AKR Shop settings, shop items, prices, item costs, quantity behavior, and currency item values.
* Player data is stored under the AKR profile database and is used for stats, leaderboard, special kills, and shop purchase limits.

***

### Usage Terms

* No Repacking / Reuploads: You are not permitted to pack this mod into a server pack or re-upload it to the Steam Workshop or any other platform.
* Server Use: Load the mod normally through your server mod list.
* Enforcement: Unauthorized reuploads may receive a DMCA takedown.

***

***

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><i class="fa-bolt">:bolt:</i></h4></td><td>SimpleNameTags<strong>Config.json</strong></td><td>Navigate the commented config</td><td></td><td></td><td><a href="/pages/zQMOdbLSo4jLR2ohrbzX">/pages/zQMOdbLSo4jLR2ohrbzX</a></td></tr><tr><td></td><td>CreatureTags.json</td><td>Navigate the commented config</td><td></td><td></td><td><a href="/pages/ak7f8QRcmApnfApdeyTU">/pages/ak7f8QRcmApnfApdeyTU</a></td></tr></tbody></table>


---

# 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/readme.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.