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
GORE 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.

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

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.