Génération de scripts FiveM avec Claude Code

Create a FiveM QBCore resource.
Use fxmanifest.lua, server.lua, client.lua, and config.lua.
The command is /givegaragevehicle.
Only admins can run it.
Never trust client-provided prices or player IDs without validation.
Use QBCore.Functions.GetPlayer and return clear errors.
Keep the first version small and explain every server event.

Ce prompt précise le framework, les fichiers, la commande, la règle de permission et la limite de confiance. Cela réduit fortement les sorties inventées.

Voir la vidéo

La vidéo montre le flux complet: écrire le prompt, générer un script, contrôler le résultat et itérer avec Claude Code.

Points à vérifier avant installation

Ne mettez jamais une resource générée directement sur un serveur live. Vérifiez d'abord:

• Limite serveur/client: argent, inventaire, permissions, base de données et attribution d'items doivent rester côté serveur.
• Noms d'events: utilisez des noms précis comme fivemx:garage:purchaseVehicle, pas des events génériques.
• Validation des entrées: contrôlez les IDs joueurs, items, modèles de véhicules, quantités, prix et clés de config.
• Permissions: les outils admin doivent passer par ACE, les groupes du framework ou votre système admin existant.
• Dépendances: confirmez que chaque export existe dans votre version de QBCore, ESX, ox_lib, ox_inventory ou oxmysql.
• Performance: évitez les boucles à chaque frame si elles ne sont pas indispensables.
• Erreurs: la resource doit échouer proprement si un joueur quitte, si une requête SQL échoue ou si une dépendance manque.

Prompt pour améliorer une resource existante

Claude Code est souvent meilleur pour améliorer un code existant que pour inventer un système complet. Collez les fichiers concernés et demandez un patch limité:

Review this FiveM Lua resource for production issues.
Find security bugs, duplicated logic, missing nil checks, and server/client trust problems.
Do not rewrite the whole resource.
Return a minimal patch and explain why each change matters.

Le résultat reste relisible. Vous appliquez une correction, redémarrez la resource et testez le comportement avant de continuer.

Donnez le vrai contexte de votre serveur

La plupart des mauvais scripts FiveM générés par AI échouent parce que le modèle ne connaît pas votre stack réelle. "Fais un script QBCore" n'est pas suffisant. Un serveur mature peut utiliser QBCore pour les joueurs, ox_inventory pour les items, ox_lib pour les notifications, oxmysql pour la base de données, une resource admin personnalisée pour les permissions et un webhook Discord pour les logs staff.

Ajoutez ce contexte avant la génération:

Server stack:
- Framework: QBCore
- Inventory: ox_inventory, not qb-inventory
- Database: oxmysql
- Notifications: ox_lib notify
- Permissions: ACE group.admin
- Logging: send Discord webhook only from server.lua
- Locale files: locales/en.lua and locales/de.lua

Avec ces informations, Claude Code évite les mélanges d'API. Sans contexte, il peut appeler Player.Functions.AddItem alors que votre serveur attend exports.ox_inventory:AddItem, ou générer une notification qui n'existe pas dans votre installation.

Découpez les features en petites parties

Ne demandez pas "un système de garage complet" en un seul prompt. Demandez une étape à la fois:

1. structure de la resource et config
2. commande de test réservée aux admins
3. validation serveur pour une action
4. persistance en base de données
5. marker client ou menu
6. logs et messages d'erreur
7. nettoyage et refactor

Cette méthode ressemble plus au développement réel. Si l'étape base de données est mauvaise, vous la corrigez avant que l'interface, les permissions et les logs soient mélangés dans le même patch.

Erreurs AI fréquentes en Lua FiveM

Surveillez particulièrement ces signes:

• faire confiance à un source ou à un player ID envoyé par le client
• accepter les prix, items ou récompenses depuis un event client
• stocker un état serveur via TriggerClientEvent
• créer des variables globales au lieu d'un état local
• oublier local devant les helpers
• utiliser des exports de framework sans vérifier l'ordre d'initialisation
• lancer des boucles infinies avec Wait(0) alors qu'un event suffirait
• stocker les identifiers joueurs dans des formats incohérents
• ne pas prévoir de rollback si une écriture SQL réussit mais l'action suivante échoue

Ces erreurs ne rendent pas l'AI inutile. Elles montrent simplement que le code généré doit être relu comme une pull request d'un développeur junior.

Utiliser l'AI pour le debugging

Claude Code n'est pas seulement utile pour générer du code. Il peut être encore plus utile après une erreur. Copiez le log exact, la fonction concernée et l'action réalisée:

This error appears when I run /givegaragevehicle:
[script:garage_ai] attempt to index a nil value (local 'Player')

Here is the command handler and the framework initialization.
Explain the likely root cause and give a minimal fix.
Do not rewrite unrelated files.

Ce format force le modèle à partir des preuves. Il peut alors identifier un joueur déconnecté, une mauvaise variable source, une initialisation QBCore trop tardive ou un export différent dans votre version.

Limites de production

Soyez beaucoup plus strict avec:

• paiements, Tebex ou automatisation des donations
• attribution d'items
• outils admin
• commandes ban, kick, jail, whitelist ou staff
• argent, banque et transferts
• migrations de base de données
• logique anticheat
• resources qui exposent des endpoints HTTP

Pour ces zones, exigez une revue manuelle et un plan de rollback. Loggez les actions staff. Gardez les commandes admin côté serveur. Un event client ne doit jamais décider qui reçoit de l'argent, un véhicule, une arme ou une permission.

Checklist de test local

Avant de donner le script aux joueurs:

1. Démarrez la resource avec une console propre et cherchez les erreurs Lua.
2. Testez le cas normal avec un joueur.
3. Testez les entrées invalides: arguments manquants, mauvais IDs, montants négatifs, items inconnus et véhicules indisponibles.
4. Vérifiez le refus de permission avec un compte non-admin.
5. Redémarrez la resource pendant qu'un joueur est connecté.
6. Surveillez resmon pour détecter une consommation CPU anormale.
7. Vérifiez les lignes en base si la resource écrit des données persistantes.

Questions fréquentes

L'AI peut-elle générer un script FiveM complet?

Oui, mais complet ne veut pas dire prêt pour la production. L'AI peut créer un dossier de resource avec manifest, fichier client, fichier serveur, config et commandes. Le risque n'est pas la création des fichiers; le risque est le comportement sur un vrai serveur. Un script de production doit gérer les permissions, la compatibilité framework, les erreurs, la sécurité de la base de données, la localisation, les logs et les futures mises à jour.

Pour un petit outil, le résultat peut demander seulement un nettoyage léger. Pour l'économie, l'inventaire, les outils admin ou les systèmes persistants, considérez le code généré comme un prototype et relisez chaque action serveur.

Claude Code est-il meilleur qu'un prompt de chat classique?

Claude Code est plus utile quand la resource existe déjà dans un dossier de projet. Il peut travailler sur les fichiers, proposer des patchs et garder le contexte entre plusieurs fichiers. Un chat classique suffit pour brainstormer, expliquer une erreur ou produire un petit snippet. Pour du vrai travail FiveM, le contexte fichier est essentiel: fxmanifest.lua, configs, exports existants, helpers SQL et conventions de nommage.

Faut-il laisser l'AI modifier les fichiers du serveur live?

Non. Gardez les changements assistés par AI dans une copie locale ou une branche git. Testez d'abord sur un serveur de développement. Les fichiers live contiennent des données de production, un état joueur actif et un ordre de dépendances parfois fragile. Un script généré cassé peut spammer la console, dupliquer des items, corrompre un état ou expulser des joueurs si la logique admin est touchée.

Quel est le meilleur premier projet AI pour FiveM?

Commencez par un outil à faible risque: commande debug réservée au staff, validateur de config, test de notification ou petite resource qui lit des données sans modifier l'argent, l'inventaire ou les permissions. Une fois le workflow fiable, passez aux scripts qui écrivent un état.

Comment reconnaître du bon Lua généré?

Un bon Lua est simple. Il utilise local, valide les entrées, retourne tôt en cas d'erreur, logge les actions importantes, sépare la config de la logique et garde les events client minces. Si un script est difficile à expliquer, contient beaucoup de globals ou laisse le client décider des récompenses, il doit être réécrit avant la production.

Conclusion

La génération de scripts FiveM par AI est un accélérateur, pas une garantie de qualité. Utilisez Claude Code pour préparer, expliquer et refactorer. Gardez les changements petits. Relisez chaque event et chaque permission. Testez toujours sur un serveur de développement avant la production.

Avec cette méthode, Claude Code peut réduire le travail Lua répétitif tout en vous laissant le contrôle sur l'expérience réelle de vos joueurs.