~/docs/paintball/configuration/game-modes
paintball docs›
Paintball
Game Modes
-- 4 min read
Var-PaintBall features 4 different game modes, each with its own rules and win conditions.
TEAM : Team Deathmatch
The classic mode. Two teams (Red and Blue) compete to reach the target score.
| Property | Value |
|---|---|
| Teams | Red vs Blue |
| Respawn | Yes (unlimited) |
| Win condition | First to reach target score OR highest score when time runs out |
| Friendly fire | Disabled by default (configurable) |
How it works :
- Players are automatically distributed into teams in a balanced way
- Each kill earns 1 point for the team
- The match ends when a team reaches the target score or time runs out
- The team with the most points wins
ELIM : Elimination
Team-based survival mode. No infinite respawns, once eliminated, you become a spectator.
| Property | Value |
|---|---|
| Teams | Red vs Blue |
| Respawn | No (eliminated = spectator) |
| Win condition | Last team standing |
| Friendly fire | Disabled by default (configurable) |
How it works :
- Players are distributed into teams
- When a player is eliminated, they enter spectator mode and follow a teammate
- The match ends when all players on one team are eliminated
- The last team with surviving players wins
FFA : Free-for-All
Every man for himself. No teams, all players are opponents.
| Property | Value |
|---|---|
| Teams | None (every man for himself) |
| Respawn | Yes (unlimited) |
| Win condition | First to reach target score OR highest score when time runs out |
| Friendly fire | Always enabled (all enemies) |
How it works :
- Each player competes individually
- Each kill earns 1 point for the player
- The first player to reach the target score wins
- If time runs out, the player with the most points wins
GUNGAME : Gun Game
Progressive weapon mode. Each kill advances you to the next weapon tier. The first player to complete all tiers wins.
| Property | Value |
|---|---|
| Teams | None (every man for himself) |
| Respawn | Yes (unlimited) |
| Win condition | First to complete all 9 weapon tiers |
| Friendly fire | Always enabled (all enemies) |
Weapon progression :
| Tier | Weapon |
|---|---|
| 1 | Knife |
| 2 | Pistol |
| 3 | Combat Pistol |
| 4 | SMG |
| 5 | Assault Rifle |
| 6 | Carbine Rifle |
| 7 | Sniper Rifle |
| 8 | Pump Shotgun |
| 9 | Final Knife |
How it works:
- All players start at tier 1 (knife)
- Each kill advances the player to the next tier with a new weapon
- The player receives a notification indicating their new tier
- The first player to get a kill with the final knife (tier 9) wins the match
Common Match End Conditions
Regardless of the mode, a match can end for any of the following reasons:
| Condition | Description |
|---|---|
| Target score reached | A team or player reaches the defined score target |
| Time expired | The timeLimit is reached (highest score wins) |
| Full elimination | All players on a team are eliminated (ELIM) |
| Gun Game completed | A player completes all tiers (GUNGAME) |
| Insufficient players | Fewer than 2 players remaining in the match |
| Admin stopped | An administrator force-stops the match |
Lobby Options
When creating a lobby, the following options are available:
| Option | Description | Applicable modes |
|---|---|---|
arena |
Game arena | All |
mode |
Game mode | — |
weapon |
Weapon used | TEAM, ELIM, FFA |
teamSize |
Max players per team | TEAM, ELIM |
target |
Target score | TEAM, FFA |
timeLimit |
Max duration (seconds) | All |
nightMode |
Night mode (darkness) | All |
hardcore |
Hardcore mode | All |
friendly |
Friendly fire enabled | TEAM, ELIM |
autoStart |
Auto-start when everyone is ready | All |
password |
Password to join | All |
wager |
Wager amount | All |