Modding Lua GoreBox

Les addons GoreBox v16 sont des scripts Lua exécutés dans le runtime sandbox du jeu — pas des injections DLL legacy ou des packs hack non supportés pré-v16. F²Games publie l'API GoreBox Modding officielle documentant l'enregistrement de spawn, les hooks d'entrée, la manipulation d'entités et les règles de packaging Workshop. La documentation canonique vit sur gorebox-modding.github.io — ajoutez-la aux favoris aux côtés des bases console de ce wiki et de notre outil Command Lookup lors de la construction de votre premier addon.

Les addons Lua chargent depuis le dossier Mods sur PC à AppData/LocalLow/F2Games/GoreBox/Mods ou depuis les abonnements mod.io synchronisés automatiquement. Chaque addon expose un script d'entrée exécuté au chargement de carte. Les auteurs enregistrent des entités custom — GoreDolls, armes, props — qui apparaissent dans les menus spawn lorsque l'enregistrement réussit. Les scripts échoués loguent des erreurs visibles via /openConsole après activation du mode Créateur depuis notre guide mode Créateur.

Démarrez un nouveau dossier addon avec un nom clair correspondant à votre fiche mod.io. Incluez le fichier Lua d'entrée défini dans le template officiel — enregistrant typiquement des callbacks pour les événements de jeu tels que chargement de carte, spawn joueur et mises à jour tick. Les fichiers assets — textures, audio, bundles mesh — se placent à côté des scripts dans des sous-dossiers prévisibles documentés sur gorebox-modding.github.io.

Utilisez les fonctions d'enregistrement de spawn de l'API pour ajouter GoreDolls et armes sans écraser les IDs vanilla — les IDs dupliqués entrent en conflit avec d'autres addons abonnés de notre écosystème Workshop. Accrochez l'entrée joueur avec parcimonie ; les builds mobile exposent des événements tactiles différents des scans clavier PC. Testez cross-plateforme si vous prévoyez de publier des fiches compatibles Android sur mod.io.

Référencez le comportement vanilla depuis les catalogues wiki — GoreDolls, armes et véhicules — lorsque vous reproduisez les stats officielles dans des entités custom. Les interactions Reality Crusher peuvent nécessiter un traitement spécial documenté dans les sections API avancées.

Activez le mode Créateur, copiez votre dossier work-in-progress dans le répertoire Mods en suivant notre guide d'installation PC, et lancez une carte légère comme Legacy. Ouvrez /openConsole immédiatement pour attraper les exceptions au chargement — les stack traces citent les numéros de ligne dans votre script d'entrée. Itérez rapidement en éditant Lua dans VS Code ou Cursor, en sauvegardant et en relançant la carte sans redémarrage complet du jeu lorsque c'est possible.

Utilisez /navgenerate après avoir fait apparaître des props statiques custom pour que les PNJ GoreDoll pathfind sur la géométrie addon — voir toutes les commandes. Enregistrez des clips de reproduction avec les commandes motion de notre guide enregistrement de mouvement lors du signalement de bugs à F²Games ou aux auteurs mod.io.

Le test Android exige un déploiement ZArchiver depuis notre page d'installation Android — ne supposez jamais qu'un succès PC-only implique la compatibilité mobile.

Lorsque votre addon passe les tests locaux, packagez le dossier selon la checklist de publication gorebox-modding.github.io — métadonnées manifest, images d'aperçu et tags plateforme. Uploadez via le portail développeur mod.io lié depuis les ressources communautaires F²Games. Rédigez des descriptions claires listant les dépendances, exigences mode Créateur, et si votre script ajoute des commandes / custom documentées pour les joueurs sur notre page commandes hôte et créateur.

Mettez à jour les fiches rapidement après les patches GoreBox qui cassent des zones de surface API — les abonnés reçoivent des notifications lorsque vous poussez de nouvelles versions. Associez les sorties à des vidéos tutoriel sur notre guide GoreDolls custom ou nos bases éditeur de cartes lorsque votre addon cible ces workflows.

Rejoignez les serveurs Discord communautaires où les modérateurs F²Games partagent les notes de changement API plus vite que les mises à jour wiki pendant les cycles de patch rapides. Respectez les licences d'assets lors du bundling de textures tierces — les retraits DMCA sur mod.io nuisent à tout l'écosystème.

Versionnez les noms de dossiers addon en développement — ajoutez des suffixes _v1, _v2 dans les copies de test locales pour ne jamais confondre quelle build a produit une capture de bug report. Le versionnement sémantique dans les notes de release mod.io aide les joueurs à savoir quand des changements API breaking exigent de se réabonner après un patch majeur GoreBox.