Installation

Dépendances

Dépendance	Obligatoire	Pourquoi
hz_lib	Oui	Framework, inventaire, cible, notifications, la boîte de dialogue du banquier et les polices de votre thème. Gratuit, à garder à jour.
ox_lib	Oui	Bibliothèque commune.
oxmysql	Oui	Base de données.
ESX, QBCore ou Qbox	Oui	Le solde personnel est l'argent en banque de votre framework. Les serveurs sans framework ne sont pas pris en charge.
OneSync	Oui	Le serveur vérifie où se tiennent les joueurs avant chaque opération.
ox_target / qb-target	Non	Utilisés s'ils sont là : l'œil de ciblage se pose sur les banquiers et les distributeurs.
HZ-TextUi	Non	Utilisé s'il est là : des repères au-dessus des banquiers et sur les distributeurs. Sinon, hz_lib affiche une invite [E].

Étapes

Si vous utilisez une autre banque (qb-banking, Renewed-Banking, esx_banking, okokBanking…), lisez d'abord Remplacer votre script bancaire.
Déposez le dossier hz_banking dans votre dossier resources.
Ajoutez l'objet carte bancaire à votre inventaire (voir plus bas).
Ajoutez HZ-Banking à votre server.cfg, après votre framework, votre inventaire, votre système de cible et hz_lib :

ensure oxmysql
ensure ox_lib

# votre framework, inventaire et cible (exemples)
ensure qb-core
ensure ox_inventory
ensure ox_target

ensure hz_lib
ensure hz_banking

Puis redémarrez le serveur et reconnectez-vous.

L'objet carte bancaire

HZ-Banking donne à chaque joueur un objet carte bancaire, bank_card par défaut (Config.CreditCardItem). L'objet doit exister dans votre inventaire, sinon les cartes ne peuvent pas être remises et les distributeurs refusent les joueurs. La console du serveur le signale en rouge au démarrage quand il manque.

Ajoutez l'objet avant votre premier démarrage avec ox_inventory. ox_inventory supprime des inventaires enregistrés les objets qu'il ne connaît pas.

ox_inventory — dans ox_inventory/data/items.lua :

['bank_card'] = {
    label = 'Bank Card',
    weight = 10,
    stack = false,
    close = true,
    description = 'Debit card linked to your bank account.',
},

QBCore — déjà présent dans les qb-core récents (qb-core/shared/items.lua). Sinon :

bank_card = { name = 'bank_card', label = 'Bank Card', weight = 0, type = 'item', image = 'bank_card.png', unique = true, useable = true, shouldClose = true, description = 'Debit card linked to your bank account.' },

ESX sans ox_inventory — dans votre base de données :

INSERT IGNORE INTO `items` (`name`, `label`, `weight`) VALUES ('bank_card', 'Bank Card', 1);

Images — copiez les fichiers de hz_banking/inventory/ dans le dossier d'images de votre inventaire (ox_inventory : web/images/). Il y a une image de carte par banque.

Redémarrez le serveur après avoir ajouté l'objet. Le même guide est fourni dans install/items.md.

Base de données

Rien à importer. HZ-Banking crée ses tables (toutes commencent par hz_banking_) au démarrage, et ne touche jamais une table existante. sql/schema.sql est fourni pour référence.

Convars facultatives

# Journal Discord des dépôts, retraits, virements, /givecash, prêts et fermetures de comptes partagés
set hz_banking_webhook "https://discord.com/api/webhooks/..."

# Un secret privé utilisé pour enregistrer les codes PIN
set hz_banking_pin_secret "a-long-random-secret"

Réglez le secret des codes PIN une seule fois, avant que les joueurs choisissent leur code. Le changer ensuite rend tous les codes existants invalides, et les joueurs devraient en choisir un nouveau au guichet.

Ce que vous devez voir

Un blip sur chacune des 8 agences, à la couleur de sa banque.
Un banquier derrière chaque guichet. Approchez-vous : il vous regarde et vous salue.
Parlez-lui : une boîte de dialogue s'ouvre avec sa réplique et quatre choix. Choisissez Accéder à mon compte et la page de connexion de la banque s'ouvre.
Commandez une carte sur la page Cartes (la première est offerte), choisissez un code PIN, puis allez à n'importe quel distributeur : votre personnage se place devant, insère la carte, et l'écran du distributeur demande le code PIN.
Aucun message rouge sur HZ-Banking dans la console du serveur.

Mise à jour

Après une mise à jour, redémarrez tout le serveur plutôt que hz_banking seul. Mettez hz_lib à jour en même temps.

Vos fichiers config/ et locales/ vous appartiennent : comparez-les aux nouveaux et reportez les clés que vous avez modifiées.