Universal Modder ist eine quelloffene Werkzeugsammlung, mit der KI-Coding-Agenten Mods für PC-Spiele untersuchen, entwickeln und testen können. Sie verbindet Skills, das Python-Kommandozeilenwerkzeug um, Erfahrungsnotizen zu einzelnen Spielen und eine fal-Anbindung zur Erzeugung von Assets. Ausgangspunkt ist das Originalprojekt rehan-remade/universal-modder auf GitHub (Englisch).

Beginne mit einer kleinen Änderung an einem Spiel, das du besitzt: Engine und Mod-Loader bestimmen, einen Testspielstand sichern, die Funktion mit Platzhaltergrafik bauen und anschließend im laufenden Spiel prüfen. „Universal“ beschreibt den breiten Ansatz. Es ist keine Zusage, dass jedes Spiel in jeder Version funktioniert.

Quellen geprüft am 9. Oktober 2026 anhand von Commit 8370faa und Paketversion 0.2.0. Dieser Leitfaden beruht auf Dokumentation und Quellcode. Wir haben weder die Beispiel-Mods ausgeführt noch einen vollständigen Ablauf über OmniaKey getestet. Die externen Quellen sind auf Englisch.

Was gehört zu Universal Modder?

Die README des Projekts unterscheidet mehrere Bausteine:

Baustein	Aufgabe	Was zusätzlich nötig ist
Agent-Skills	Recherche, Umsetzung, Asset-Aufbereitung und Tests anleiten	Ein Coding-Agent mit funktionierendem Modellzugang
`um`-CLI	Installationen untersuchen, Sprites bearbeiten, Spielstände sichern und Aufnahmen unterstützen	Passende lokale Abhängigkeiten und Spielewerkzeuge
Gemeinsame Wissensbasis	Versionen, Lösungswege und Fehlschläge früherer Projekte dokumentieren	Prüfung mit deiner installierten Spielversion
fal-Anbindung	Bilder, 3D-Assets, Audio oder Video erzeugen lassen	Eigener fal-Schlüssel und Nutzungsbudget

Das Repository nennt Installationswege für Claude Code, Codex, Cursor, Gemini CLI, Copilot und OpenCode. Diese betreffen die Agenten-Anbindung. Sie garantieren keine identischen Spielfunktionen auf allen Betriebssystemen. Die Werkzeuge zur Steuerung von Windows-Spielen richten sich an Windows direkt oder an die Nutzung über WSL.

In Claude Code installieren

Die README nennt Git, Python ab 3.10 und ffmpeg als Voraussetzungen und empfiehlt uv. Für das Rendern von 3D-Modellen in Sprites kommt Blender hinzu. Bereite die Werkzeuge vor, die dein Vorhaben benötigt.

Gib in Claude Code nacheinander Folgendes ein:

text

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

Das sind Plugin-Befehle für Claude Code, keine Shell-Befehle. Prüfe vor dem Aktivieren den Quellcode und die angeforderten Berechtigungen. Bei einem anderen Agenten gilt dessen Anleitung in der Original-README.

Das Projekt liefert für Plugins und geklonte Repositories einen CLI-Starter mit. Findet ein separates Terminal um nicht, ist die dokumentierte eigenständige Installation:

bash

uv tool install git+https://github.com/rehan-remade/universal-modder
um --help

Damit installierst du die CLI aus dem Repository. Ein Coding-Agent oder fal-Konto wird dadurch nicht automatisch eingerichtet. Wir haben die Befehle mit den Quellen abgeglichen, sie für diesen Artikel aber nicht ausgeführt.

Das Spiel zuerst untersuchen

Ersetze Terraria durch deinen Spielnamen oder Installationsordner:

bash

um scan --list
um kb search "Terraria"
um scan "Terraria" --json

Laut Rechercheleitfaden liest der Scanner Dateien und meldet Engine-Merkmale, installierte Loader, Speicherorte und mögliche Vorgehensweisen. Fehlt das Spiel in der Bibliotheksliste, kannst du den Ordner direkt angeben.

Ein Scan liefert Anhaltspunkte für die Planung, keinen Sicherheits- oder Kompatibilitätsnachweis. Schutzsoftware kann außerhalb des Spielordners liegen; Launcher können die Engine-Erkennung verfälschen. Prüfe deshalb auch die aktuelle Dokumentation des Community-Loaders und die Mod-Richtlinien des Spiels.

Lass Spiel- und Loader-Version, Speicher- und Logpfade, geplante Änderungen und Wiederherstellung in MODDING_PLAN.md festhalten. Fortschritte gehören in MODLOG.md. Wenn ein etablierter Loader oder eine offizielle Mod-Schnittstelle ausreicht, sollte sie Vorrang haben.

Ein erster Auftrag mit klaren Erfolgskriterien

Wähle eine kleine, sichtbare Funktion. Dieser Prompt ist unsere Vorlage, kein getesteter Mod:

Plane in meiner lokalen Terraria-Testumgebung einen neuen dekorativen Gegenstand für die installierte tModLoader-Version. Prüfe zuerst Spiel und Loader. Nutze Platzhaltergrafik und eine entbehrliche Testwelt. Liste vor Änderungen die betroffenen Pfade sowie Sicherungs- und Wiederherstellungsschritte auf. Zeige, wie ich den Gegenstand erhalte, ihn im Spiel prüfe und den Mod wieder entferne. Frage vor kostenpflichtiger Asset-Erzeugung oder einer Veröffentlichung nach.

Der Projektablauf sieht vor, zunächst eine kleine Funktion mit Platzhaltern fertigzustellen. Daraus lassen sich fünf Prüfungen ableiten:

Laden: Das Spiel startet mit dem vorgesehenen Loader; der Mod erscheint im Log.
Sichtbarkeit: Gegenstand oder Änderung erscheinen in der vorgesehenen Testszene.
Verhalten: Die Funktion erfüllt den Auftrag, statt lediglich fehlerfrei zu kompilieren.
Speichern: Speichern und erneutes Laden der Testwelt funktionieren wie erwartet.
Rückkehr: Nach Deaktivierung und Wiederherstellung entspricht die Testumgebung dem erwarteten Zustand.

Erst danach lohnt sich die Arbeit an endgültigen Sprites, Ton und Präsentationsvideo. Ein erzeugtes Bild oder ein erfolgreicher Build allein belegt keine Kompatibilität im Spiel.

Für welche Spiele gibt es Beispiele?

Die Beispiele sind Ausgangspunkte mit konkreten Versionsgrenzen. Die Angaben der Autoren ersetzen deinen eigenen Test nicht.

Terraria / tModLoader: Fal Arsenal geht laut Dokumentation auf ein Einzelspielerprojekt mit Terraria 1.4.4 und tModLoader 2026.07 zurück. Multiplayer ist ausdrücklich ungetestet. Verwende eine separate Welt.
Age of Empires II DE: Das Zivilisationsbeispiel enthält erzeugte Grafiken und Sprite-Konvertierung. Es ersetzt einen vorhandenen Zivilisationsplatz und belegt nicht, dass beliebig neue Plätze möglich sind.
Minecraft × GTA V: Zwei laufende Spiele werden im Story-Modus von GTA V verbunden. Dokumentiert ist ein Test mit GTA V Legacy auf Steam, Build 3889. Daraus folgt keine Unterstützung für GTA Online oder andere Editionen.

Prüfe die Belege in dieser Reihenfolge: Engine-Leitfaden → dokumentiertes Spiel samt Version → eigener Test im Spiel. Ein Unity- oder Unreal-Leitfaden ist kein Nachweis für jedes Spiel dieser Engine.

Ist es kostenlos, und brauchst du fal?

Der Quellcode steht unter der MIT-Lizenz. Für ein vollständiges Projekt kommen dennoch drei Kostenbereiche infrage: Coding-Modell, Asset-Erzeugung sowie lokale Hardware und Werkzeuge für Build und Test.

fal hat eigene Modellpreise, abhängig von Modell und Einstellungen. Die Authentifizierungsdokumentation verwendet FAL_KEY. Hinterlege den echten Schlüssel vertraulich in der Umgebung, aus der du den Agenten startest. Die folgenden Werte sind Platzhalter.

Für Bash oder Zsh:

bash

export FAL_KEY="YOUR_FAL_API_KEY"

Für Windows PowerShell:

powershell

$env:FAL_KEY = "YOUR_FAL_API_KEY"

Ein Schlüssel für das Coding-Modell, auch von OmniaKey, ist kein fal-Schlüssel. Die Plugin-Installation verbindet die Abrechnungen nicht. Prüfe vor einer Serie den Asset-Modelltyp und die Anzahl der Generierungen. Schlüssel gehören weder in Mod-Dateien noch in veröffentlichte Archive.

Du kannst mit Platzhaltern oder eigener Grafik beginnen. Der Asset-Leitfaden beschreibt außerdem um comfy für Bilder von einem lokalen ComfyUI-Server ohne fal-Schlüssel. Die mitgelieferten Bildrezepte ersetzen nicht sämtliche Audio-, 3D- und Videoabläufe von fal. Lokale Hardware und Modelle musst du selbst einrichten.

Fehler gezielt eingrenzen

Ändere immer nur eine Ebene:

um fehlt: Prüfe PATH und eigenständige CLI-Installation, bevor du am Loader suchst.
Spiel nicht erkannt: Übergib den Installationsordner und gleiche das Ergebnis mit aktuellen Community-Unterlagen ab.
fal-Authentifizierung scheitert: Prüfe, ob der Agent-Prozess FAL_KEY für das richtige Konto erhalten hat. Ein erfolgreicher Agent-Login sagt darüber nichts aus.
Build erfolgreich, Mod fehlt: Prüfe Spiel- und Loader-Version, Installationspfad und Loader-Log vor einer erneuten Asset-Erzeugung.
Grafik sieht falsch aus: Vergleiche Größe, Transparenz, Frame-Anordnung und Ausrichtung mit den Spielanforderungen, bevor du den Bildprompt änderst.

Halte das Fehlerprotokoll und die kleinste reproduzierbare Situation fest. So hat der nächste Versuch eine konkrete Prüfgrundlage.

Online spielen und Mods veröffentlichen

Beachte die Projektregeln: eigene Spiele, bevorzugt Offline-Tests oder erlaubte Umgebungen unter deiner Kontrolle, keine Umgehung von Anti-Cheat, DRM oder Eigentumsprüfungen. Das Projekt untersagt Eingriffe durch Code-Injektion in geschützte Online-Clients. Ein privater Server hebt Client-Schutz und Vorgaben des Publishers nicht auf.

Prüfe vor einer Veröffentlichung Spielbedingungen sowie Asset- und Werkzeuglizenzen. Die MIT-Lizenz der Werkzeugsammlung erlaubt nicht automatisch die Weitergabe von Spieldateien, extrahierten Assets oder dekompiliertem Quellcode. Liefere deine eigene Arbeit mit Installationsanleitung, getesteten Versionen und Entfernungsschritten aus.

Für den Modellzugang findest du weitere Schritte im Claude-Code-Verbindungsleitfaden und im aktuellen OmniaKey-Preiskatalog. Richte diese Verbindung getrennt von fal ein und prüfe den Mod-Ablauf anschließend in deiner Umgebung.

Universal Modder einrichten