Remplacer votre script bancaire

HZ-Banking prend la place de votre banque actuelle. Les scripts écrits pour qb-banking, Renewed-Banking, esx_banking ou okokBanking continuent de marcher : HZ-Banking répond sous leur nom, et l'argent arrive dans HZ-Banking. Vos comptes vous suivent grâce à une commande console.


Ce qu'il remplace

BanqueHabituelle surExports repris
qb-bankingQBCoreAddMoney, AddGangMoney, RemoveMoney, RemoveGangMoney, GetAccount, GetGangAccount, GetAccountBalance, CreateJobAccount, CreateGangAccount, CreatePlayerAccount, CreateBankStatement
Renewed-BankingQboxhandleTransaction, getAccountMoney, addAccountMoney, removeAccountMoney, getAccountTransactions, GetJobAccount, CreateJobAccount, addAccountMember, removeAccountMember, changeAccountName
esx_bankingESXlogTransaction
okokBankingtousAddMoney, RemoveMoney, GetAccount
Les scripts qui déclarent l'une de ces banques comme dépendance démarrent toujours.

Quelques points suivent la façon de faire de HZ-Banking :

  • Un débit ne fait jamais passer un compte sous zéro : quand le solde est trop bas, il renvoie false.
  • Les montants sont des nombres entiers supérieurs à zéro.
  • Les membres et le renommage ne concernent que les comptes partagés, jamais un compte de métier ou de gang.

Changer de banque, étape par étape

  1. Sauvegardez votre base de données.
  2. Arrêtez l'ancienne banque : retirez sa ligne ensure du server.cfg. Si son dossier se trouve dans une catégorie démarrée d'une seule ligne ensure [catégorie], sortez le dossier de cette catégorie, ou supprimez-le.
  3. Installez HZ-Banking, voir Installation.
  4. Démarrez le serveur, puis importez vos comptes depuis la console du serveur (voir plus bas).
  5. Ouvrez le serveur aux joueurs.
Deux banques ne tournent jamais côte à côte. Si l'ancienne banque tourne encore, HZ-Banking se tait sous son nom et affiche un message rouge dans la console qui vous demande de la retirer.

Pour ne plus répondre à la place d'une banque, mettez-la à false dans Config.Compat.


Importer vos comptes

Les soldes personnels n'ont pas besoin d'import : c'est l'argent en banque de votre framework, il reste où il est. L'import apporte le reste.

hz_banking_migrate
hz_banking_migrate apply
hz_banking_migrate renewed qb apply

  • hz_banking_migrate — essai à blanc : lit toutes les sources, n'écrit rien, affiche un résumé.
  • hz_banking_migrate apply — importe.
  • hz_banking_migrate renewed qb apply — seulement les sources nommées : okok, renewed, qb, esx.
La commande ne marche que depuis la console du serveur.
SourceCe qui est repris
okokSoldes société et gang avec leurs IBAN, IBAN personnels et codes PIN
renewedSoldes société et gang, comptes partagés avec leur propriétaire et leurs membres, historique
qbComptes société, gang et partagés, relevés bancaires en historique
esxComptes personnels avec leur code PIN (nouveaux IBAN), historique. L'argent des sociétés reste dans esx_addonaccount
  • Pas importés : les bénéficiaires, les virements programmés, l'historique d'okok, et les codes PIN des cartes de qb-banking (les joueurs choisissent un nouveau code au guichet ; le premier est gratuit).
  • Une source par compte : un compte société ou gang prend son solde dans la source la plus fiable qui le connaît, dans l'ordre de Config.MigrationPriority (okok, renewed, qb, esx). Les soldes écartés sont listés dans le résumé.
  • Relançable sans risque : un compte déjà importé est ignoré.
  • Rien n'est supprimé des anciennes tables : vous pouvez revenir en arrière.
  • Les lignes d'historique sont reprises avec Config.MigrationHistory = true (par défaut).
Lancez l'import avant d'ouvrir le serveur, après une sauvegarde.

Autres scripts

  • qb-management — ses anciens exports d'argent (GetAccount, GetGangAccount, AddMoney, AddGangMoney, RemoveMoney, RemoveGangMoney) sont repris tant qu'aucune resource qb-management ne tourne. Si vous gardez qb-management pour son menu patron, branchez plutôt les scripts qui paient les sociétés sur qb-banking ou HZ-Banking.
  • esx_billing — les factures envoyées par les menus de métier ESX deviennent des factures HZ-Banking, et ses listes de factures et ses paiements sont repris tant qu'esx_billing ne tourne pas. Retirez esx_billing pour en profiter. Voir Factures.
  • Historique d'esx_banking — logTransaction écrit une ligne dans l'historique du joueur, sans déplacer d'argent.
  • Braquages de banque — qb-bankrobbery et qbx_bankrobbery ferment l'agence pendant un braquage. Voir Agences et banquiers.
  • Comptes partagés importés de Renewed-Banking ou de qb-banking : ils reçoivent un nouvel ID HZ-Banking, et un script qui désignait un compte partagé par son ancien nom ne le retrouve plus. Les comptes de métier et de gang gardent leur nom.