> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.mrerrorx.dev/primaxbattleroyalex/llms.txt
> Use this file to discover all available pages before exploring further.

# Deathmatch Mode: Fast-Paced Respawn and Kill Tracking

> Deathmatch is a timed 10-minute combat mode where players respawn on death. Kills are tracked and the top 3 players are announced at the end.

<Warning>
  **Server requirements:** PrimaxBattleRoyaleX generates a fresh world for every match and deletes it once the match ends. World generation runs on the server's main thread, so a weak CPU or low RAM will cause noticeable lag. A quality managed Minecraft host or a dedicated VPS with a strong single-thread CPU and ample RAM is strongly recommended. Shared or budget hosting is not suitable.
</Warning>

Deathmatch is PrimaxBattleRoyaleX's fast-paced, respawn-based combat mode. Unlike Solo and Squad where death means elimination, Deathmatch lets players respawn and jump right back into the action. There's no waiting around — every death is just a setback, and every kill pushes you up the leaderboard. At the end of the match, the top 3 kill leaders are crowned and their scores are announced to all players.

## How It Works

<Steps>
  <Step title="Match Begins">
    A timed Deathmatch starts — by default 10 minutes, though the duration is fully configurable. All participants are teleported into the arena with their starting equipment.
  </Step>

  <Step title="Respawn on Death">
    When a player dies, they respawn automatically with their starting equipment. Deaths don't knock players out of the match — they just temporarily remove them from play.
  </Step>

  <Step title="Kills Are Tracked">
    Every kill is recorded in two places: the current match's leaderboard score, and the player's permanent Deathmatch kill statistics. Both update in real time throughout the match.
  </Step>

  <Step title="Border Shrinks">
    The world border can be configured to shrink during the match, keeping players close together and ensuring the action stays concentrated rather than spread across the map.
  </Step>

  <Step title="Match Ends">
    The match ends when either the timer expires or only 1 player remains in the arena. At that point, the top 3 players by kill count are announced to everyone on the server.
  </Step>
</Steps>

## Kill Statistics

Deathmatch tracks two separate kill counts for each player:

| Stat                   | Description                                                               | PlaceholderAPI Variable          |
| ---------------------- | ------------------------------------------------------------------------- | -------------------------------- |
| Match kills            | Kills scored in the current match — used for the end-of-match leaderboard | *(match-scoped, not persistent)* |
| Total Deathmatch kills | Permanent cumulative kill count across all Deathmatch matches             | `%primaxbr_deathmatch_kills%`    |

<Info>
  Deathmatch kills are tracked separately from Solo and Squad kills in player statistics. Use `%primaxbr_deathmatch_kills%` to display Deathmatch-specific kill counts on scoreboards, tab lists, or any PlaceholderAPI-compatible plugin.
</Info>

## Features

* **Starting equipment on respawn** — players receive a configured loadout each time they spawn, ensuring everyone re-enters the match ready to fight (configurable in `game-settings.yml`)
* **World border shrinks during the match** — optionally shrink the border to keep combat zones tight and prevent players from camping the edges
* **Early end condition** — if only 1 player remains in the arena at any point, the match ends immediately rather than waiting for the timer
* **Top 3 kill leaders announced** — at match end, the three players with the most kills are broadcast to all players in a server-wide announcement

## Configuration

All Deathmatch settings — including match duration, starting equipment, border shrink behavior, and respawn rules — are configured in `game-settings.yml`.

See the [Game Settings configuration reference](/primaxbattleroyalex/primaxbattleroyalex/configuration/game-settings) for a full breakdown of every available option.