AWS Black Market
Configurable NPC markets, pawn transactions and an item-based money-laundering flow.
Installation
Requirements
- qb-target
- One supported framework bridge: QBCore, ESX or Qbox; Qbox integrations must match your compatibility setup
- The inventory containing the configured goods and dirty-money item
Startup order
This example selects one framework and target. Use the resources matching your configuration and start dependencies first.
ensure qb-core
ensure qb-target
ensure aws-black
Setup steps
- Configure every Config.Markets entry with valid inventory items, prices, currencies, NPC coordinates and job rules.
- Config.BlackMoneyItem defaults to markedbills. Match this to your inventory and its metadata conventions.
- This build does not include a custom SQL installer or persistent-stock schema. Do not import SQL from another Black Market version.
Gameplay and usage
- Interact with a configured market NPC using qb-target and test one buy/sell transaction.
- Test laundering with a small markedbills amount and verify removal, configured commission and money output.
Configuration
- config.lua: Config.Locale, MenuTitle and MenuSubtitle configure the visible UI.
- Config.InventoryImagePath points at your inventory item images.
- Config.Markets defines pawn/market behavior and access.
- Config.Laundering configures the NPC, input item, output account and tax.
Exports and integrations
No public callable export is declared with exports() in these source files. Use the documented commands or configuration; internal network events are not a trusted integration API.
Troubleshooting
-
Missing item pictures: correct Config.InventoryImagePath and inventory image filenames.
-
Incorrect money balance: review shared/bridge.lua and the configured account/item.
-
If no target appears, verify qb-target, NPC coordinates and model validity.
-
Include the package version, framework and exact server/F8 error when requesting support. Remove private tokens and player data.
Package reference
| Manifest | Version |
|---|---|
fxmanifest.lua |
1.0.0 |
Database files
No standalone SQL file is included. Check the installation steps above for tables created by server code.
Configuration reference
aws-black/config.lua:Locale,Debug,MenuTitle,MenuSubtitle,InventoryImagePath,BlackMoneyItem,BlackMoneyLabel,Markets,Laundering
Frequently asked questions
Does this need Keymaster or an escrow key?
The Lua sources in this delivery package were readable in the static audit. No /assetpacks requirement is added by this package. Required framework, inventory and map resources still need to be installed separately.
Can I change the folder or database table names?
Keep the supplied folder names. Historical event, SQL and KVP identifiers are retained to protect existing integrations and saved data. Renaming a table or event requires a separate migration.
Why is an interface or item missing?
Check the startup order, selected framework/target adapter, inventory item definitions and the server/F8 console. The package does not install an entire framework or inventory for you.
Has this been tested on my server?
ZIP integrity, source readability, script syntax and manifest references were checked locally. Multiplayer gameplay, your framework version and integrations require a FiveM server acceptance test before a public release.