gta6/prompts
gangs
Vaultintermediategangs

Gang Reputation & XP Levels

ESX gang reputation system where activities award server-validated XP that levels the gang and unlocks tiered perks, with a level-up anim and NUI sync.

NON-TESTÉ — the reference Lua is syntax-validated, not run in a live FiveM server. Adapt and test on your own dev server before shipping.
Est. Lua
~76 loc
Claude
Claude Opus 4.x / Sonnet 4.x
Validation
syntax-validated
Updated
2026-06-25

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).

🔒 Eyes-only — locked prompt body

The full prompt template and its reference Lua are part of a one-time pack. Pick your depth — both are lifetime access, no subscription, ever.

Core$49one-time
  • 60 prompts + syntax-validated reference Lua
  • Lifetime access — pay once
Most Popular · Best Value
Vault$199one-time
  • All 510 prompts — the full library
  • Per-prompt profit/trend intelligence (CSV + playbook)
  • Lifetime free updates — new niches as the market moves
Get the Vault — $199

$49 for 60 · $199 for all 510 + intelligence — one-time, no subscription.

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,…

🔒 Eyes-only — locked prompt body

The full prompt template and its reference Lua are part of a one-time pack. Pick your depth — both are lifetime access, no subscription, ever.

Core$49one-time
  • 60 prompts + syntax-validated reference Lua
  • Lifetime access — pay once
Most Popular · Best Value
Vault$199one-time
  • All 510 prompts — the full library
  • Per-prompt profit/trend intelligence (CSV + playbook)
  • Lifetime free updates — new niches as the market moves
Get the Vault — $199

$49 for 60 · $199 for all 510 + intelligence — one-time, no subscription.

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). [INFERRED] $50-389 script band × est units/mo for a rising niche, against the signal-scraper tebex_snapshot corpus (n=100, median seller $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.