Skip to main content
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.
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.
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.

​
Installation

1

Download BetterTeams

Download the latest BetterTeams JAR from SpigotMC. Make sure you download a build compatible with your server version (Paper 1.21+).
2

Add to your plugins folder

Place the downloaded .jar file into your server’s /plugins directory.
3

Restart your server

Perform a full server restart (not /reload) to allow BetterTeams to initialise correctly alongside PrimaxBattleRoyaleX.
4

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.

​
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:
game-settings.yml
When friendly-fire is set to false, no damage is dealt between members of the same BetterTeams team during a Squad match.
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.