Mods Ground Branch : installer des mods du Workshop sur un serveur et créer les vôtres

Ground Branch a une scène de mods très active : armes, optiques, tenues, écussons, missions et modes de jeu. Tout passe par le Steam Workshop (jeu 16900). Ce guide sert à trois publics :

• les responsables de serveur, qui veulent installer des mods,
• les moddeurs, qui créent des missions, des modes de jeu ou des écussons avec les outils du jeu,
• les créateurs d'armes et d'objets, qui travaillent avec le Mod Kit officiel.

Les informations sur la création de mods reprennent la documentation officielle de BlackFoot Studios, le wiki Ground Branch.

#Partie 1 : installer des mods sur un serveur dédié

#Ajouter des mods depuis le panel

1. Sur la page du mod dans le Steam Workshop, repérez son numéro : le nombre à la fin de l'adresse, après ?id=.
2. Dans le panel EsoterHost, onglet Paramètres, collez ce numéro dans Mods du Steam Workshop. Pour plusieurs mods, séparez les numéros par des virgules. Vous pouvez aussi coller l'adresse entière de la page.
3. Cliquez sur Enregistrer et redémarrer.

Le serveur télécharge lui-même les mods au démarrage. Dans l'onglet Console, ces lignes confirment que tout s'est bien passé :

[EsoterHost] Mods du Workshop : 3444393266
LogGBModKit: Warning: UGBModKitSubsystem::InitWorkshopContentPath(): WorkshopContentPath set to 'Z:/home/container/GroundBranch/ServerMods/content/16900/'
LogTemp: Warning: UGBGameInstance::OnDedicatedServerModSyncFinished(): bSuccess: true

Pour retirer un mod, supprimez son numéro du champ et redémarrez. Videz le champ pour retirer tous les mods.

#Comment le serveur gère les mods

#Bonnes pratiques côté serveur

• Ajoutez les mods un par un sur un serveur déjà stable. Si un problème apparaît, vous savez lequel en est la cause.
• Prévenez vos joueurs en publiant la liste des mods sur votre Discord, avec les liens Workshop.
• Surveillez la mémoire : un gros pack d'armes ou de cartes alourdit le serveur. Si le processeur ou la mémoire restent au maximum dans l'onglet Métriques, passez à la formule supérieure.
• Faites une sauvegarde avant de changer beaucoup de mods d'un coup.

#Partie 2 : les deux façons de créer un mod

BlackFoot Studios distingue deux familles de mods :

Un « asset », au sens d'Unreal Engine, est un fichier visible dans le navigateur de contenu de l'éditeur (.uasset, ou .umap pour une carte). Tout le reste (scripts Lua, missions, images d'écussons, fichiers de tenues) se fait sans le Mod Kit.

#Partie 3 : Quick Create, le mod sans outil externe

#Créer le dossier du mod

1. Dans le jeu, ouvrez Modding dans le menu principal, puis Quick Create.
2. Créez un dossier de mod (« Staged Mod »). Gardez l'emplacement proposé par défaut : un nom d'utilisateur Windows avec des caractères spéciaux peut gêner l'envoi vers Steam.
3. Le jeu crée les sous-dossiers où ranger vos fichiers. Vous pouvez supprimer ceux dont vous n'avez pas besoin.

Les types de fichiers reconnus, d'après la documentation officielle :

#Tester puis publier

• Tester : votre mod est chargé en jeu pendant que vous travaillez, sous le nom Mod ID #0. Testez-le autant que nécessaire avant de le publier.
• Publier : la dernière étape de Quick Create crée l'élément Workshop et envoie le contenu du dossier.
• Mettre à jour : utilisez Replace Existing Mod, choisissez votre mod dans la liste, puis renvoyez-le. Tout le contenu actuel du dossier remplace l'ancienne version : vérifiez-le avant l'envoi.
• Rendre visible : passez le mod en Public ou Unlisted sur sa page Workshop pour le partager ou l'utiliser sur un serveur. Le titre, la description et les captures se modifient aussi sur cette page.

#Partie 4 : créer une mission

Les missions se créent avec l'éditeur intégré au jeu.

1. Dans le menu principal, choisissez Lone Wolf et lancez une mission (Terrorist Hunt ou Intel Retrieval) sur la carte voulue.
2. Une fois dans la Ready Room, ouvrez la console et tapez editmission.
3. L'éditeur s'ouvre : les objets à placer sont à gauche, la liste des objets de la mission et leurs propriétés à droite, la barre d'outils en haut.

Les éléments de base d'une mission en coopération :

Une fois les ennemis placés, sélectionnez tous les points d'apparition et cliquez sur Determine Squad IDs. Avant d'enregistrer, lancez Validate Level depuis le menu File : il signale les propriétés mal réglées. Les modes PvP (Uplink, Team Elimination, DTAS, Hostage Rescue, Deathmatch) ont chacun leurs objets propres, détaillés dans le guide officiel de l'éditeur de missions.

Rangez la mission dans GroundBranch/Mission/<Carte>/ de votre dossier de mod, puis publiez-la avec Quick Create. Sur votre serveur, ajoutez-la ensuite à MapList.ini comme expliqué dans le guide des cartes et missions.

#Partie 5 : créer un mode de jeu en Lua

La logique des modes officiels (Terrorist Hunt, Intel Retrieval, Team Elimination…) est écrite en Lua, dans GroundBranch/GameMode. Un nouveau mode se compose d'un script, de missions faites pour lui, et souvent d'une table de traductions et d'équipements d'IA.

#La structure d'un script

Tous les scripts Lua de Ground Branch suivent la même forme : une table qui porte les variables du mode, des fonctions appelées par le jeu, et la table renvoyée à la fin.

local monmode = {
    StringTables = { "MonMode" },
    GameModeAuthor = "(c) Votre équipe, 2026",
    GameModeType = "PVE",
    PlayerTeams = {
        BluFor = {
            TeamId = 1,
            Loadout = "NoTeam",
        },
    },
}

function monmode:PostInit()
    -- Réglages du mode, une seule fois au chargement de la carte
end

function monmode:OnRoundStageSet(RoundStage)
    if RoundStage == "PreRoundWait" then
        -- Préparer la manche : faire apparaître l'IA, placer les objectifs
    end
end

function monmode:OnCharacterDied(Character, CharacterController, KillerController)
    -- Compter les morts, vérifier la condition de victoire
end

return monmode

Les conventions à respecter, d'après la documentation officielle :

• GameModeType vaut PVE (une équipe contre l'IA), PVP (équipe contre équipe), FFA ou PVPFFA (chacun pour soi), ou Training.
• PlayerTeams : en coopération, une équipe BluFor avec le TeamId 1. En PvP, Blue (TeamId 1) et Red (TeamId 2). Évitez les TeamId 0 et 255, réservés.
• StringTables : le nom de votre table de traductions, en général celui du mode. La description affichée dans les menus vient de la clé gamemode_description_<mode>, préfixée [Solo/Co-op] ou [PvP].
• Ne faites pas apparaître l'IA dans PostInit() : cette fonction n'est appelée qu'une fois. Préparez chaque manche dans OnRoundStageSet(), en général à l'étape PreRoundWait.

#Les étapes d'une manche

Un mode peut ajouter ses propres étapes : Uplink, par exemple, ajoute BlueDefenderSetup et RedDefenderSetup.

#Les fonctions appelées par le jeu

Les plus utiles, parmi celles de la documentation officielle : PreInit(), PostInit(), OnRoundStageSet(RoundStage), OnRoundStageTimeElapsed(RoundStage), PlayerInsertionPointChanged(PlayerState, InsertionPoint), PlayerReadyStatusChanged(PlayerState, ReadyStatus), PlayerCanEnterPlayArea(PlayerState), GetSpawnInfo(PlayerState), PlayerEnteredPlayArea(PlayerState), OnCharacterDied(Character, CharacterController, KillerController), OnGameTriggerBeginOverlap(GameTrigger, Character), OnLaptopPickedUp(), OnMissionSettingsChanged(ChangedSettingsTable), ShouldCheckForTeamKills() et LogOut(Exiting). Un mode peut aussi fournir un script <Mode>Validate.lua, appelé par l'éditeur de missions quand il valide une carte.

Le jeu cherche les scripts appelés par require() dans GroundBranch/GameMode et GroundBranch/Lua, ceux du jeu et ceux du mod qui contient le mode en cours. La référence complète des fonctions (bibliothèques gamemode, ai, timer, actor…) est la bibliothèque Lua officielle, à jour pour la version 1035.

#Les mutateurs, pour régler un serveur

Un mutateur est un script Lua chargé au démarrage du jeu, qui reste actif d'une mission à l'autre. C'est l'outil idéal pour un responsable de serveur : règles de pseudos, filtrage du chat, restrictions d'équipement. Le jeu en fournit trois de base, dans GroundBranch/Mutators : InventoryManagement.lua, ServerManagement.lua et WeaponRestriction.lua.

Leurs variables propres :

• MutatorName et MutatorAuthor : nom et auteur.
• ServerOnly = true : le mutateur n'est chargé que sur un serveur, dédié ou hébergé.
• ServerAuthoritative = true : les réglages du serveur s'imposent aux joueurs tant qu'ils y sont connectés.

#Partie 6 : créer un écusson

Les écussons (patches) sont le mod le plus simple. Le format officiel :

• une image PNG de 512 × 256 pixels, sans transparence (le canal alpha est ignoré),
• un nom de la forme (Auteur)Nom.png, avec des _ à la place des espaces,
• en option, une carte de normales (Auteur)Nom_N.png, de même taille,
• rangée dans GroundBranch/Patches/<Catégorie>/ du dossier de mod. Les catégories d'origine sont BloodType, Country, Morale et Role, et vous pouvez en créer d'autres.

L'écusson s'affiche en jeu au format 1,65:1 alors que l'image est en 2:1 : pour garder un cercle bien rond, compressez votre dessin horizontalement d'un facteur 0,825 avant d'enregistrer.

#Partie 7 : le Mod Kit pour les armes et les objets 3D

Le Mod Kit (ou SDK) est une version de l'éditeur Unreal Engine 4 enrichie des systèmes de Ground Branch. Il est gratuit, et distribué uniquement sur l'Epic Games Store pour des raisons de licence d'Unreal Engine. Il contient les systèmes du jeu et des modèles provisoires, mais pas les cartes ni les assets du jeu.

#Installer et démarrer

1. Sur l'Epic Games Store, cherchez GROUND BRANCH Mod Kit et ajoutez-le gratuitement à votre bibliothèque.
2. Lancez-le depuis la bibliothèque Epic. Aux questions du premier démarrage (Wwise, plugins), vous pouvez en général répondre non ou ignorer.

#Créer, empaqueter, publier

La barre d'outils du Mod Kit ajoute quatre boutons propres à Ground Branch :

Quelques points pratiques :

• Rangez tout votre contenu dans le dossier qui porte le numéro Workshop, pour éviter les conflits avec un autre mod du même nom.
• Si vos fichiers ne s'affichent pas, activez Show Plugin Content dans les options d'affichage du navigateur de contenu.
• Le .pak empaqueté se trouve dans %LocalAppData%\GroundBranch\Saved\StagedMods\<NomDuMod>. En cas d'échec, le journal (Window → Developer → Output Log) indique le fichier en cause, souvent une erreur de compilation de blueprint.
• Pour publier, Steam doit être lancé avec un compte qui possède Ground Branch. Remplissez le fichier WorkshopItem à la racine du mod avant Upload Mod.
• Un nouveau mod est caché à sa publication : testez-le, puis passez-le en Public ou Unlisted.

Erreurs fréquentes à la publication :

#Partie 8 : tester votre mod sur un vrai serveur

Un mod qui marche en solo peut se comporter autrement sur un serveur dédié, surtout un mode de jeu ou un mutateur. Avant de l'annoncer à la communauté :

1. Publiez-le, puis passez-le en Unlisted : il reste discret, mais un serveur peut le charger.
2. Ajoutez son numéro dans l'onglet Paramètres de votre serveur EsoterHost et redémarrez.
3. Vérifiez dans la console la ligne OnDedicatedServerModSyncFinished(): bSuccess: true.
4. Pour une mission ou un mode de jeu, ajoutez sa ligne dans MapList.ini et redémarrez : la console affiche Selected '…' as initial map puis Game class is '…', la classe du mode chargé.
5. Jouez une manche complète avec deux ou trois testeurs, puis passez le mod en Public.

#Questions fréquentes

#Comment installer un mod sur un serveur Ground Branch ?

Collez le numéro Workshop du mod dans l'onglet Paramètres du panel EsoterHost, puis redémarrez. Le serveur télécharge et charge le mod lui-même au démarrage.

#Où trouver le numéro d'un mod Ground Branch ?

À la fin de l'adresse de sa page sur le Steam Workshop, après ?id=. Vous pouvez aussi coller l'adresse entière dans le panel.

#Pourquoi mon mod n'est-il pas chargé par le serveur ?

Le plus souvent, le mod est encore caché ou privé sur le Workshop. Il doit être public ou non répertorié (Unlisted) pour être utilisé sur un serveur.

#Faut-il le Mod Kit pour créer une mission Ground Branch ?

Non. Les missions se créent avec l'éditeur intégré au jeu (commande editmission en Lone Wolf) et se publient avec le menu Quick Create, sans Mod Kit.

#Où télécharger le Mod Kit de Ground Branch ?

Sur l'Epic Games Store, gratuitement, sous le nom GROUND BRANCH Mod Kit. Il est réservé aux contenus Unreal Engine comme les armes.

#En quel langage sont écrits les modes de jeu Ground Branch ?

En Lua. Chaque mode est un script rangé dans GroundBranch/GameMode, avec des fonctions comme PostInit et OnRoundStageSet appelées par le jeu.

#Quelle taille pour un écusson Ground Branch ?

Une image PNG de 512 × 256 pixels, sans transparence, nommée (Auteur)Nom.png et rangée dans GroundBranch/Patches/<Catégorie>/.

#Pour aller plus loin

• Le guide complet du serveur dédié Ground Branch
• Cartes, missions et rotation MapList.ini
• Commandes admin et réglages du serveur
• La documentation officielle des mods Ground Branch

Image : GROUND BRANCH, BlackFoot Studios