⚔️ GORE

GORE (Go-thic Re-make) is a vibe-coded modding and save-editing toolsuite for Gothic 1 Remake. One Rust engine, one CLI, and three Windows apps built on top of it.

🧰 Tools

Tool	What it does	Status
CLI	All modding from the terminal: item values, text and dialogs, audio, voice, textures, DataAssets, scripts. Start here.	⚗️ Experimental use
Mod Studio	No-code Windows GUI over the same engine, for authoring one mod.	🚧 Work in progress
Mod Manager	Windows GUI for installing and ordering many mods together.	🚧 Work in progress
Save Editor	Windows GUI for editing your save files. Never touches the game install.	✅ Ready to use
gore-lua	Small Lua helper library that ships into the game, for hand-written UE4SS mods.	🚧 Work in progress
Assistant plugin	The MCP server and the modding skill, installed into Claude Code, Codex or Cursor in one step.	⚗️ Experimental use

The Flutter GUIs reuse the exact same Rust crates as the CLI through a dart:ffi bridge — the CLI is always the most complete surface.

📊 Status

Area	Status	What you can do	The catch
Item & stat values	Full	Change what items are worth, what weapons do, what NPCs have	Needs UE4SS, which GORE does not install
Text & dialogs	Full	Replace any text in the game, in any of its 19 languages	An id can carry several language versions and the game shows the newest
Audio	Full	Replace music and sound effects	Finding which sound plays where is guesswork
Voice-over	Partly	Replace spoken lines	You can add audio for a brand-new line, but nobody has heard one play yet
Textures	Full	Replace textures	A few, like the mouse cursors, are stored somewhere this cannot reach
DataAssets	Partly	Edit cooked game data	Only assets the engine describes natively; Blueprint ones are refused
Scripts	Partly	Read the game's script code, change it, add your own	Reverse-engineered and lossy — recompiled code is not always identical
Mods & load order	Full	Ship all of the above as one mod, run many together, and install mods that GORE did not build — plain zips, pak files, UE4SS mod folders	Nobody else's mod has been through it: the one end-to-end test used a file GORE made itself

GORE will not edit your saves — that is the Save Editor — and everything above was seen by one person, on one install.

🚀 Quick start

Get gore.exe from a gore-cli-v* release, or build it:

cargo build --release -p gore     # → target\release\gore.exe

Point it at your game once:

$GAME = 'D:\SteamLibrary\steamapps\common\Gothic 1 Remake'
gore config set game-path $GAME     # or: gore config detect

Check what you have before you rely on it:

gore doctor

It answers whether that path really is the game, whether UE4SS is there, what is deployed, and what an interrupted run left behind. Every line that is not ok carries a fix: line. Worth running now: the mod below is a UE4SS mod, and without UE4SS it installs cleanly and then does nothing at all.

Then make apples worth 500 gold. Save this as overrides.toml:

[meta]
name = "MyBalanceMod"

[[override]]
class = "ItFo_Apple"
field = "m_Value"
value_int = 500

gore gen overrides.toml -o "$GAME\G1R\Binaries\Win64\ue4ss\Mods"

Full walkthrough: Getting started.

🤖 Vibe Modding

You can mod with AI agents by installing the plugin, or by manually installing the skill and mcp tools.

Claude plugin

claude plugin marketplace add dh0er/gore
claude plugin install gore@gore

Codex plugin

codex plugin marketplace add C:\path\to\gore
codex plugin add gore@gore

Manual installation (all clients)

Add the MCP server to the client configuration:

{
  "mcpServers": {
    "gore": {
      "command": "gore",
      "args": ["mcp", "serve"]
    }
  }
}

Link the gore-modding skill from a checkout into the agent's personal skills directory:

New-Item -ItemType Junction `
  -Path <agent-skills-directory>\gore-modding `
  -Target C:\path\to\gore\plugins\gore\skills\gore-modding

gore.exe must be on PATH; check with gore --version.

For unattended use, add --allow-write and/or --allow-game-launch to gore mcp serve to pre-approve writes or game launches. Compiling requires both.

📚 Documentation

Everything lives in docs/.

🏁 Getting started	Install, configure, first mod, which tool for which job
🍎 Item & stat values	overrides.toml → UE4SS Lua CDO override mod
💬 Text & dialogs	Decrypt, edit, re-encrypt the localization .lcache
🔊 Audio · 🎙️ Voice-over	FMOD bank samples; voice-over ZIP archives
🖼️ Textures · 📦 DataAssets	Additive UE5 IoStore Zen triplets
📜 Scripts	Decompile, recompile, and splice the AngelScript cache
📦 Bundling & deploying	One spec → one mod that deploys as a unit
🧩 Running many mods	gore mgr: library, load order, conflicts
⌨️ CLI reference	Every command, subcommand, and flag
🤖 AI assistants	Install the plugin, or wire the MCP server up by hand; what gets confirmed with you
🖥️ Mod Studio	The no-code GUI: NPCs, quests, voice, project backups
🔧 Building	Toolchain, build.py, repo layout, crates, versioning

The CLI release zip carries the same guide offline: docs\guide.html is one browsable file with a collapsible sidebar, and docs\*.md is the same content in Markdown, for grep. The MCP server answers from its own copy, compiled into gore.exe, so editing those files changes what you read and not what an assistant is told. Regenerate the HTML any time with gore guide html.

Implementation contracts behind the commands — receipt semantics, seal guarantees, why a patch is refused — live separately in docs/reference/. They are not part of the guide.

🔨 Build

Requires Windows 10+, a stable Rust toolchain, Python 3, Visual Studio 2022 with "Desktop development with C++", and — for the GUI apps — Flutter with Windows desktop support.

cargo build
cargo test

Shippable products are driven by the top-level orchestrator. Registered projects: gore-cli, gore-save-editor, gore-mod-studio, gore-mod-manager. A project name is also its release-tag prefix and its artifact name.

python build.py <project> build|run|dist|installer|test
python build.py all test

Release tags and manual smoke builds run the same CI quality gates on the exact commit before any product build.

Details, repo layout, and the crate table: Building.

📄 License

MIT. See LICENSE.