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

# BattleRoyaleX Game Modes: Solo, Squad & Deathmatch

> Learn how Solo, Squad, and Deathmatch modes work in PrimaxBattleRoyaleX — including rules, win conditions, and configuration options for each mode.

PrimaxBattleRoyaleX offers three distinct game modes — Solo, Squad, and Deathmatch — each built around a different style of play. All three modes run independently and simultaneously, and every aspect of their behavior is configurable in `game-settings.yml`.

<Tabs>
  <Tab title="Solo">
    Solo Battle Royale drops every player into the arena on their own. There are no teams and no second chances — the last player standing wins the match.

    **How it works:**

    * Each queue entry is a single player.
    * The world border begins large and shrinks over time, forcing players closer together.
    * A PvP grace period at the start gives players time to land and loot before combat begins.
    * Players spawn with an elytra for a safe, controlled landing at the start of each match.
    * The match ends as soon as one player remains.

    **Win condition:** Be the last player alive.

    **Victory reward:** The winner receives the configured solo victory reward.

    **Configurable options:**

    * PvP grace period duration
    * Elytra on spawn (enable/disable)
    * Match timer
    * Border size and shrink rate
  </Tab>

  <Tab title="Squad">
    Squad Battle Royale is a team-based game mode that integrates directly with BetterTeams. Teams compete against each other until only one team has survivors.

    **How it works:**

    * Teams are formed using BetterTeams. A match starts once the configured minimum number of teams is in the queue — teams do not need a full roster, only the configured minimum size.
    * Friendly fire between teammates is disabled by default (configurable).
    * If at least one teammate survives, the entire team wins. Squad wins and end-of-match announcements apply to every member of the winning team.

    **Win condition:** Be the last team with at least one surviving member.

    **Configurable options:**

    * Minimum and maximum players per team
    * Minimum number of teams required to start
    * Friendly fire (enable/disable)
    * Border size and shrink rate
    * PvP settings
    * Queue rules
  </Tab>

  <Tab title="Deathmatch">
    Deathmatch is a fast-paced, timed combat mode. Unlike the other modes, players respawn after death — kills are what matter, not survival.

    **How it works:**

    * Matches run for a configurable time limit.
    * Players respawn immediately after death.
    * Every kill is tracked both for the current match and the player's total statistics.
    * The world border can shrink during the match to keep fights close.
    * At the end of the match, the top 3 players by kill count are announced to all participants.

    **Win condition:** Have the most kills when time expires (or be the last player standing).

    **Configurable options:**

    * Match duration
    * Kill tracking (match and total stats)
    * Border shrink behavior
  </Tab>
</Tabs>

## Joining a Match

Players use `/br` to open the main game menu from anywhere on the server. From the menu, they can browse available modes, see current queue sizes, and join whichever match type they prefer. No additional commands are required to enter a queue.

<Note>
  All game mode settings — including player limits, timers, PvP rules, and respawn mechanics — are managed in `game-settings.yml` inside the `plugins/PrimaxBattleRoyaleX/` directory.
</Note>