Éditeur de code

Écrire, tester et corriger gamemodes et addons Lua sans quitter le jeu, avec rechargement à chaud.

Ouvrir un projet

• Créer → Code liste tes gamemodes et addons Lua (Modifier), et ceux du jeu ou du Workshop (Voir le code, en lecture seule).
• Nouveau gamemode : choisis un nom et le gamemode dont il dérive ; les fichiers de base sont créés (voir Structure).
• Nouvel addon Lua : crée un addon avec un script serveur (lua/autorun/server/) et un script client (lua/autorun/client/).
• Depuis Mods → Mes addons, le bouton Modifier ouvre aussi l'éditeur.
• En lecture seule, Dupliquer crée ta propre copie modifiable (par exemple pour partir du code de Sandbox).

L'interface

Autocomplétion

Pendant la frappe, l'éditeur propose les fonctions de l'API PhysiCore : après hook., net., team.…, après ply: ou ent: (méthodes), après GM: (fonctions du gamemode) et ENT: (fonctions d'entité). Entrée ou Tab valide la suggestion.

Tester et recharger

1. TESTER (F5) enregistre tout et lance une partie solo sur sb_naturebox avec ton gamemode (pour un addon : avec Sandbox, ton addon étant activé).
2. En jeu, F2 rouvre l'éditeur par-dessus la partie, qui continue.
3. Modifie le code et enregistre (Ctrl+S) : seul ce fichier est ré-exécuté, la partie continue (autorefresh).
4. Pour tout relancer : RECHARGER (F5) : tous les scripts sont relus et relancés, côté serveur et chez les joueurs, sans quitter la partie. GM:Initialize est rappelé, et PlayerSpawn pour chaque joueur.
5. Quitter la partie (Échap → Quitter la partie) ramène à l'éditeur.

Autorefresh

Comme dans Garry's Mod, l'hôte (ou le serveur) vérifie chaque seconde la date de modification des fichiers Lua chargés (gamemode et addons, serveur et client). Un fichier enregistré, depuis l'éditeur de code ou n'importe quel autre éditeur, est ré-exécuté seul :

• dans le royaume serveur, dans le client de l'hôte et chez chaque joueur connecté (selon le côté du fichier) ; la console affiche Rechargé : <fichier> ;
• les globales, tables, joueurs, entités et props sont gardés : seul ce que le fichier redéfinit est remplacé ;
• un fichier de gamemode est ré-exécuté avec GM = la table du gamemode en cours : ses méthodes GM:… sont remplacées ;
• un fichier d'entité ou d'arme (ENT, SWEP) met à jour la table de classe en place : les entités et armes déjà créées utilisent aussitôt les nouvelles fonctions ;
• ensuite, le hook OnReloaded est appelé dans les deux royaumes.

-- Garder l'état d'un rechargement à l'autre : ne pas écraser une table existante
MonAddon = MonAddon or { scores = {} }

hook.Add("OnReloaded", "MonAddon", function()
	print("MonAddon rechargé, " .. table.Count(MonAddon.scores) .. " scores gardés")
end)

Les joueurs qui arrivent ensuite reçoivent directement la version à jour. RECHARGER / F5 fait toujours un redémarrage complet de tous les scripts.

Débogueur

Points d'arrêt

• Un clic dans la marge de gauche d'un fichier .lua pose ou retire un point d'arrêt (rond rouge). Ils sont gardés pendant la session, suivent leurs lignes quand tu modifies le fichier et sont re-synchronisés avec le jeu à l'enregistrement.
• Retirer les points d'arrêt (en haut de la console) les enlève tous.
• Pause sur erreur (case de la console) : une erreur Lua met le jeu en pause là où elle se produit, avant que la pile ne se défasse ; le message s'affiche en rouge.

L'écran de pause

Quand l'exécution atteint un point d'arrêt (ou une erreur, ou un pas à pas), tout le jeu s'arrête sur la ligne : l'appel Lua en cours ne peut pas rendre la main. Un écran s'affiche par-dessus, titré LUA EN PAUSE · serveur|client · raison (point d'arrêt, pas à pas, erreur).

• Seuls les fichiers des addons et gamemodes apparaissent et sont parcourus : le Lua interne du jeu est sauté.
• Pas à pas principal et sortant s'arrêtent au plus tard à la fin de l'appel du jeu en cours (hook, timer…) ; le pas à pas détaillé s'arrête à la prochaine ligne Lua, même dans un autre appel.
• Après un pas à pas sortant, on s'arrête à la ligne suivante de l'appelant (Lua ne signale pas une seconde fois la ligne de l'appel).
• Les deux royaumes de ta machine sont débogués (serveur de l'hôte et client). Pas sur un serveur dédié ni sans fenêtre : les points d'arrêt y sont ignorés.
• En multijoueur, la connexion des autres joueurs est entretenue pendant la pause (leurs messages attendent) ; pendant la pause, le jeu n'appelle aucun Lua (hooks, timers…).

Profileur

Le bouton Profileur de la console affiche un onglet qui mesure le temps passé dans chaque fonction Lua d'une partie en cours. Choisis le royaume (Serveur ou Client), puis Démarrer / Arrêter ; Réinitialiser remet les compteurs à zéro. La durée mesurée s'affiche à côté ; le tableau est rafraîchi chaque seconde et trié par temps propre.

Raccourcis