GoreBox Mod-Installation auf dem PC

Während mod.io Workshop die meisten GoreBox-v16-Addon-Installationen automatisch übernimmt, bleibt manuelle Ordnerplatzierung essenziell für Lua-Entwickler, die unveröffentlichte Skripte testen, kaputte Sync-Zustände reparieren und Community-Zips außerhalb des Workshop-Browsers installieren. Jedes manuell installierte Addon liegt in einem dedizierten Mods-Verzeichnis, das GoreBox beim Start scannt. Diesen Pfad zu kennen verhindert die klassische „Mod lädt nicht"-Frustration, wenn Ordner eine Ebene zu tief verschachtelt sind.

Auf Windows ist der Standard-Mod-Pfad:

C:Users<YourUsername>AppDataLocalLowF2GamesGoreBoxMods

Ersetzen Sie <YourUsername> durch Ihren Windows-Kontonamen. Der AppData-Ordner ist standardmäßig ausgeblendet — fügen Sie den Pfad in die Adressleiste des Datei-Explorers ein oder aktivieren Sie „Ausgeblendete Elemente" im Ansicht-Tab. Jedes Addon sollte ein eigener Unterordner in Mods sein mit Lua-Einstiegsskripten, Manifest-Dateien und Asset-Bundles gemäß der Struktur auf gorebox-modding.github.io. Unser Lua-Modding-Guide führt durch die erforderlichen Dateien.

Laden Sie das Addon-Zip von mod.io, Discord oder Ihrer eigenen MAPCG-Export-Pipeline herunter oder entpacken Sie es. Erstellen Sie einen neuen Ordner in Mods, benannt nach dem Addon — zum Beispiel MyCustomGoreDolls. Kopieren Sie alle entpackten Dateien in diesen Ordner ohne zusätzliche verschachtelte Verzeichnisebene. Ein häufiger Fehler ist das Ablegen von Dateien in ModsMyAddonMyAddon, was Ladepfade bricht.

Starten Sie GoreBox, aktivieren Sie Creator Mode im Menü vor dem Laden einer Karte und prüfen Sie das geladene Addon über neue Spawn-Menü-Kategorien oder /openConsole-Developer-Logs. Wenn nichts erscheint, vergleichen Sie Skript-Einstiegspunkte mit der aktuellen API — veraltete require-Pfade schlagen bei älteren Community-Packs still fehl. Vergleichen Sie mit funktionierenden Beispielen aus unserem Workshop-Guide und dem mod.io-Tutorial.

Beim Testen von Karten-Addons laden Sie diese über den Karten-Auswahlbildschirm, nachdem Sie bestätigt haben, dass das Addon Custom-MAPCG-Einträge registriert. Port-Workflows aus unserem Guide zum Portieren von Custom Maps, wenn Sie Legacy-Formate importieren.

Steam Deck und Linux-Desktop-Builds spiegeln dieselbe F2Games-Ordnerstruktur unter dem Unity-Persistent-Data-Pfad. Typischerweise:

~/.config/unity3d/F2Games/GoreBox/Mods unter Linux, oder das Äquivalent unter ~/.local/share je nach Proton- oder Native-Build — verifizieren Sie, indem Sie nach einer existierenden GoreBox-Konfigurationsdatei suchen, nachdem Sie das Spiel einmal gestartet haben.

macOS speichert den Pfad unter:

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

Installationsschritte entsprechen Windows: ein Unterordner pro Addon, flache Dateistruktur, Spiel neu starten. Proton-Nutzer auf Steam Deck sollten das Spiel vollständig beenden, bevor sie Dateien kopieren, damit Linux-Dateisystem-Caches aktualisiert werden. Kombinieren Sie manuelle Installationen mit Creator Mode Noclip aus unserer Creator Mode-Steuerungsseite, um Testkarten schnell zu erkunden.

Sichern Sie Ihren Mods-Ordner vor Massenexperimenten — Symlink-Unfälle und halbfertige Skript-Edits lassen sich leichter mit einem Zip-Archiv rückgängig machen.

Steam Cloud synchronisiert den Mods-Ordner nicht — behandeln Sie lokale Kopien als maßgeblich und laden Sie von mod.io neu, wenn Sie eine frische PC-Installation aufbauen. Führen Sie ein Text-Manifest mit abonnierten Addon-Namen, damit Sie nach OS-Neuinstallationen batchweise neu abonnieren können, ohne aus leeren Spawn-Menüs zu raten.

Schlägt ein Addon nach einem GoreBox-Patch fehl, löschen Sie seinen Ordner aus Mods und abonnieren Sie über mod.io neu, um einen aktualisierten Build zu holen. Veraltete DLL- oder Lua-Dateien aus Pre-v16-Ären dürfen niemals mit v16-API-Skripten gemischt werden — sie crashen die Ladepipeline oder spawnen unsichtbare Entitäten. Nutzen Sie /openConsole nach Aktivierung von Creator Mode; Fehlerstrings zitieren meist Zeilennummern in Ihrer Lua-Einstiegsdatei.

Konflikte entstehen, wenn zwei Addons dieselbe Spawn-ID registrieren — deaktivieren Sie einen Ordner vorübergehend durch Umbenennen außerhalb von Mods. Command-Line-Enthusiasten gleichen Konsolenberechtigungen mit unserer Alle-Befehle-Liste ab, wenn Addons Custom-/-Befehle bereitstellen.

Für Android-Paritätstests kopieren Sie stabile Builds in den Gerätepfad unserer Android-Installationsanleitung per ADB oder Cloud-Speicher — halten Sie PC- und Mobile-Ordnerstrukturen identisch, um Autoren-Support-Aufwand zu reduzieren.