Skip to main content

Migration

Switch to wasabi_banking from Wasabi Banking v1 or another banking resource without wiping player money.

danger

The resource folder must be named wasabi_banking.

warning

Stop the old banking resource before enabling an import flag. Framework imports rename source tables to <name>_wasabi_archive. If the old script is still started, those renames will break it.

Flags​

Both flags live in config/server/config.lua.

FlagPurpose
Config.LegacyImportOne-time import from Wasabi Banking v1 (wasabibanking_* tables)
Config.ImportFromFrameworkBankingOne-time import from qb-banking, Renewed-Banking, or okokBanking

Both importers are idempotent after the first successful run. Leaving a flag true after import is usually harmless.

Migrate from Wasabi Banking v1​

  1. Stop the old wasabi_banking v1 resource.
  2. Install the new resource as wasabi_banking (replace the old folder).
  3. Set:
Config.LegacyImport = true
  1. Start wasabi_banking.
  2. Confirm accounts, cards, savings, loans, and transactions appear in the UI.
  3. Optionally set Config.LegacyImport = false after verification.

Rows are copied into the new wasabi_bank_* schema and skipped when they already exist (deduped by IBAN / card number).

Migrate from qb-banking, Renewed-Banking, or okokBanking​

Sources are auto-detected by column shape:

SourceDetected tablesImported into
qb-bankingbank_accounts (shared / gang / org / group rows)wasabi_bank_shared_accounts
Renewed-Bankingbank_accounts (all rows + members)wasabi_bank_shared_accounts + wasabi_bank_shared_users
okokBankingokokbanking_accounts, okokbanking_savings, okokbanking_logswasabi_bank_accounts, wasabi_bank_savings, wasabi_bank_transactions

Switch-over steps​

  1. Stop qb-banking / Renewed-Banking / okokBanking.
  2. Set:
Config.ImportFromFrameworkBanking = true
  1. Start wasabi_banking.
  2. Verify shared accounts, savings, IBANs, and statements in the UI.
  3. Optionally set Config.ImportFromFrameworkBanking = false.

Each imported source table is renamed to <name>_wasabi_archive (with a timestamp suffix on re-runs) so it cannot collide with the Wasabi schema again. Partial okok installs only import the tables that exist.

Compatibility exports​

After migration, keep dependent scripts working with Config.CompatExports in config/server/config.lua:

Config.CompatExports = {
    ['qb-management']   = true,
    ['Renewed-Banking'] = true,
    ['okokBanking']     = true,
}

When enabled, wasabi_banking answers export calls aimed at those resources.

Compat surfaceNotes
qb-managementGetAccount / AddMoney / RemoveMoney (+ gang variants). The real qb-management must be removed (provides in fxmanifest).
Renewed-BankingSociety/player money + transaction helpers for qbx_management boss menus. Auto-skipped if the real Renewed-Banking is started.
okokBankingAccount money and transaction helpers. The real okokBanking must be removed (provides in fxmanifest).

On ESX, society money can stay in esx_addonaccount via Config.SocietyBackend = 'auto', so esx_society needs no shim.

Fresh install?​

If you are not importing existing data, leave both import flags false and follow Installation.