Game Modes

- Team Deathmatch — Red vs Blue, first team to reach the target score wins

- Elimination — Round-based, last team standing wins the round

- Free For All — Every player for themselves, top fragger wins

- Gun Game — Progress through 9 weapon tiers by getting kills, first to complete all tiers wins

Lobby System

- Create and join custom lobbies with full control over settings

- Password-protected private lobbies

- Configurable team size (1v1 up to 6v6)

- Adjustable target score (5–150) and time limit (1–30 min)

- Toggle Night Mode, Hardcore Mode, and Friendly Fire

- Auto-start when all players are ready

- Lobby owner can force-start the match

Quick Play / Matchmaking

- One-click queue system for instant matchmaking

- Automatically creates and fills lobbies from queued players

- Live queue counter visible in the UI

Combat & Hit Registration

- Server-side hit validation (anti-cheat)

- Weapon and distance verification on every hit

- Headshot detection (bone-based)

- Hit cooldown system to prevent spam

- Max hit distance enforcement (65m)

- Friendly fire protection in team modes

Weapons

- Paintball gun (one-hit kill)

- 7 standard weapons: Pistol, Combat Pistol, SMG, Assault Rifle, Carbine Rifle, Pump Shotgun, Sniper Rifle

- Gun Game progression: Knife → Pistol → Combat Pistol → SMG → Assault Rifle → Carbine Rifle → Sniper Rifle → Pump Shotgun → Knife

Medal & Streak System

- First Blood — First kill of the match

- Double Kill / Triple Kill / Multi Kill — Multiple kills within a short window

- Killing Spree (3 streak) / Rampage (5 streak) / Unstoppable (7 streak)

- Headshot medal

- Best streak tracking per match

- Unique sound effect for each medal

Wager System

- Optional betting on match outcomes

- Configurable min/max bet ($100–$50,000)

- Bet from cash or bank account

- Winnings split equally among winners

- Automatic refund if lobby is disbanded before match start

Spectating

- Free-camera mode with full WASD movement and mouse look

- Attached camera mode (follow a player)

- Cycle through alive players

- Crosshair-based player selection in free-cam

- Spectate active matches from outside (queue)

- On-screen control hints via scaleform UI

Persistent Statistics & Leaderboard

- Database-backed player stats (oxmysql)

- Tracked stats: games played, wins, kills, deaths, headshots, best streak, points, playtime

- Top 50 leaderboard sorted by points

- 15-second cache for optimal performance

Match Results & Awards

- MVP calculation (kills × 2 + points − deaths)

- Awards: Most Kills, Best K/D, Longest Streak

- Full post-match scoreboard for all players

Arenas

- Multiple arenas included with custom props

- Per-arena configurable spawn points, center position, radius

- Easy to add custom arenas via config

- Dynamic spawn rotation to prevent spawn camping

- Spawn protection on respawn

Team Uniforms

- Distinct outfits per team (Red, Blue, FFA)

- Male and female variants

- Fully customizable via config

User Interface

- Modern React 18 + TypeScript + Tailwind CSS NUI

- Radix UI components (shadcn/ui)

- Smooth animations with Motion

- Real-time HUD: score, kills, deaths, time remaining, weapon tier

- In-game killfeed and notification ticker

- Lobby browser with full match configuration

- Responsive and themeable

Framework Support

- ESX / QBCore / vRP / Standalone

- Auto-detection — no manual setup needed

- Abstraction layer for money, notifications, and identifiers

Interaction Systems

- Auto-detects installed target system:

- ox_target, qb-target, Var-Interact, or fallback marker + E

- Configurable map blip

Discord Integration

- Match result webhook with rich embed

- Displays mode, arena, duration, score, MVP, and top 6 players

- Custom bot name and avatar

Admin Tools

- ACE-based permission system (paintball.admin)

- /pb_forcestart — Force start a lobby

- /pb_forcestop — Force end a match

- /pb_kick — Remove a player

- /pb_status — View all active matches and lobbies

Player Features

- Custom nickname system (max 16 characters)

- Steam avatar fetching and caching

- Ready toggle in lobby

Technical

- Lua 5.4

- Routing bucket isolation per match (no cross-match visibility)

- Server-side state management with real-time sync

- Spawn zone boundaries with ground snapping and water detection

- Leaderboard caching for performance

- Fully translatable (EN/FR included)

Included

- 2 custom arenas with props

- Full SQL schema

- Ready to use out of the box