🔧 Troubleshooting and known limitations
Finance will not start
Check the current startup log, dependency order, database connection, and schema initialization. Keep the resource named tgg-finance. For escrow, check Cfx entitlement and retain the matching .fxap and protected files.
An external Billing provider refusal requires a migration plan, not deleting its old configuration.
Settings do not match the files
Saved Finance settings override defaults and legacy files. Edit them through /fsettings; do not delete the settings row. Updates retain saved colors; see appearance defaults.
Commands or keybinds do not work
/finance and /fsettings require admin permissions. Check player FiveM bindings for F7/F9 overrides or conflicts.
If F9 takes focus without opening UI, confirm the manifest and built UI both come from 1.0.1, which fixes the quick-create overlay. Capture F8 and server errors if it persists.
Billing briefly shows empty or sample content
1.0.1 fixes the billing loading state. Install its complete UI. If the loaded list is empty, check personal/society scope and status, date, and search filters.
Cards fail at an ATM
Check item names, metadata, PIN, card status, issuer authority, account restrictions, and cash limits. Terminated cards need replacement. Use ATM calibration for misaligned custom screens.
Settlement or reconciliation warnings
Preserve the operation ID, timestamp, affected account/invoice/loan IDs, logs, and independent payment evidence. A balance alone does not establish what happened.
An exception or lost response may leave money already moved. Inspect each original payment leg before retrying or correcting it. Use Cashback reconciliation in /fsettings for its supported operations. Do not delete records, clear reservations, or replay payments to dismiss a warning.
Known limitations in 1.0.1
- Qbox offline wallets: character loading/unloading or framework saves can overwrite offline credits/debits, losing or creating money. This remains unresolved in 1.0.1; review affected operations with your developer before production use.
- External wallet writers: direct framework-wallet SQL from other resources is outside Finance's locks and can overwrite changes.
- Freezes: Finance account holds do not block every framework, invoice, or external-resource debit.
- ATM proximity: world-prop ATMs lack a universal server-side coordinate check. Interaction distance is not comprehensive server-side enforcement.
Reporting a problem
Include Finance version/edition, framework/inventory versions, reproduction steps, sanitized F8/server errors, migration history, and relevant integrations. Remove credentials, webhooks, and unrelated player data. Diagnose destructive changes on a database copy.