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

# PrimaxBattleRoyaleX: Battle Royale Plugin for Paper 1.21+

> Learn what PrimaxBattleRoyaleX offers, its three game modes, key features, and what server requirements you need to get started.

<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>

**PrimaxBattleRoyaleX** is a feature-rich Battle Royale plugin for Minecraft Paper 1.21+ servers, developed by PrimaxStudios. Designed for server administrators who want to offer a competitive, high-quality Battle Royale experience, it eliminates the complexity of building such a system from scratch. With three distinct game modes, deep customization options, seamless BetterTeams integration, and PlaceholderAPI support, PrimaxBattleRoyaleX gives you everything you need to run professional-grade Battle Royale matches — all out of the box.

## Key Features

<CardGroup cols={2}>
  <Card title="Solo Battle Royale" icon="person">
    Classic last-player-standing gameplay featuring a shrinking world border and elytra-based landing drops. Every player for themselves.
  </Card>

  <Card title="Squad Battle Royale" icon="people-group">
    Team-based Battle Royale powered by BetterTeams integration. Supports auto-team creation so players can jump in without pre-forming a squad.
  </Card>

  <Card title="Deathmatch" icon="skull">
    A respawn-enabled free-for-all mode with live kill tracking and an end-of-match top-3 leaderboard to crown the best fighters.
  </Card>

  <Card title="PlaceholderAPI Support" icon="puzzle-piece">
    Over 20 stat placeholders compatible with any scoreboard, tab list, or chat plugin that supports PlaceholderAPI. Full stats at your fingertips.
  </Card>

  <Card title="Unlimited Simultaneous Matches" icon="infinity">
    Run as many concurrent matches as your hardware allows. Multiple game modes and lobbies can operate at the same time without conflict.
  </Card>

  <Card title="Full Customization" icon="sliders">
    Tune every aspect of the experience — messages, countdown timers, border sizes and shrink speed, PvP rules, player limits, and much more via dedicated config files.
  </Card>
</CardGroup>

## Requirements

Before installing PrimaxBattleRoyaleX, ensure your server environment meets the following requirements:

| Dependency             | Status      | Notes                                                          |
| ---------------------- | ----------- | -------------------------------------------------------------- |
| **Paper 1.21+**        | Required    | Spigot and CraftBukkit are not supported.                      |
| **BetterTeams**        | Required    | Used for all team management in Squad mode.                    |
| **PlaceholderAPI**     | Optional    | Enables 20+ stat placeholders for external plugins.            |
| **TerraformGenerator** | Recommended | Provides enhanced terrain generation for Battle Royale worlds. |

## About v2.0.0

PrimaxBattleRoyaleX v2.0.0 is a **complete rewrite** of the plugin from the ground up. This version delivers significantly improved performance, greater stability, and a smoother match experience — making it suitable for high-player-count servers and production environments. If you are upgrading from a previous version, review the configuration files carefully as the structure has changed.