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

# Setting Up BetterTeams for PrimaxBattleRoyaleX Squad Mode

> BetterTeams is required for Squad Battle Royale in PrimaxBattleRoyaleX. Learn how to install it, create teams, and queue for squad matches.

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

BetterTeams is a **required dependency** for Squad Battle Royale. It provides the team management layer that PrimaxBattleRoyaleX builds on — giving players a familiar team experience while the plugin handles the competitive layer on top.

<Warning>
  **BetterTeams is required.** Without it, PrimaxBattleRoyaleX will fail to load Squad mode entirely. Install BetterTeams in your `/plugins` folder and restart your server **before** enabling Squad mode.
</Warning>

***

## Installation

<Steps>
  <Step title="Download BetterTeams">
    Download the latest BetterTeams JAR from [SpigotMC](https://www.spigotmc.org). Make sure you download a build compatible with your server version (Paper 1.21+).
  </Step>

  <Step title="Add to your plugins folder">
    Place the downloaded `.jar` file into your server's `/plugins` directory.
  </Step>

  <Step title="Restart your server">
    Perform a full server restart (not `/reload`) to allow BetterTeams to initialise correctly alongside PrimaxBattleRoyaleX.
  </Step>

  <Step title="Verify the installation">
    Run `/plugins` in-game or in the console. **BetterTeams** should appear highlighted in green. If it appears in red, check your console for errors before proceeding.
  </Step>
</Steps>

***

## How Squad Mode Uses BetterTeams

PrimaxBattleRoyaleX integrates with BetterTeams at multiple points during the Squad match lifecycle:

**Before the match**

* Players create or join teams using standard BetterTeams commands (e.g., `/team create`, `/team invite`) before they queue.
* When ready, the **team leader** queues the entire team for Squad mode using `/br`.
* PrimaxBattleRoyaleX validates that the team meets the minimum size requirement configured in `game-settings.yml`.

**Solo players queuing for Squad**

* If a player queues solo for Squad mode, the plugin can automatically create a temporary team for them so they can still participate.
* Auto-created teams are managed entirely by PrimaxBattleRoyaleX and are invisible to the player from a BetterTeams perspective.

**After the match**

* Auto-created temporary teams are **automatically dissolved** once the match ends — no manual cleanup needed.
* Existing player-created BetterTeams teams are **never modified or deleted**. Their team data, membership, and settings remain completely intact.

***

## Friendly Fire

Squad mode includes built-in friendly fire protection. To prevent teammates from damaging each other, set the following option in your `game-settings.yml`:

```yaml game-settings.yml theme={null}
friendly-fire: false
```

When `friendly-fire` is set to `false`, no damage is dealt between members of the same BetterTeams team during a Squad match.

***

<Tip>
  Encourage your players to create **permanent BetterTeams teams** before queuing for Squad mode. Auto-created teams are temporary and dissolve after the match, so players who regularly squad together will have a better experience — and consistent team stats — with a persistent team.
</Tip>

***

## Related Pages

* [Squad Mode](/primaxbattleroyalex/primaxbattleroyalex/game-modes/squad) — full guide to Squad Battle Royale gameplay and settings
* [Game Settings Configuration](/primaxbattleroyalex/primaxbattleroyalex/configuration/game-settings) — configure minimum team sizes, friendly fire, and other match parameters