PROP HUNT

QBCore QBOX ESX

This item is free.

Add to basket

Payments handled by

Description

Full Prop Hunt minigame for FiveM, hide as a world prop or hunt disguised players.
Modern React NUI for lobby flow, live match HUD, controls hints, and end-of-round results.
Lobby-based matchmaking with public browse, host controls, and configurable player limits.
Built with a bridge-based architecture for QBCore, ESX, and standalone servers.
Persistent stats & XP stored in MySQL with automatic schema setup on first start.

Configurable Lobby NPC spawn point with ped model, scenario, and map blip.
Interaction via ox_target when available, with ox_lib point fallback (E key).
Players return to the lobby NPC automatically after rounds.

Tabbed main menu with three sections:
- Play — create a new lobby and pick a map
- Lobbies — browse and join open waiting games
- Statistics — level, XP bar, and career stats
Visual map cards for quick map selection when hosting.
Live lobby list with host name, map, and player count plus manual refresh.
Toast notifications for lobby errors (full, in progress, already in lobby, etc.).

Structured match lifecycle with synced server timers:
- Waiting — lobby open for joins
- Preparation — teams assigned, players teleported to map spawns
- Hiding — props disguise and reposition before hunters are released
- Active — hunters unfrozen, armed, and round timer running
- Ended — results screen, cleanup, return to lobby state
Configurable phase durations: prep time, hiding time, hunter countdown, and round length.
Per-map round time override with global default fallback.
Automatic round end on time limit (props win) or when all props are eliminated (hunters win).
Match abort handling when too few players remain mid-round.

Props become invisible world objects — ped hidden, silent, and non-colliding.
Random starting disguise from the active map's prop pool.
Dedicated orbit camera around the prop with mouse-look rotation.
Movement controls remap WASD / stick input to slide the prop on the ground.
Mouse wheel rotation to align disguise with the environment.
Right mouse — swap to another random prop from the map pool (cooldown configurable).
Left mouse — spawn a frozen decoy copy at the same position (max count + cooldown configurable).
Ground-aware placement to keep props sitting naturally on terrain.
On-screen controls hint panel for prop players during the round.

Hunters spawn at random hunter points and remain frozen until the release countdown completes.
Full-screen hunter countdown (3…2…1… GO) before weapons are issued.
Configurable hunter loadout (default: pistol + ammo).
Camera raycast hit detection on props, decoys, and player peds.
Shooting a real prop eliminates that player; shooting a decoy removes only the decoy.
Wrong-shot penalty — configurable self-damage when shooting non-prop targets.
On-screen controls hint for hunters during active phase.

Prop position, model, rotation, and decoys synced through player state bags.
Remote clients spawn and update other players' prop entities and decoys in real time.
Remote ped visibility hidden for disguised prop players.
Server-validated hunter hits and decoy destruction.
Elimination broadcasts and spectator state for knocked-out players.

Compact HUD stack (top-right) visible only during active rounds.
Live display of:
- Current map name
- Round phase label
- Countdown timer with progress bar (urgent styling under 30s)
- Props alive / hunters alive team bars
Context hints during preparation and hiding phases.
Controls reference panel stacked below the HUD for the active team.