Installation

Abhängigkeiten

Abhängigkeit	Erforderlich	Warum
hz_lib	Ja	Framework, Inventar, Target, Benachrichtigungen, die Dialogbox des Bankberaters und die Schriften Ihres Themes. Kostenlos, halten Sie es aktuell.
ox_lib	Ja	Gemeinsame Bibliothek.
oxmysql	Ja	Datenbank.
ESX, QBCore oder Qbox	Ja	Der persönliche Kontostand ist das Bankgeld Ihres Frameworks. Server ohne Framework werden nicht unterstützt.
OneSync	Ja	Der Server prüft vor jeder Operation, wo der Spieler steht.
ox_target / qb-target	Nein	Wird genutzt, wenn vorhanden: Das Target-Auge liegt auf Bankberatern und Geldautomaten.
HZ-TextUi	Nein	Wird genutzt, wenn vorhanden: Pins über den Bankberatern und auf den Geldautomaten. Sonst zeigt hz_lib einen [E]-Prompt.

Schritte

Wenn Sie eine andere Bank nutzen (qb-banking, Renewed-Banking, esx_banking, okokBanking…), lesen Sie zuerst Ihr Bank-Script ersetzen.
Legen Sie den Ordner hz_banking in Ihr resources-Verzeichnis.
Fügen Sie das Bankkarten-Item zu Ihrem Inventar hinzu (siehe unten).
Tragen Sie HZ-Banking in Ihre server.cfg ein, nach Framework, Inventar, Target und hz_lib:

ensure oxmysql
ensure ox_lib

# your framework, inventory and target (examples)
ensure qb-core
ensure ox_inventory
ensure ox_target

ensure hz_lib
ensure hz_banking

Starten Sie dann den Server neu und verbinden Sie sich neu.

Das Bankkarten-Item

HZ-Banking gibt jedem Spieler ein Bankkarten-Item, standardmäßig bank_card (Config.CreditCardItem). Das Item muss in Ihrem Inventar existieren, sonst können keine Karten ausgegeben werden und die Geldautomaten weisen Spieler ab. Fehlt es, meldet die Serverkonsole das beim Start in Rot.

Fügen Sie das Item vor dem ersten Start mit ox_inventory hinzu. ox_inventory entfernt Items, die es nicht kennt, aus gespeicherten Inventaren.

ox_inventory — in 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 — in aktuellen qb-core-Versionen bereits vorhanden (qb-core/shared/items.lua). Sonst:

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 ohne ox_inventory — in Ihrer Datenbank:

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

Bilder — kopieren Sie die Dateien aus hz_banking/inventory/ in den Bilderordner Ihres Inventars (ox_inventory: web/images/). Es gibt ein Kartenbild pro Bank.

Starten Sie den Server neu, nachdem Sie das Item hinzugefügt haben. Dieselbe Anleitung liegt in install/items.md.

Datenbank

Nichts zu importieren. HZ-Banking legt seine Tabellen (alle beginnen mit hz_banking_) beim Start an und verändert nie eine bestehende Tabelle. sql/schema.sql liegt zur Referenz bei.

Optionale Convars

# Discord log of deposits, withdrawals, transfers, /givecash, loans and shared account closures
set hz_banking_webhook "https://discord.com/api/webhooks/..."

# A private secret used to store PINs
set hz_banking_pin_secret "a-long-random-secret"

Setzen Sie das PIN-Geheimnis einmal, bevor Spieler ihre PINs festlegen. Wird es später geändert, passt keine bestehende PIN mehr, und die Spieler müssten an einem Schalter eine neue festlegen.

Was Sie sehen sollten

Ein Blip auf jeder der 8 Banken, in der Farbe ihrer Bank.
Ein Bankberater hinter jedem Schalter. Gehen Sie auf ihn zu: Er schaut Sie an und begrüßt Sie.
Sprechen Sie ihn an: Eine Dialogbox öffnet sich mit seiner Zeile und vier Auswahlmöglichkeiten. Wählen Sie Open my account, und die Anmeldeseite der Bank öffnet sich.
Bestellen Sie auf der Seite Cards eine Karte (die erste ist kostenlos), legen Sie eine PIN fest und gehen Sie zu einem beliebigen Geldautomaten: Ihr Charakter stellt sich davor, schiebt die Karte ein, und der Bildschirm fragt nach der PIN.
Keine rote Meldung zu HZ-Banking in der Serverkonsole.

Aktualisieren

Starten Sie nach einem Update den ganzen Server neu, statt nur hz_banking neu zu starten. Halten Sie hz_lib gleichzeitig aktuell.

Ihre Dateien in config/ und locales/ gehören Ihnen: Vergleichen Sie sie mit den neuen und übernehmen Sie die Schlüssel, die Sie geändert haben.