🔄 Replacing Banking or Billing

Finance reuses TGG Banking and Billing tables, preserving accounts, balances, members, cards, loans, savings, credit scores, history, and invoices. No table rename or balance-copy step is needed.

Replace the TGG resources

1. Back up the database and old resource folders. Rehearse on a server/database copy.
2. Stop tgg-banking and tgg-billing. Remove their startup entries, including category-wide entries that would start them.
3. Keep the old folders available but stopped for Finance's first start; it reads their configuration.
4. Install Finance with Config.AutoImportSQL = true. Copy framework, inventory, and interaction choices into its bootstrap config, and webhooks into server/secrets.lua. Port custom code and hooks manually.
5. Start Finance after dependencies and before export consumers. Confirm initialization succeeds and the old resources remain stopped.
6. Review /fsettings, compare existing data with the backup, and test transactions, invoices, and integrations. Archive the old folders outside resources once verified.

What imports automatically

First startup imports supported companies, taxes, commissions, limits, rates, card names, locations, appearance, keybinds, and schedules. Banking wins shared appearance/currency conflicts; Billing supplies company and invoice settings. Invalid legacy settings stop startup.

Existing tgg_finance_settings takes precedence. Import runs once; later changes belong in /fsettings. Do not delete the settings record to force re-import.

Legacy frozen accounts without a recorded authority become staff-only holds.

Billing with an external society ledger

Finance does not automatically move balances from Renewed, QB Banking, ESX society accounts, or another ledger. It refuses legacy import when Billing selects a non-TGG provider, or selects auto without a TGG Banking source folder.

Choose an adapter that retains the old ledger, or a verified one-time balance migration. Back up first, stop old-ledger writers during migration, reconcile every society, and point integrations at the chosen ledger. Deleting legacy folders or changing detection does not transfer money.

The Renewed import command generates new IBANs. It is a separate maintenance tool, not an automatic Billing migration; repeating it can duplicate copied balances.

Rollback

Before reopening the server, rollback can restore the matching resource and database backups. Once players have transacted, restoring the old database discards that activity: take a new backup and reconcile it first. Never run Finance and the old resources together.