overview
NPC trading system driven entirely from config, no per-trader scripting required
FX-Traders is a config-driven NPC trading system for QBCore that eliminates per-trader scripting. Add a trader, define what it accepts and what it gives back, and the system handles the rest.
Four trade types cover item-for-money, money-for-item, item-for-item, and item-plus-money-for-item exchanges. Each trade supports optional requirements, cooldowns, success chances, random reward pools and limited stock. The engine executes trades under lock with a reserve-then-commit model: goods are reserved before anything is taken, and any failure triggers a rollback with critical logging.
Trades are executed under lock with a reserve-then-commit architecture. Goods are reserved before anything is taken, and if any step fails the reservation is rolled back and a critical log is written. The regression suite includes 380 simulated tests against the real engine code with faked inventory, money and database to inject failures on purpose. Tests cover duplication, item loss, lock leaks and rollback.
Trader access can be gated by job or gang with memory: a player who quits the job to dodge a restriction does not gain access by rejoining. Refused attempts are logged to their own Discord channel, making the quit-sell-rejoin probe visible instead of silent.
A config validator ships with the resource. Edit your traders, run the validator, and it compiles your actual config and prints exactly what it produced. Typos in currency names or broken shorthand surface in the validator rather than in front of players.
24/7 technical support included.
