GoreBox Lua Modding

GoreBox-v16-Addons sind Lua-Skripte, die in der Sandbox-Runtime des Spiels laufen — keine Legacy-DLL-Injectionen oder unsupported Pre-v16-Hack-Packs. F²Games veröffentlicht die offizielle GoreBox Modding API mit Dokumentation zu Spawn-Registrierung, Input-Hooks, Entitätsmanipulation und Workshop-Packaging-Regeln. Die kanonische Dokumentation liegt auf gorebox-modding.github.io — bookmarken Sie sie neben den Konsolen-Grundlagen und dem Command Lookup-Tool dieses Wikis, wenn Sie Ihr erstes Addon bauen.

Lua-Addons laden aus dem Mods-Ordner auf dem PC unter AppData/LocalLow/F2Games/GoreBox/Mods oder aus mod.io-Abonnements, die automatisch synchronisiert werden. Jedes Addon stellt ein Einstiegsskript bereit, das beim Kartenladen ausgeführt wird. Autoren registrieren Custom-Entitäten — GoreDolls, Waffen, Props — die in Spawn-Menüs erscheinen, wenn die Registrierung gelingt. Fehlgeschlagene Skripte loggen Fehler, sichtbar über /openConsole nach Aktivierung von Creator Mode aus unserem Creator Mode-Guide.

Starten Sie einen neuen Addon-Ordner mit einem klaren Namen, passend zu Ihrer mod.io-Listung. Fügen Sie die Einstiegs-Lua-Datei aus der offiziellen Vorlage ein — typischerweise mit Registrierung von Callbacks für Spielevents wie Kartenladen, Spieler-Spawn und Tick-Updates. Asset-Dateien — Texturen, Audio, Mesh-Bundles — liegen neben Skripten in vorhersehbaren Unterordnern, dokumentiert auf gorebox-modding.github.io.

Nutzen Sie die Spawn-Registrierungsfunktionen der API, um GoreDolls und Waffen hinzuzufügen, ohne Vanilla-IDs zu überschreiben — doppelte IDs kollidieren mit anderen abonnierten Addons aus unserem Workshop-Ökosystem. Hooken Sie Spielereingabe sparsam; Mobile-Builds exponieren andere Touch-Events als PC-Tastatur-Scans. Testen Sie plattformübergreifend, wenn Sie Android-kompatible Listungen auf mod.io veröffentlichen wollen.

Referenzieren Sie Vanilla-Verhalten aus Wiki-Katalogen — GoreDolls, Waffen und Fahrzeuge — wenn Sie offizielle Stats in Custom-Entitäten spiegeln. Reality Crusher-Interaktionen können Spezialbehandlung in fortgeschrittenen API-Abschnitten erfordern.

Aktivieren Sie Creator Mode, kopieren Sie Ihren Work-in-Progress-Ordner in das Mods-Verzeichnis gemäß unserer PC-Installationsanleitung und starten Sie eine leichte Karte wie Legacy. Öffnen Sie /openConsole sofort, um Ladefehler zu fangen — Stack Traces zitieren Zeilennummern in Ihrem Einstiegsskript. Iterieren Sie schnell, indem Sie Lua in VS Code oder Cursor bearbeiten, speichern und die Karte neu starten, ohne vollständigen Spiel-Neustart, wenn möglich.

Nutzen Sie /navgenerate nach dem Spawnen von Custom-Static-Props, damit GoreDoll-NPCs auf Addon-Geometrie pathen — siehe Alle Befehle. Nehmen Sie Reproduktions-Clips mit Motion-Befehlen aus unserem Motion-Recording-Guide auf, wenn Sie Bugs an F²Games oder mod.io-Autoren melden.

Android-Tests erfordern ZArchiver-Deployment von unserer Android-Installationsseite — nehmen Sie niemals an, dass PC-only-Erfolg mobile Kompatibilität impliziert.

Wenn Ihr Addon lokale Tests besteht, paketieren Sie den Ordner gemäß der gorebox-modding.github.io-Publishing-Checkliste — Manifest-Metadaten, Vorschaubilder und Plattform-Tags. Laden Sie über das mod.io-Developer-Portal hoch, verlinkt aus F²Games-Community-Ressourcen. Schreiben Sie klare Beschreibungen mit Abhängigkeiten, Creator Mode-Anforderungen und ob Ihr Skript Custom-/-Befehle hinzufügt, dokumentiert für Spieler auf unserer Host- und Creator-Befehlsseite.

Aktualisieren Sie Listungen prompt nach GoreBox-Patches, die API-Oberflächen brechen — Abonnenten erhalten Benachrichtigungen, wenn Sie neue Versionen pushen. Kombinieren Sie Releases mit Tutorial-Videos in unserem Custom-GoreDolls-Guide oder den Map-Editor-Grundlagen, wenn Ihr Addon diese Workflows anspricht.

Treten Sie Community-Discord-Servern bei, wo F²Games-Moderatoren API-Änderungshinweise schneller teilen als Wiki-Updates während schneller Patch-Zyklen. Respektieren Sie Asset-Lizenzen beim Bündeln von Drittanbieter-Texturen — DMCA-Takedowns auf mod.io schaden dem gesamten Ökosystem.

Versionieren Sie Ihre Addon-Ordnernamen während der Entwicklung — hängen Sie _v1, _v2-Suffixe an lokale Testkopien an, damit Sie nie verwechseln, welcher Build einen Bug-Report-Screenshot erzeugte. Semantisches Versioning in mod.io-Release-Notes hilft Spielern zu wissen, wann Breaking-API-Änderungen nach einem GoreBox-Major-Patch erneutes Abonnieren erfordern.