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
| Banque | Habituelle sur | Exports repris |
|---|---|---|
| qb-banking | QBCore | AddMoney, AddGangMoney, RemoveMoney, RemoveGangMoney, GetAccount, GetGangAccount, GetAccountBalance, CreateJobAccount, CreateGangAccount, CreatePlayerAccount, CreateBankStatement |
| Renewed-Banking | Qbox | handleTransaction, getAccountMoney, addAccountMoney, removeAccountMoney, getAccountTransactions, GetJobAccount, CreateJobAccount, addAccountMember, removeAccountMember, changeAccountName |
| esx_banking | ESX | logTransaction |
| okokBanking | tous | AddMoney, RemoveMoney, GetAccount |
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
- Sauvegardez votre base de données.
- Arrêtez l'ancienne banque : retirez sa ligne
ensureduserver.cfg. Si son dossier se trouve dans une catégorie démarrée d'une seule ligneensure [catégorie], sortez le dossier de cette catégorie, ou supprimez-le. - Installez HZ-Banking, voir Installation.
- Démarrez le serveur, puis importez vos comptes depuis la console du serveur (voir plus bas).
- 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.
| Source | Ce qui est repris |
|---|---|
| okok | Soldes société et gang avec leurs IBAN, IBAN personnels et codes PIN |
| renewed | Soldes société et gang, comptes partagés avec leur propriétaire et leurs membres, historique |
| qb | Comptes société, gang et partagés, relevés bancaires en historique |
| esx | Comptes 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.
