Installation et préparation de Visual Studio Code

1Télécharger VS Code

Va sur code.visualstudio.com/Download et prends la version de ton système. Sous Windows, il faut Windows 10 ou 11 en 64 bits ; sur Mac, macOS 12 ou plus récent ; sous Linux, il existe des paquets .deb et .rpm. VS Code est gratuit, y compris pour un usage commercial, donc tu peux t'en servir pour un addon que tu vendras un jour.

Lance l'installeur et garde les options par défaut. Sous Windows, coche quand même la case « Add "Open with Code" action to Windows Explorer directory context menu » : un clic droit sur un dossier suffira ensuite pour l'ouvrir dans VS Code.

2L'extension GLua

VS Code connaît le Lua, pas le GLua. Sans extension, il ne sait pas que hook.Add existe ni que != est valide. Ouvre l'onglet Extensions (l'icône des quatre carrés dans la barre de gauche, ou Ctrl+Shift+X), cherche GLua Enhanced et installe celle publiée sous l'identifiant venner.vscode-glua-enhanced.

Elle t'apporte la coloration du GLua, l'autocomplétion des fonctions de GMod, et au survol d'une fonction, sa description tirée du wiki avec son royaume : serveur, client ou les deux.

3Ouvrir un dossier, pas un fichier

Dans VS Code, passe toujours par File > Open Folder… (Fichier > Ouvrir le dossier… si ton VS Code est en français) et choisis le dossier de l'addon entier. L'explorateur à gauche affiche alors toute l'arborescence, et la recherche (Ctrl+Shift+F) fouille tous les fichiers de l'addon d'un coup.

Pour vérifier que tout marche, crée un dossier brouillon sur ton bureau, ouvre-le dans VS Code, puis crée dedans un fichier brouillon.lua et colle ceci :

1// Un commentaire à la façon de GMod2local minerai = "fer"34if minerai != "or" && minerai != "argent" then5    print("Minerai courant : " .. minerai)6end

Si l'extension est bien installée, la ligne 1 s'affiche en gris, comme un commentaire. Avec la coloration Lua de base de VS Code, elle s'affiche comme du code : pour le Lua standard, // n'est pas un commentaire, c'est un ajout de GMod.

Ligne 4, && veut dire « et » : la condition est vraie si le minerai n'est ni de l'or, ni de l'argent. Ligne 5, .. colle deux textes bout à bout. Tu ne peux pas encore lancer ce fichier : c'est le rôle de la leçon suivante.

4Vérifier l'encodage

En bas à droite de VS Code, la barre d'état affiche l'encodage du fichier ouvert. Il doit indiquer UTF-8, la valeur par défaut. C'est ce qui garde tes accents intacts quand un message comme "Minerai récolté" s'affiche dans le chat du jeu.