HZ-Banking

Qu'est-ce que HZ-Banking ?

HZ-Banking est un script bancaire complet pour FiveM. Il installe un guichet et un banquier dans chaque banque de la carte, ouvre une app bancaire au style du site de chaque banque, et transforme chaque distributeur en vraie machine : l'écran de la banque s'affiche sur le distributeur lui-même, la carte entre et le code PIN se tape sur le pavé.

Il couvre ce qu'un serveur roleplay attend de sa banque : comptes personnels, société, de gang et partagés, virements par IBAN, virements programmés, cartes bancaires, épargne avec intérêts, prêts selon le score de crédit et factures. Et il remplace qb-banking, Renewed-Banking, esx_banking et okokBanking sans casser les scripts qui s'en servent.

Tourne sur ESX, QBCore et Qbox grâce à hz_lib.

Pourquoi la banque compte sur un serveur RP

Chaque métier, chaque magasin et chaque salaire d'un serveur roleplay finit à la banque. Pourtant la plupart des scripts bancaires ouvrent un menu plat à côté d'un blip, et le distributeur est le même menu avec un autre titre. Les joueurs n'ont jamais l'impression d'être allés à la banque.

HZ-Banking en fait un lieu. Le banquier lève les yeux quand vous entrez, vous salue et vous demande ce qu'il peut faire pour vous. Au distributeur, votre personnage glisse sa carte et tape son code de sa propre main, et les billets sortent de la fente. Les amendes ont une échéance, les prêts un score de crédit, et l'argent laissé sur l'épargne rapporte.

Derrière, le serveur vérifie tout : distance au guichet ou au distributeur, carte, code PIN, droits d'accès et montants. Le solde personnel reste l'argent en banque de votre framework : tous les scripts voient le même chiffre.

Les fonctionnalités en détail

Une app pour chaque banque

L'app ressemble au site de la banque : Fleeca, Maze Bank, Pacific Standard, Blaine County ou Union Depository, avec son logo, ses couleurs et sa carte, en mode sombre ou clair. Elle s'ouvre sur une connexion animée, puis : un accueil avec un graphique sur 7 jours, les opérations avec recherche et filtres, les virements par IBAN avec bénéficiaires enregistrés, les virements programmés (une fois, quotidiens, hebdomadaires ou mensuels), les cartes, l'épargne, les prêts, les factures, un IBAN personnalisé et le code PIN. Anglais et français fournis ; une autre langue tient dans un fichier JSON.

Des banquiers qui parlent

Chacune des 8 banques a son banquier, avec son nom. Il suit les joueurs du regard, les salue, répond à chaque opération (dépôt, retrait, virement, nouvelle carte, prêt accordé ou refusé, pas assez d'argent) et dit au revoir, avec des voix d'homme et de femme en anglais ou en français. Lui parler ouvre une boîte de dialogue dont les choix ouvrent l'app sur la bonne page : le compte, les cartes ou un prêt.

Des distributeurs avec leur propre écran

Sur les quatre modèles de distributeur du jeu, l'écran de la banque s'affiche sur la machine elle-même : Maze Bank sur les distributeurs de rue, Fleeca sur ceux des agences Fleeca. Le personnage se place face au distributeur, insère sa carte, et sa main suit la souris sur le pavé. Retrait, dépôt ou dernières opérations : les billets sortent de la fente, les dépôts sont avalés, et chaque touche bipe.

Cartes bancaires et code PIN

Chaque carte est un objet bank_card de la banque qui l'a émise, avec ses quatre derniers chiffres et sa date d'expiration. Les joueurs peuvent en avoir plusieurs, geler ou résilier chacune, et la première est offerte. Les cartes expirent après 90 jours par défaut, et trois codes faux bloquent la carte 5 minutes. La carte peut aussi devenir facultative, code seul.

Comptes société, de gang et partagés

Chaque métier a son compte société et chaque gang le sien, avec des règles de grade, le droit banque des grades sur Qbox, et l'argent des sociétés ESX gardé dans esx_addonaccount. Les joueurs ouvrent des comptes partagés, ajoutent des membres par IBAN ou identifiant citoyen, et les ferment avec le solde reversé au propriétaire.

Épargne et prêts

L'épargne rapporte des intérêts sur le plus bas solde de chaque période : impossible de farmer les intérêts avec des dépôts éclair. Les prêts suivent un score de crédit de 300 à 850, avec quatre paliers jusqu'à 200 000, des plans de 4, 8 ou 12 échéances prélevées automatiquement, des pénalités de retard, l'épargne en secours, et le défaut de paiement avec un event serveur pour vos scripts de recouvrement. Les deux sont activés par défaut et chacun se désactive.

Factures

Les métiers et les gangs facturent les joueurs proches avec /invoice. Les amendes de la police et des secours ne se refusent pas. Les factures sont dues sous 7 jours, puis prennent 10 % de pénalité et sont prélevées automatiquement sur la banque. Les menus de métier ESX qui envoient des factures par esx_billing continuent de marcher.

Remplace votre banque

HZ-Banking répond aux exports de qb-banking, Renewed-Banking, esx_banking et okokBanking, et importe leurs comptes avec hz_banking_migrate, à blanc d'abord. Les braquages de qb-bankrobbery et qbx_bankrobbery ferment l'agence le temps du braquage.

Compatibilité

• ESX, QBCore et Qbox, grâce à hz_lib. Les serveurs sans framework ne sont pas pris en charge.
• Nécessite hz_lib (gratuit), ox_lib, oxmysql et OneSync.
• Marche avec ox_inventory et qb-inventory. ox_inventory et ESX demandent d'ajouter l'objet bank_card : les définitions sont fournies.
• Marche avec ox_target, qb-target et HZ-TextUi, ou l'invite [E] de hz_lib.
• Remplace qb-banking, Renewed-Banking, esx_banking et okokBanking : retirez d'abord l'ancienne banque.

Installation

1. Retirez votre ancienne resource bancaire de votre server.cfg.
2. Déposez hz_banking dans votre dossier resources et ajoutez l'objet bank_card à votre inventaire.
3. Ajoutez ensure hz_banking après votre framework, votre inventaire, votre cible et hz_lib, puis redémarrez le serveur.

Pour reprendre vos comptes, lancez hz_banking_migrate, puis hz_banking_migrate apply, dans la console du serveur. Après une mise à jour, redémarrez tout le serveur plutôt que hz_banking seul. Guide complet dans la documentation.

Performance

Loin des banques et des distributeurs, HZ-Banking se contente de vérifier les distances environ une fois par seconde, et les banquiers n'apparaissent qu'à moins de 60 m. Le travail se fait près d'un guichet ou d'un distributeur, et pendant que l'app est ouverte. Chaque opération est vérifiée par le serveur, avec des limites de requêtes par joueur.