gta6/prompts
economy
Vaultadvancedeconomy

Tax Return — Filing, Deductions & Audits

QBCore tax-filing system where players declare deductions against server-tracked income and a randomized audit recomputes liability and levies penalties.

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
~86 loc
Claude
Claude Opus 4.x / Sonnet 4.x
Validation
syntax-validated
Updated
2026-06-25

Description

A tax-filing mechanic for roleplay servers: an export tracks each player's taxable income, players file returns declaring deductions, and a randomized audit can recompute liability and levy a penalty surcharge. Servers sell it because the file-deduct-audit loop gives government-faction roleplay real stakes beyond a flat payday tax.

Prompt Template

You are writing a FiveM resource for qb-core (port notes below).

🔒 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 at content/expected-outputs/economy/16-tax-return-audit-system.lua tracks income through an AddIncome export, assesses tax on a server-capped deduction, and runs a randomized audit…

🔒 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-declared income — trusting client gross/owed lets a player file a fake return. Track income server-side via the export.
  • Deduction over income — uncapped deductions mint a refund. Cap the lawful claim at gross*MAX_DEDUCT.
  • Client-side audit — rolling the audit on the client always passes. Run the roll and penalty on the server.

Corrective re-prompt: "Make tax:file accept only a declared-deduction integer; read gross from the server ledger, cap the lawful deduction at gross*MAX_DEDUCT, compute owed server-side, and run the AUDIT_CHANCE roll plus penalty entirely in the server handler before notifying the client."

Framework Integration

ESX: getSharedObject(), getAccount('bank'), removeAccountMoney; expose AddIncome the same way and key the ledger by identifier. QBCore: as written — GetPlayer, Functions.RemoveMoney('bank', ...), ledger keyed by citizenid, income via the AddIncome export. QBox: exports.qbx_core:GetPlayer(src) with the shared money functions; the AddIncome export and citizenid keying are unchanged.

Profit Potential

$250–$3500/mo on Tebex (expected ~$900). [INFERRED] Priced inside the $50-389 script band against the signal-scraper corpus (tebex_snapshot n=100, median seller $11.85K/mo); a rising tax-RP niche uncommon on Tebex.

Trend Signal

rising — inferred: Extends the common flat payday-tax into a filing+audit RP layer uncommon on Tebex; demand-reasoned for tax-RP and gov-faction servers.

Sales Angle

Pitch the audit as roleplay content — the penalty notification spawns government-faction scenes flat payday tax never could. Recommended Tebex price: $179.

Difficulty & Ship Time

advanced · ships in 1 day.