Hammer++ pour GMod : installation, fonctionnalités et différences

Hammer++ est une version gratuite et largement étendue de Hammer Editor, développée par ficool2 et non par Valve. Il existe un build dédié à Garry’s Mod : il se copie en complément dans le dossier bin/win64 du jeu et se lance via hammerplusplus.exe, tandis que le Hammer fourni reste en place à côté. Hammer++ travaille avec les mêmes fichiers VMF et appelle les programmes vbsp.exe, vvis.exe et vrad.exe de GMod pour compiler. Les principales nouveautés sont des aperçus dans la vue 3D, des brushes enregistrés avec plus de précision, de meilleurs outils et une compilation qui ne bloque plus l’éditeur.

Ce qu’est Hammer++ et qui le développe

Le site du projet décrit Hammer++ comme une modification gratuite et de grande ampleur du Hammer de Valve. Son ambition : être plus stable et plus à jour, corriger de nombreux bugs et ajouter des fonctionnalités que l’on trouve dans les éditeurs de niveaux modernes. Il est programmé par ficool2. Le projet n’est pas affilié à Valve.

Hammer++ existe en builds séparés pour différentes branches du Source Engine, entre autres Garry’s Mod, Team Fortress 2 et Portal 2. D’après la page de téléchargement, le mauvais build ne démarre pas. Pour GMod, la page met explicitement en garde contre le build « Source SDK 2013 Multiplayer ». La bonne entrée est « Garry’s Mod ».

Les bases de l’utilisation de l’éditeur ne changent pas. Si tu n’as jamais travaillé avec Hammer, lis d’abord Hammer Editor pour Garry’s Mod : installation et première map.

Ce qui change au quotidien

Sur la page des fonctionnalités du projet, voici celles qui se remarquent le plus quand tu construis au quotidien :

Installation pour Garry’s Mod

1. Vérifier le dossier. Le build GMod de Hammer++ est un programme 64 bits et va avec les fichiers 64 bits du jeu. Regarde si ton installation contient le dossier GarrysMod/bin/win64 avec vbsp.exe, vvis.exe et vrad.exe. S’il manque, passe GMod sur la branche x86-64 dans Steam, sous Propriétés > Bêtas.
2. Télécharger le bon build. Sur la page de téléchargement de Hammer++, choisis « Garry’s Mod ».
3. Décompresser comme indiqué. Les étapes d’installation se trouvent dans le README.txt contenu dans le téléchargement.
4. Vérifier le résultat. Ensuite, bin/win64 contient le fichier hammerplusplus.exe et le dossier hammerplusplus. Le téléchargement comprend aussi le visualiseur de modèles HLMV++, qui est facultatif.
5. Lancer. Ouvre hammerplusplus.exe et crée-lui un raccourci.

GarrysMod/bin/hammer.exe                  Hammer fourni
GarrysMod/bin/win64/hammerplusplus.exe    Hammer++
GarrysMod/bin/win64/hammerplusplus/       réglages, FGD, programmes auxiliaires

Dans l’installation examinée pour cet article, Hammer++ avait ajouté hammerplusplus.exe, le dossier hammerplusplus et les deux fichiers de HLMV++. Aucun fichier de GMod ne portait la date de cette installation, et le Hammer fourni était toujours en place.

Où se trouvent la configuration et les fichiers

Hammer++ ne partage aucun réglage avec le Hammer fourni. Tout se trouve dans le dossier bin/win64/hammerplusplus :

Après le premier lancement, vérifie Tools > Options. Dans l’onglet Game Configurations, « Game Data files » liste garrysmod.fgd du dossier bin, et le « Game Directory » pointe vers garrysmod. Dans l’onglet Build Programs, tu trouves les trois compilateurs et, sous « Place compiled maps in this directory before running the game », le dossier garrysmod/maps. Assure-toi aussi que le fichier renseigné comme « Game executable » existe vraiment, sinon le jeu ne se lancera pas après la compilation.

Compilateurs : les mêmes outils, une autre fenêtre

Hammer++ ne fournit pas ses propres versions de VBSP, VVIS et VRAD. Sa configuration de jeu liste les programmes de GMod. Dans l’installation examinée, le Hammer fourni pointait vers bin/vbsp.exe et Hammer++ vers bin/win64/vbsp.exe, c’est-à-dire vers la version 32 bits et la version 64 bits des mêmes outils.

Le résultat d’un BSP dépend donc du compilateur et de ses paramètres, et non de l’éditeur. Les leaks, les portals et les lightmaps apparaissent comme avant. Ce que font les trois programmes est expliqué dans VBSP, VVIS et VRAD expliqués.

Ce qui change, c’est le déroulement. hammerplusplus_compiler.exe exécute les étapes dans une fenêtre de console, et le log est enregistré comme d’habitude dans un fichier .log à côté du VMF. Pour le mode Expert de Run Map, Hammer++ fournit des séquences prêtes à l’emploi :

Default                                 vbsp, vvis, vrad
Fast                                    vvis -fast, vrad -bounce 2 -noextra
LDR + HDR Full Compile                  vrad -both
LDR + HDR Full Compile -final (slow!)   vrad -both -final
Only Entities                           vbsp -onlyents

L’aperçu de l’éclairage ne remplace pas VRAD. Il ne fait que simuler la lumière dans l’éditeur. Les lightmaps de ta map sont toujours calculées par VRAD, et seule la compilation montre le résultat final. Plus de détails dans le guide d’éclairage Source Engine. Tu peux toujours coller des messages du log dans le Map Scanner. Il détecte les causes racines, les erreurs en cascade et les solutions adaptées dans les logs VBSP, VVIS et VRAD.

Limites, et quand le Hammer fourni suffit

• La boîte de dialogue de fichiers se fige : Sur certaines versions de Windows, Hammer++ reste bloqué dans la boîte de dialogue d’ouverture. Le contournement indiqué sur la page de téléchargement : désactiver FileDialogHack dans hammerplusplus_settings.ini, c’est-à-dire remplacer 1 par 0.
• Pas de manifests : Hammer++ avertit lui-même que les manifests ne sont pas pris en charge. Seules les instances sont entièrement prises en charge.
• editor_text n’existe que dans l’éditeur : L’entité affiche du texte 3D dans Hammer++ et, d’après le site du projet, ne fonctionne pas en jeu.
• Données supplémentaires dans le VMF : Hammer++ enregistre les vertices exacts en plus. Il continue d’écrire les anciennes données, moins précises, pour que les compilateurs et les autres versions de Hammer puissent lire le fichier. Dans les options, tu désactives cela avec « Use precise vertex data ».
• Statut Discord : Hammer++ peut afficher dans Discord que tu travailles et sur quoi. Si tu construis une map non publiée, désactive-le dans les options.

Le Hammer fourni suffit quand tu construis tes premières pièces, ou quand tu n’as pas de dossier bin/win64 et que tu ne veux pas changer de branche. Il reste aussi ta solution de repli si Hammer++ refuse un jour de démarrer.

Questions fréquentes

Une map faite dans Hammer++ a-t-elle un aspect différent en jeu ?

Non. Le BSP est produit par les compilateurs de GMod, pas par l’éditeur. Les aperçus de la lumière, du brouillard ou des particules ne valent que dans Hammer++. Les différences dans le résultat viennent de paramètres de compilation comme -both ou -final.

Hammer++ affiche-t-il aussi le contenu de Counter-Strike: Source ?

La plus grande partie, et d’après les fichiers, sans que tu montes le jeu. Depuis la mise à jour de juillet 2025, GMod fournit lui-même la plupart des textures, modèles et sons de CS:S, sous la forme du paquet content_cstrike dans son dossier sourceengine. gameinfo.txt ne mentionne pas ce paquet, mais dans l’installation examinée, le fichier programme hammerplusplus.exe contient son chemin, tout comme les compilateurs de GMod. Le moyen le plus rapide d’en avoir le cœur net est le navigateur de textures : filtre sur de_dust, un dossier de ce paquet. La musique, les voix et les maps de CS:S ne sont pas incluses, et le contenu d’autres jeux n’apparaît que si le jeu est monté. D’après le wiki GMod, les dossiers renseignés dans garrysmod/cfg/mount.cfg valent aussi pour Hammer et les compilateurs. Contenu CS:S et HL2 dans les maps GMod explique si tes joueurs verront ce contenu par la suite.

Comment mettre à jour Hammer++ ?

Hammer++ peut chercher des mises à jour au démarrage et propose alors d’ouvrir le téléchargement dans ton navigateur. Copie les nouveaux fichiers par-dessus ton installation existante et confirme l’écrasement. Remplace bien tous les fichiers à cette occasion : Hammer++ compare la version de son FGD à celle du programme et signale un fichier obsolète.