Tous les projets

ATM Sys

Korz ATM est un distributeur bancaire complet pour Garry’s Mod, écrit en Lua (GLua). Le modèle 3D est construit en code, l’interface s’affiche en 3D sur l’écran de la machine et les comptes sont stockés en SQLite côté serveur avec des codes secrets hachés. L’addon s’utilise avec DarkRP et s’intègre au mod d’administration SAM.

Catégorie
Gmod
Année
2026
Stack
Glua
ATM Sys

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.