Universal Modder + Claude Code: die komplette Einrichtung

Warum Claude Code der Referenz-Agent ist

Der Autor des Projekts hat das Toolkit aus echten Claude-Code-Sitzungen gebaut, und das Repo bringt eine Claude-spezifische Verdrahtung mit: einen Plugin-Marketplace (.claude-plugin/), nach .claude/skills kopierte Skills, den fal-MCP-Server in .mcp.json und einen SessionStart-Hook, der die um-CLI bei jedem Start oder Fortsetzen einer Sitzung in den PATH legt. Andere Agents funktionieren auch (siehe die Installationsanleitung für alle Agents), aber Claude Code bekommt den am besten getesteten Weg.

1. Claude Code installieren

Überspringen, wenn claude --version schon funktioniert.

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

Leg dann einen Arbeitsordner für deine Mods an (zum Beispiel ~/mods oder C:\mods), starte darin claude und melde dich an. Du brauchst ein Claude-Pro-, Max-, Team- oder Enterprise-Abo oder ein Console-Konto mit API-Abrechnung. Wenn etwas komisch aussieht, führe claude doctor aus.

Installiere auch die Voraussetzungen des Toolkits: Git, Python 3.10+, ffmpeg und uv (Einzeiler zur Installation).

2. Das Universal-Modder-Plugin hinzufügen

/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modder

• Wähle User Scope, damit das Plugin in jedem Projektordner verfügbar ist.
• Führe /reload-plugins aus, wenn Claude Code danach fragt, oder starte die Sitzung neu.
• Lieber die Shell? Das Gleiche geht mit claude plugin marketplace add … und claude plugin install ….
• Ein SSH-Fehler? Siehe Fehlerbehebung.

Was das Plugin installiert

3. fal für Grafik, 3D und Audio verbinden

Der fal-MCP-Server liest FAL_KEY aus der Umgebung, in der Claude Code startet. Erstelle einen Schlüssel unter fal.ai/dashboard/keys, exportiere ihn und starte claude neu.

export FAL_KEY="dein-schluessel"     # macOS / Linux / WSL
setx FAL_KEY "dein-schluessel"       # Windows, dann ein neues Terminal öffnen

Prüfe es mit /mcp in Claude Code: Der Server fal sollte als verbunden angezeigt werden. Die Preise pro Asset stehen auf der Kostenseite.

Skills aufrufen

Einen Skill musst du selten beim Namen nennen: Eine Anfrage wie „Modde Stardew Valley so, dass…“ lädt mod-any-game, und der holt die anderen bei Bedarf dazu. Um einen bestimmten zu erzwingen, tippe seinen Slash-Befehl:

Was in jedem Skill steckt →

Prompts, die funktionieren

Gute Prompts nennen das Spiel, ein konkretes Ergebnis und woran man „fertig“ erkennt. Beispiele aus der README des Projekts:

Modde Terraria: Füge einen zielsuchenden Raketenwerfer und eine taktische Atombombe hinzu, die Krater in die Welt reißt. Mach die Sprites mit fal.

Bau eine neue Zivilisation für Age of Empires II mit einer Spezialeinheit, die aus 3D gerendert wird.

Bring echtes Minecraft in den Story-Modus von GTA V. Die Kamera von Minecraft soll der von GTA folgen, und sein TNT soll GTA-Autos in die Luft jagen.

Welche Engine hat C:\Games\Foo, und hat es schon mal jemand gemoddet?

Tipps, die Tokens und Geld sparen:

• Erst erkunden, dann bauen. Lass dir vor jeder Änderung den Plan geben; er landet in MODDING_PLAN.md.
• Ein Stück nach dem anderen. Eine funktionierende Waffe ist besser als zehn halb gebaute.
• Platzhalter vor fal. Finale Grafik erst erzeugen, wenn die Mechanik im Spiel funktioniert.
• Nach dem Preis fragen. „Prüf um fal price, bevor du das 3D-Modell generierst.“
• Finger weg während der Tests. Benutze den PC nicht, während der Agent das Spiel steuert oder aufnimmt.

Lange Projekte und Kontextgrenzen

Der Skill führt ein Journal in MODLOG.md (Pfade, IDs, Formate, was gescheitert ist, der nächste Schritt), damit nichts Wichtiges verloren geht, wenn Claude Code das Gespräch komprimiert. Eine neue Sitzung startest du mit:

Lies MODLOG.md und MODDING_PLAN.md und mach beim nächsten Schritt weiter.

Wenn der Mod funktioniert, bitte den Agent, mit dem Skill share-field-notes eine Field Note zu schreiben. Einen Pull Request an die gemeinsame Wissensdatenbank öffnet er erst nach deinem OK.

Was Claude Code damit gebaut hat

• Age of Empires II: Definitive Edition: San Franciscans: a new civilization for Age of Empires II DE with units rendered from 3D
• Baldur's Gate 3: Act 2 never loads (hang at 50% or crash): one modded NPC on a bad level layer, found by bisecting a pak
• Baldur's Gate 3: A generated wardrobe mod: 260 clothing mods sorted by race and body type into containers summoned by reusable scrolls
• Baldur's Gate 3: Custom outfits from cloned mod and vanilla meshes: visuals, materials, body masks, cloth, LODs, icons and the Blender GR2 round trip
• Baldur's Gate 3: Gameplay and compatibility patches in stats and Osiris: level-gated armour tiers, Extra Attack on a modded cantrip, crit immunity, stacking damage reduction, feats from items, removing equipment glow, a class vs starting-equipment fix
• Baldur's Gate 3: Running a 500+ mod load order by hand: modsettings.lsx rules, recovering a wiped order from a save, mod.io re-subscribes, game-folder files and conflict diagnosis
• Baldur's Gate 3: Weapons: porting a Skyrim dagger and scabbard, fixing a modded sword's sheath height with a Dummy_Sheath bone, and visible stowed shields for modded shields
• Borderlands 2: BL3 weapons and movement in Borderlands 2 (Willow2 SDK mods)
• Darkest Dungeon: A seeded randomizer (trinkets, heroes, monsters, curios, quirks, quests) as a Darkest Dungeon data mod
• Dragon's Dogma 2: Blink Strike teleports behind the target (REFramework Lua skill rework)
• Dragon's Dogma 2: Dimension Door: aimed teleport spell with a scripted arrival camera (REFramework Lua)
• Elden Ring: CS2 conversion of Elden Ring offline: native Rust DLL via me3 (fall death, spirit springs, 3D inspect, params)

Alle Spiele ansehen →