gta6/prompts
crafting
Vaultadvancedcrafting

Firearm Reliability — Jamming & Cleaning

QBCore firearm-wear system: shots accumulate server-side wear that raises jam probability, and a field-strip cleaning action consuming a kit restores reliability.

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

Description

A QBCore firearm-reliability system for hardcore servers: every shot adds wear, wear raises a server-rolled jam chance, and a jam yanks the weapon until the player field-strips and cleans it with a kit. Survival-focused servers buy it because it converts guns into maintained, consumable infrastructure and creates demand for cleaning kits.

Prompt Template

You are writing a FiveM resource for QBCore, core via exports['qb-core']:GetCoreObject().

🔒 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/crafting/21-firearm-reliability-jamming.lua implements a debounced client shot-detection thread, a jam handler that disarms the ped, and a server wear…

🔒 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-side wear/roll — if wear or the jam roll lives on the client a cheat is immune; keep both server-side.
  • No re-arm path — disarming on jam without a clean handler that clears the flag strands the player unarmed.
  • No shot debounce — an undebounced IsPedShooting loop counts one pull as many shots; gate on the jammed flag and per-frame state.

Corrective re-prompt: "Move the wear table and the jam roll entirely into the server section keyed by src:weapon; the client only reports a fired shot and renders the jam. Gate the shooting loop on the not-jammed flag so one trigger pull isn't counted many times, and require a consumed cleaning_kit before zeroing wear."

Framework Integration

ESX: swap to exports['es_extended']:getSharedObject() and use xPlayer.getInventoryItem('cleaning_kit') / removeInventoryItem. QBCore: native here — Player.Functions.GetItemByName and RemoveItem gate the clean. QBox: keep the same wear logic but resolve the cleaning kit through ox_inventory exports.ox_inventory:Search / RemoveItem.

Profit Potential

$450–$6000/mo on Tebex (expected ~$1600). [INFERRED] priced inside the $50-389 standalone-script band against the signal-scraper corpus (tebex_snapshot n=100, median seller $11.85K/mo) for a hot firearm-maintenance niche.

Trend Signal

🔥 hot — inferred: [INFERRED] firearm wear/jamming + maintenance is a hot hardcore-survival mechanic in the pre-launch server wave; qb-native weapon hook.

Sales Angle

Lead with the survival fantasy: guns degrade, jam at the worst moment, and demand upkeep — driving a cleaning-kit economy. Recommended Tebex price: $129.

Difficulty & Ship Time

advanced · ships in 1 day.