Korz ATM est un addon autonome pour les serveurs Garry’s Mod en mode DarkRP. Il ajoute un vrai système bancaire en jeu : chaque joueur a un compte, sécurisé par un code à 4 chiffres, qu’il utilise depuis des distributeurs placés sur la map. Je l’ai conçu de A à Z, du modèle 3D au stockage des données, dans la même direction artistique que mon interface.
Un modèle 3D construit en code
Le distributeur n’utilise aucun fichier de modèle externe. Sa géométrie est générée en Lua avec l’API de maillage du moteur Source (IMesh) : corps chanfreiné, écran incliné sous une visière, clavier de 15 touches en relief, lecteur de carte, fente à billets et LED d’accent. Les matériaux sont de vraies textures Source (VMT/VTF), que j’ai générées avec un encodeur VTF écrit en Python. Elles sont envoyées automatiquement aux joueurs qui se connectent.
Une interface directement sur l’écran
Quand le joueur appuie sur E, la caméra se place face à la machine. L’interface est dessinée en 3D2D sur l’écran du distributeur, avec des animations fluides. On peut cliquer sur l’écran, appuyer sur les touches 3D de la machine ou utiliser son propre clavier.
Fonctionnalités
Création de compte avec un code à 4 chiffres, et changement du code
Retrait (les billets sortent physiquement de la machine), dépôt et montants rapides
Virement vers un autre joueur, avec recherche, motif et frais configurables
Accueil avec solde animé, graphique d’évolution et historique des 20 dernières opérations
Intérêts versés automatiquement, avec des multiplicateurs par grade (VIP, etc.)
Distributeurs sauvegardés par map, qui réapparaissent au redémarrage
Sécurité et architecture
Toute la logique s’exécute sur le serveur ; le client ne fait qu’afficher.
Les codes sont hachés en SHA-256 avec un sel propre à chaque compte.
Le compte est bloqué temporairement après 3 erreurs de code.
Les requêtes SQL sont échappées et chaque montant est vérifié (plafonds, distance au distributeur, délai d’inactivité).
Les échanges réseau passent par des messages compressés.
Une API publique et des hooks permettent à d’autres addons d’utiliser la banque (logs, braquages, salaires).
Administration
L’addon s’intègre au mod d’administration SAM. Ses permissions et ses commandes apparaissent directement dans le menu SAM :
créditer un compte ou fixer un solde ;
consulter le solde d’un joueur ;
réinitialiser un code ;
sauvegarder les distributeurs, les supprimer tous, puis les restaurer si besoin.
Sans SAM, l’addon se rabat sur les droits superadmin.
Stack : GLua (client et serveur), 3D2D et IMesh, SQLite, net messages, textures Source VMT/VTF, intégration DarkRP et SAM.