Prop Hunt — Hide, Seek, Transform & Taunt

NoxenScripts · September 4, 2025, 12:16pm

PROPHUNT-1

Hide, seek, and outsmart your friends in Noxen Prop Hunt for FiveM. Queue up via an NPC, transform into props, taunt your pursuers, and survive the hunt. Clean HUD, map boundary visuals, server-side validation, and a session leaderboard. Hooks included for rewards/logging; works standalone, ESX, or QBCore.

Vidéo preview

Features

NPC queue: one-click join via a configured NPC
Clean HUD: time, roles, team counts, leaderboard
Hiders: prop-transform + automatic taunts (cooldown-based)
Hunters: blindfold start, hits, eliminations
Safe play area: boundary visuals + out-of-bounds protection
Server-side checks: damage and team switching validation
Localization-ready UI: customize via config/Localization.lua
Hooks: server/hooks.lua to add rewards/logs/webhooks
Optional: ElectronAC temp whitelist integration
Exports: client/server helpers to detect game status

Requirements

FiveM server (latest recommended)
No additional dependencies

Installation

Place the folder in your resources/ directory.
Add to server.cfg:
ensure noxen_prophunt
Start/restart your server.

config/MapConfig.lua: play area center/radius, warning radius, visuals
config/ServerConfig.lua: min players, durations, hunter ratio, countdown points, leaderboard size, taunt cooldown, dev mode
config/ClientConfig.lua: hider/hunter settings, NPC model/position, start heading, weapon, hit cooldown
config/Localization.lua: update UI/notifications for your language

-- config/MapConfig.lua
MapConfig = {
  Center = vector3(617.9927, -2744.9453, 6.0649),
  Radius = 100.0,
  WarnRadius = 90.0,
  ReturnDelay = 5,
  Visuals = {
    BoundaryColor = {r=255,g=0,b=0,a=100},
    WarningColor  = {r=255,g=165,b=0,a=100},
    MarkerHeight  = 50.0,
    MarkerSpacing = 10.0
  }
}

-- config/ServerConfig.lua
ServerConfig = {
  Game = {
    MIN_PLAYERS = 2,
    GAME_DURATION = 5*60000,
    WAIT_DURATION = 60000,
    HUNTER_RATIO = 0.5
  },
  Countdown = { POINTS = {45000, 30000, 15000, 5000} },
  Leaderboard = { MAX_DISPLAYED = 5 },
  Taunts = { COOLDOWN_MS = 2000 },
  Dev = { ENABLED = false }
}

How to Play (In-Game)

Walk to the NPC and press E
Click Join to queue
When enough players join, the match starts
Hiders hide/transform and taunt; Hunters start blindfolded, then hunt
Winners are announced and the leaderboard updates

Exports (usage)

-- Client

if exports['noxen_prophunt']:isPlaying() then

-- do something

end

-- Server

if exports['noxen_prophunt']:isPlayerInGame(source) then

-- do something

end