Installation de mods GoreBox sur PC

Bien que le Workshop mod.io gère automatiquement la plupart des installations d'addons GoreBox v16, le placement manuel dans les dossiers reste essentiel pour les développeurs Lua testant des scripts non publiés, récupérant des états de sync cassés et installant des zips communautaires partagés en dehors du navigateur Workshop. Chaque addon installé manuellement vit dans un répertoire Mods dédié que GoreBox scanne au démarrage. Comprendre ce chemin évite la frustration classique du « mod qui ne charge pas » lorsque les dossiers sont imbriqués un niveau trop profond.

Sous Windows, le chemin mod par défaut est :

C:Users<YourUsername>AppDataLocalLowF2GamesGoreBoxMods

Remplacez <YourUsername> par le nom de votre compte Windows. Le dossier AppData est masqué par défaut — collez le chemin dans la barre d'adresse de l'Explorateur de fichiers ou activez « Éléments masqués » dans l'onglet Affichage. Chaque addon doit être son propre sous-dossier dans Mods contenant les scripts d'entrée Lua, fichiers manifest et bundles d'assets selon la structure définie sur gorebox-modding.github.io. Notre guide modding Lua détaille les fichiers requis.

Téléchargez ou extrayez le zip de l'addon depuis mod.io, Discord ou votre propre pipeline d'export MAPCG. Créez un nouveau dossier dans Mods nommé d'après l'addon — par exemple MyCustomGoreDolls. Copiez tous les fichiers extraits dans ce dossier sans couche de répertoire imbriquée supplémentaire. Une erreur courante consiste à placer les fichiers dans ModsMyAddonMyAddon, ce qui casse les chemins de chargement.

Lancez GoreBox, activez le mode Créateur depuis le menu avant de charger une carte, et vérifiez que l'addon a chargé via les nouvelles catégories du menu spawn ou les logs développeur /openConsole. Si rien n'apparaît, recoupez les points d'entrée script avec l'API actuelle — les chemins require obsolètes échouent silencieusement sur les anciens packs communautaires. Comparez avec les exemples fonctionnels de notre guide Workshop et le tutoriel mod.io.

Lors du test d'addons cartes, chargez-les depuis l'écran de sélection de carte après avoir confirmé que l'addon enregistre des entrées MAPCG custom. Suivez les workflows de portage de notre guide portage de cartes custom si vous importez des formats legacy.

Les builds Steam Deck et Linux desktop reproduisent la même structure de dossier F2Games sous le chemin de données persistantes Unity. Typiquement :

~/.config/unity3d/F2Games/GoreBox/Mods sous Linux, ou l'équivalent sous ~/.local/share selon votre build Proton ou native — vérifiez en recherchant un fichier de config GoreBox existant après avoir lancé le jeu une fois.

macOS stocke le chemin sous :

~/Library/Application Support/F2Games/GoreBox/Mods

Les étapes d'installation correspondent à Windows : un sous-dossier par addon, structure de fichiers plate, redémarrage du jeu. Les utilisateurs Proton sur Steam Deck doivent quitter complètement le jeu avant de copier les fichiers pour que les caches filesystem Linux se rafraîchissent. Associez les installs manuelles au noclip mode Créateur de notre page contrôles mode Créateur pour repérer rapidement les cartes de test.

Sauvegardez votre dossier Mods avant des expériences en masse — les accidents de symlink et les éditions de script inachevées se revertissent plus facilement avec une archive zip.

Steam Cloud ne synchronise pas le dossier Mods — traitez les copies locales comme faisant autorité et retéléchargez depuis mod.io lors de la reconstruction d'une install PC fraîche. Gardez un manifeste texte listant les noms d'addons abonnés pour vous réabonner en lot après une réinstallation OS sans deviner depuis des menus spawn vides.

Si un addon échoue après un patch GoreBox, supprimez son dossier de Mods et réabonnez-vous via mod.io pour récupérer une build à jour. Les anciens fichiers DLL ou Lua des ères pré-v16 ne doivent jamais se mélanger avec les scripts API v16 — ils font crasher le pipeline de chargement ou font apparaître des entités invisibles. Utilisez /openConsole après avoir activé le mode Créateur ; les chaînes d'erreur citent généralement les numéros de ligne dans votre fichier d'entrée Lua.

Des conflits surviennent lorsque deux addons enregistrent le même ID de spawn — désactivez un dossier en le renommant temporairement en dehors de Mods. Les passionnés de ligne de commande recoupent les permissions console sur notre liste toutes les commandes lorsque les addons exposent des commandes / custom.

Pour des tests de parité Android, copiez les builds stables vers le chemin appareil de notre guide d'installation Android via ADB ou stockage cloud — gardez les structures de dossiers PC et mobile identiques pour réduire la charge de support auteur.