Universal Modder installieren und nutzen

Voraussetzungen

Alle Voraussetzungen auf einmal installieren

winget install Git.Git Python.Python.3.12 astral-sh.uv Gyan.FFmpeg
winget install BlenderFoundation.Blender   # optional, für 3D → Sprites

brew install git python ffmpeg uv
brew install --cask blender                 # optional

sudo apt install git python3 python3-venv ffmpeg
curl -LsSf https://astral.sh/uv/install.sh | sh

Windows, macOS und Linux: was wo funktioniert

Der Großteil des Toolkits ist plattformübergreifend. Der Teil, der ein laufendes Spiel steuert (starten, Screenshot, Eingabe, Fensteraufnahme nur mit Spielton), ist auf Windows ausgerichtet, weil dort die Spiele sind. Agents können Windows-Spiele nativ oder aus WSL2 heraus steuern.

Unter macOS und Linux kann der Agent trotzdem im Spiel testen, mit den Aufnahmewerkzeugen des Systems (screencapture, ffmpeg, xdotool), aber nichts davon ist vorkonfiguriert. Field Notes wie xEdit unter Linux oder HL2 unter Wine auf macOS zeigen, dass es geht.

Installation je Agent im Vergleich

Jeder Weg installiert dieselben Skills (im Format Agent Skills), den fal-MCP-Server und die um-CLI.

Claude Code

In einer Claude-Code-Sitzung ausführen (nicht in deiner Shell):

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

Wähle User Scope, damit es in jedem Ordner verfügbar ist, und führe bei Aufforderung /reload-plugins aus. Die ausführliche Anleitung, inklusive Claude Desktop und wie du jeden Skill aufrufst, steht auf der Seite Universal Modder + Claude Code.

OpenAI Codex

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

Codex liest die Skills aus .agents/skills und die MCP-Konfiguration aus .codex/config.toml.

Gemini CLI

gemini extensions install https://github.com/rehan-remade/universal-modder

Das Manifest der Erweiterung ist gemini-extension.json; die Anweisungen kommen aus GEMINI.md, das auf AGENTS.md verweist.

VS Code mit GitHub Copilot

1. Öffne die Einstellungen und aktiviere chat.plugins.enabled.
2. Öffne die Befehlspalette und führe Chat: Install Plugin From Source aus.
3. Füge https://github.com/rehan-remade/universal-modder ein.

Die MCP-Konfiguration liegt in .vscode/mcp.json.

Cursor

Installiere es aus dem Cursor Marketplace oder klone das Repo und öffne es: Cursor liest AGENTS.md und .cursor/mcp.json automatisch.

OpenCode

git clone https://github.com/rehan-remade/universal-modder
cd universal-modder
opencode

opencode.json bindet die Skills und den fal-MCP-Server ein.

Jeder andere Agent

# nur die Skills, in den Skills-Ordner deines Agents
npx skills add https://github.com/rehan-remade/universal-modder

# oder alles: den Agent im Klon starten
git clone https://github.com/rehan-remade/universal-modder

Die um-CLI separat installieren

Plugin-Installationen und Klone legen um bereits in den PATH. Wenn du die Skills woanders nutzt oder um in einem normalen Terminal haben willst, installiere es als Tool. Es wird von GitHub installiert; auf PyPI gibt es das Paket nicht, pip install universal-modder funktioniert also nicht.

uv tool install git+https://github.com/rehan-remade/universal-modder
# oder
pipx install git+https://github.com/rehan-remade/universal-modder

Jede Befehlsgruppe hat --help mit Beispielen. Siehe die um-CLI-Referenz.

Deinen fal-API-Schlüssel setzen

Hol dir einen Schlüssel unter fal.ai/dashboard/keys (du musst Guthaben aufladen; der Schlüssel wird nur einmal angezeigt, also speichere ihn). Er versorgt sowohl den fal-MCP-Server als auch um fal.

export FAL_KEY="dein-schluessel"
# dauerhaft setzen
echo 'export FAL_KEY="dein-schluessel"' >> ~/.zshrc   # oder ~/.bashrc

setx FAL_KEY "dein-schluessel"
# dann ein neues Terminal öffnen und den Agent neu starten

Kein Schlüssel? um comfy erzeugt Bilder stattdessen mit einem lokalen ComfyUI-Server. Audio, 3D und Video brauchen weiterhin fal. Die Preise stehen auf der Kostenseite.

Installation prüfen

um --help
um kb search "terraria"       # frühere Field Notes (funktioniert auch außerhalb des Repos)
um scan --list                # auf diesem Rechner gefundene Spiele
um fal price fal-ai/trellis-2 # bestätigt, dass FAL_KEY funktioniert

Deine erste Sitzung: eine kleine, umkehrbare Änderung

1. Ein einfaches Spiel wählenSpiele mit einem verbreiteten Loader sind der sanfteste Einstieg: Terraria (tModLoader), Stardew Valley (SMAPI), Minecraft (Fabric/Forge), Unity-Spiele mit BepInEx, Unreal-Spiele mit UE4SS. Zur Spielebibliothek.
2. Zuerst nach einer Erkundung fragen
   PromptKopieren

   Welche Engine hat meine Terraria-Version, hat es schon mal jemand gemoddet (durchsuche die Wissensdatenbank), und welche Route würdest du nehmen? Ändere noch nichts.

3. Backup und Labor einrichten lassenDer Agent sichert die Spielstände mit um backup create, nutzt ein separates Profil oder eine eigene Welt und fragt, bevor er einen Loader installiert.
4. Ein Stück bauen
   PromptKopieren

   Füge einen Bumerang hinzu, der viermal zwischen Gegnern hin- und herspringt, bevor er zurückkommt. Zuerst ein Platzhalter-Sprite, dann ein fal-Sprite, sobald es im Spiel funktioniert.

5. Prüfen, dann erweiternStarte das Spiel, schau es dir an und bitte erst dann um mehr. Lange Projekte leben in MODLOG.md; sag einer neuen Sitzung „Lies MODLOG.md und mach weiter“.

Fehlerbehebung

Marketplace hinzufügen scheitert mit einem Git-/SSH-Fehler

Plugin-Marketplaces werden mit Git geklont. Wenn dein Rechner keinen SSH-Schlüssel für GitHub hat, sag Git, dass es für GitHub HTTPS verwenden soll:

git config --global url."https://github.com/".insteadOf [email protected]:

Skills tauchen nach der Installation nicht auf

Führe /reload-plugins aus (Claude Code) oder starte den Agent neu. Prüfe in /plugin, ob das Plugin aktiviert ist.

um: command not found

Öffne nach der Plugin-Installation ein neues Terminal oder installiere die CLI wie oben mit uv tool install und stell sicher, dass ~/.local/bin im PATH ist (uv tool update-shell).

um fal meldet, dass der Schlüssel fehlt

FAL_KEY muss in der Umgebung gesetzt sein, aus der der Agent gestartet wurde. Starte den Agent nach setx oder nach dem Bearbeiten deines Shell-Profils neu.

um win verweigert den Start

Es steuert nur Windows-Spiele, aus Windows oder WSL2. Unter macOS/Linux testest du im Spiel von Hand.