Agency-Banking : une banque complète pour FiveM, avec ou sans framework

Une banque complète pour ta ville

Agency-Banking transforme chaque agence bancaire et chaque distributeur en une application bancaire complète. Les joueurs voient leur solde bancaire et leur argent liquide côte à côte, envoient de l’argent et gèrent leurs cartes, dépôts à terme et investissements au même endroit. La ressource fonctionne avec QBCore, Qbox ou ESX, et conserve ses propres comptes sur un serveur sans framework. La seule ressource requise est oxmysql.

Tout dans le menu

• Portefeuille : solde bancaire et argent liquide, dépôts et retraits.
• Virements : par ID serveur ou vers un joueur à proximité.
• Cartes : cartes bancaires en quatre thèmes.
• Code PIN du distributeur : verrouillage pendant 60 secondes après cinq tentatives infructueuses.
• Dépôts à terme : 7, 14 ou 30 jours par défaut, aux taux définis dans la configuration du serveur et non par le joueur.
• Marchés : trading d’actions et de cryptomonnaies.
• Journal d’activité : historique complet du compte.

Framework détecté ou mode standalone

Laisse le paramètre du framework sur auto et la banque détectera QBCore, Qbox ou ESX automatiquement, même si l’un d’eux démarre tard. À chaque démarrage, la console du serveur indique le framework détecté ou précise que la banque fonctionne en mode standalone. Le mode standalone n’est choisi que si aucun de ces frameworks n’est installé.

En mode standalone, les joueurs sont identifiés par leur licence Rockstar et les admins sont définis par ACE ou par une liste de licences dans la configuration. La banque gère elle-même le solde et l’argent liquide. Avec Agency-Phone installé, le téléphone et la banque partagent le même solde, et les serveurs qui ont leur propre système d’argent peuvent le connecter grâce à quelques hooks dans la configuration.

Le système d’argent pour tes autres scripts

Les exports serveur fonctionnent de la même façon avec chaque framework. Sur un serveur standalone, ils servent de système d’argent : un magasin, un métier ou un garage peut payer et facturer les joueurs via la banque, et une banque ouverte affiche immédiatement le nouveau solde.

-- 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

La même paire existe pour l’argent liquide avec AddCashMoney et RemoveCashMoney, à côté de GetBankBalance, GetCashBalance, AddTransaction pour le journal d’activité et de GetFramework. Sur QBCore et ESX, une banque ouverte suit automatiquement les changements d’argent du framework. Après tout autre changement, déclenche agency_banking:client:MoneyChanged pour ce joueur.

Vérifié côté serveur

Les versements, les taux d’intérêt, les dépôts à terme, les cartes et les transactions sont vérifiés côté serveur. Un client modifié ne peut donc pas créer d’argent ni toucher aux cartes des autres joueurs. L’association avec Companion ne confère aucun droit bancaire : chaque opération financière effectuée depuis l’application est de nouveau vérifiée côté serveur.

Deux designs et un curseur de taille

Le menu reprend le design Agency : un panneau sombre uni, des accents dorés, des boutons en forme de pilule et un surlignage doré qui glisse le long de la barre latérale. Les serveurs qui préfèrent le bleu classique peuvent choisir le design v1 et conserver toutes les fonctionnalités.

Dans les paramètres, chaque joueur peut ajuster la taille de la banque de 60 à 150 pour cent, par incréments de 1 pour cent. La taille est enregistrée individuellement pour chaque joueur. La banque est disponible en 13 langues et s’ouvre aux marqueurs ou via qb-target ou ox_target.

Installation et mises à jour

Aucune importation SQL n’est nécessaire : chaque table, colonne et index est créé au premier démarrage, sur MariaDB et MySQL 8. Le fichier inclus agency_banking.sql ne sert qu’aux serveurs dont l’utilisateur de base de données ne peut pas créer de tables. Par défaut, /openbank est réservé aux admins, et une option de configuration permet de l’ouvrir à tous les joueurs.

Les mises à jour sont gratuites pour tous ceux qui possèdent déjà Agency-Banking. Les comptes, cartes, transactions, dépôts à terme et associations Companion sont conservés lors d’une mise à jour. Utilise le nouveau config.lua au lieu de le remplacer par l’ancien, et exécute refresh avant de redémarrer la ressource si le manifest a changé.

La banque sur ton vrai téléphone

Agency-Banking s’associe à l’application gratuite Agency Companion sur iOS et Android, de façon autonome et indépendamment de Agency-Phone : consulte ton solde, effectue des virements, gère tes cartes et tes dépôts à terme, et utilise ton code PIN de distributeur en déplacement. Les joueurs peuvent s’associer avec /abconnect , un code court /abcou avec le code QR dans le menu de la banque.

Obtenir Agency-Banking

Agency-Banking est disponible sur le boutique Agency Scripts, et le documentation couvre la configuration, les exports et les événements.