Agency-Banking: Eine komplette Bank für FiveM, mit oder ohne Framework

Eine vollständige Bank für deine Stadt

Agency-Banking verwandelt jede Bankfiliale und jeden Geldautomaten in eine vollwertige Banking-App. Spieler sehen Bankguthaben und Bargeld nebeneinander, senden Geld und verwalten Karten, Festgeld und Anlagen an einem Ort. Es läuft mit QBCore, Qbox oder ESX und verwaltet auf einem Server ohne Framework eigene Konten. Die einzige erforderliche Ressource ist oxmysql.

Alles im Menü

• Guthaben: Bankguthaben und Bargeld, Einzahlungen und Auszahlungen.
• Überweisungen: per Server-ID oder an einen Spieler in der Nähe.
• Karten: Bankkarten in vier Designs.
• ATM-PIN: Sperre für 60 Sekunden nach fünf falschen Versuchen.
• Festgeld: standardmäßig 7, 14 oder 30 Tage, zu Zinssätzen aus der Serverkonfiguration, die Spieler nicht ändern können.
• Märkte: Handel mit Aktien und Kryptowährungen.
• Aktivitätsprotokoll: vollständiger Kontoverlauf.

Framework automatisch erkannt oder Standalone

Lass die Framework-Einstellung auf „auto“, dann erkennt die Bank QBCore, Qbox oder ESX automatisch, auch wenn das Framework erst später startet. Bei jedem Start gibt die Serverkonsole aus, welches Framework erkannt wurde oder dass die Bank im Standalone-Modus läuft. Standalone wird nur ausgewählt, wenn keines davon installiert ist.

Im Standalone-Modus werden Spieler anhand ihrer Rockstar-Lizenz identifiziert und Admins über ACE oder eine Lizenzliste in der Konfiguration festgelegt. Guthaben und Bargeld verwaltet die Bank selbst. Wenn Agency-Phone installiert ist, verwenden Telefon und Bank dasselbe Guthaben. Server mit einem eigenen Geldsystem binden es über einige Hooks in der Konfiguration an.

Das Geldsystem für deine anderen Scripts

Die Server-Exporte funktionieren mit jedem Framework gleich. Auf einem Standalone-Server bilden sie das Geldsystem: Ein Shop, ein Job oder eine Garage kann Spielern über die Bank Geld auszahlen und abbuchen, und eine geöffnete Bank zeigt das neue Guthaben sofort an.

-- pay a player into their bank account
exports['Agency-Banking']:AddBankMoney(source, 500, 'Paycheck')

-- charge a player: returns false and takes nothing if the balance is too low
if not exports['Agency-Banking']:RemoveBankMoney(source, 150, 'Garage fee') then
    -- not enough money
end

Dasselbe Paar gibt es für Bargeld mit AddCashMoney und RemoveCashMoney, neben GetBankBalance, GetCashBalance, AddTransaction für das Aktivitätsprotokoll und GetFramework. Bei QBCore und ESX übernimmt eine geöffnete Bank Änderungen am Framework-Geld automatisch. Löse nach jeder anderen Änderung agency_banking:client:MoneyChanged für den Spieler aus.

Auf dem Server geprüft

Auszahlungen, Zinssätze, Festgeld, Karten und Transaktionen werden auf dem Server geprüft. Ein modifizierter Client kann daher weder Geld erzeugen noch auf die Karten anderer Spieler zugreifen. Die Kopplung mit Agency Companion gewährt selbst keine Bankrechte: Jede Geldaktion in der App wird erneut auf dem Server validiert.

Zwei Designs und ein Größenregler

Das Menü orientiert sich am Design von Agency: ein dunkles, deckendes Panel, goldene Akzente, pillenförmige Schaltflächen und eine goldene Markierung, die entlang der Seitenleiste gleitet. Server, die den klassischen blauen Look bevorzugen, wechseln in den Designeinstellungen zu v1 und behalten alle Funktionen.

Jeder Spieler kann die Bank unter Einstellungen in 1-Prozent-Schritten auf 60 bis 150 Prozent skalieren, und jeder Spieler behält seine eigene Größe. Die Bank unterstützt 13 Sprachen und lässt sich über Marker, qb-target oder ox_target öffnen.

Einrichtung und Updates

Ein SQL-Import ist nicht nötig: Alle Tabellen, Spalten und Indizes werden beim ersten Start erstellt, sowohl unter MariaDB als auch MySQL 8. Die enthaltene agency_banking.sql ist nur für Server gedacht, deren Datenbankbenutzer keine Tabellen erstellen darf. Standardmäßig /openbank ist nur für Admins verfügbar, und eine Konfigurationsoption macht sie für alle Spieler zugänglich.

Updates sind für alle kostenlos, die Agency-Banking bereits besitzen. Konten, Karten, Transaktionen, Festgeld und Kopplungen mit Companion bleiben bei einem Update erhalten. Verwende die neue config.lua, statt die alte darüberzukopieren, und führe refresh aus, bevor du die Resource neu startest, wenn sich das Manifest geändert hat.

Banking auf dem echten Smartphone

Agency-Banking lässt sich unabhängig von Agency-Phone mit der kostenlosen Agency Companion App für iOS und Android koppeln: Kontostand, Überweisungen, Karten, Festgeld und der Geldautomaten-PIN für unterwegs. Spieler koppeln ihr Gerät mit /abconnect, kurz /abc, oder mit dem QR-Code im Bankmenü.

Hol dir Agency-Banking

Agency-Banking ist verfügbar auf Agency Scripts Shopund im Dokumentation behandelt die Konfiguration, Exports und Events.