Gang Reputation & XP Levels

Description

A working ESX gang reputation loop: gang activities (patrol, robbery, turf win) award server-validated XP, the gang levels up, and each level unlocks a perk while every online member sees a level-up anim and NUI sync. Progression is the retention hook a paid-RP server leans on, which is why this sits above the commodity gang base.

Prompt Template

You are writing a FiveM resource for esextended (stable, exports getSharedObject).

Expected Output

The reference Lua lives at content/expected-outputs/gangs/04-gang-reputation-xp.lua. It implements a server-side GangXP table, a reward map, level thresholds with a carry-over level-up loop,…

Known Failure Modes & Corrective Prompt

• Client-trusted XP, the client sends totals or computes the level; rep can be maxed instantly. Keep all XP math and thresholds server-side.
• Anim before load, the celebrate TaskPlayAnim no-ops without RequestAnimDict + a HasAnimDictLoaded wait loop.
• Self-only broadcast, only the trigger client sees the level-up; fan it out to every online member via GetPlayers().

Corrective re-prompt: "Move the XP accumulation, the xpForLevel thresholds and the perk table entirely into server.lua, accepting only an activity name from the client. On level-up, iterate GetPlayers() and TriggerClientEvent('gangrep:leveledUp', ...) for every player whose job.name matches the gang, and guard the celebrate anim with a RequestAnimDict wait loop."

Framework Integration

• ESX: native, resolve the gang via xPlayer.job.name; iterate GetPlayers() + ESX.GetPlayerFromId to fan out level-ups.
• QBCore: read the gang from PlayerData.gang.name and notify with QBCore.Functions.Notify; use QBCore.Functions.GetPlayers() for the fan-out.
• QBox: identical to QBCore via exports.qbx_core; persist GangXP to your DB layer for cross-restart progression.

Profit Potential

$250-$3500/mo on Tebex (expected ~$900), $50-389 script band × est units/mo for a rising niche, against a corpus of comparable Tebex sellers (median ~$11.85K/mo).

Trend Signal

↗ rising, strategy: Matrix names 'gang rep' as a core gangs driver; progression + perk unlocks fuel paid-RP retention.

Sales Angle

This is a retention engine, not a utility, the perk-unlock ladder is what keeps a gang grinding. Price it as a flagship gang module at $99-149 and lean the listing on the progression loop and perk tiers.

Difficulty & Ship Time

intermediate · ships in 4-6h.