um scan
Installierte Spiele finden und eines analysieren: Engine, Skript-Laufzeit, Anti-Cheat, Mod-Loader, Spielstände. Nur lesend. Endet mit bewerteten Routen und dem Playbook, das zu lesen ist.
um scan --list # Steam / Epic / Xbox installs (Windows, WSL, Linux, macOS)
um scan terraria # fuzzy name or a path
um scan "C:\Games\Foo" --json # machine-readable, for agentsum fal
Spiel-Assets von fal über einfaches REST. Braucht FAL_KEY. Jeder Aufruf wird an ein Manifest angehängt, damit sich jedes Asset zurückverfolgen und neu erzeugen lässt.
um fal sprite "a rusty scrap drone enemy, side view, 16-bit pixel art" --name drone
um fal image "key art: ..." --aspect 16:9
um fal edit "same drone, second animation frame" --ref assets/gen/drone.png
um fal rmbg in.png # background removal
um fal pixelate in.png --colors 24
um fal texture "mossy cobblestone" # seamless tiling
um fal pbr "rusted sheet metal" # basecolor/normal/roughness/metalness/height
um fal model3d concept.png # image -> textured GLB (Trellis 2)
um fal rig character.glb --animate # auto-rig a humanoid
um fal sfx "laser rifle shot" --seconds 1.5
um fal music "tense boss battle, chiptune, 140 bpm" --seconds 60
um fal voice "You dare challenge the Mothership?" --voice-id Adam
um fal video still.png "camera orbits the boss"
um fal search "image to 3d" | um fal schema fal-ai/trellis-2 | um fal price fal-ai/trellis-2um comfy
Bilder von einem lokalen ComfyUI-Server: kein API-Schlüssel, deine eigene GPU. Führt jeden Workflow aus, der mit Export (API) exportiert wurde.
um comfy status
um comfy image "a red health potion" --sprite # plain background, then cut out
um comfy run my_workflow.json --set 6.text="a blue mana potion" --set 3.seed:=42um sprite
Macht aus generierter Grafik genau die Frames, die ein Spiel erwartet.
um sprite cutout in.png out.png # flat background -> transparent
um sprite fit in.png out.png --size 64x26 # trim + nearest-neighbour fit
um sprite pixelate in.png out.png --size 32x32 --colors 16 --outline
um sprite palette in.png out.png --from ref.png # snap to a game's palette
um sprite sheet out.png f1.png f2.png --cols 4
um sprite slice sheet.png outdir --frame 32x32
um sprite frames in.png outdir --n 3 --kind bob # quick idle animation
um sprite team-mask in.png out.png --hue blue # player-colour mask
um sprite seamless in.png out.pngum render3d
Rendert eine GLB-Datei mit Blender aus der Kamera eines Spiels in Sprite-Frames. Presets: aoe2 (16 Richtungen), iso8, trueiso, topdown, side, turntable.
um render3d model.glb out/ --preset aoe2 --length 80 --anims idle:10:bob,walk:12:bob --shadows
um render3d model.glb out/ --preset side --canvas 128 --length 110
um render3d model.glb out/ --preset iso8 --canvas 256x256 --engine eeveeum win
Steuert Windows-Spiele aus einem Agent heraus, nativ oder aus WSL: GPU-sichere Fensteraufnahme, Eingaben, die nur das Spiel erreichen, Aufnahme nur mit Spielton.
um win setup # PowerShell tools + ffmpeg with gfxcapture
um win ps [name]
um win launch --steam 105600 -- -windowed
um win shot --exe AoE2DE_s.exe out.png --scale 0.33
um win drive --proc AoE2DE_s "focus" "click 640 360" "key 0x1B"
um win record --exe Game.exe --out C:\caps\take1 --seconds 30
um win kill <pid> # exact PID only
um win reg set KEY VALUE DATA --type REG_DWORD # backs up firstum video
Showcase-Videos mit ffmpeg und Pillow: Kontaktbögen, um Momente auszuwählen, dann eine EDL (JSON), die zu einem betitelten, im Takt geschnittenen Video mit Musik kompiliert wird.
um video contact clip.mp4 sheet.png --every 2
um video first-frame take.mkv
um video beats music.mp3
um video mux take.mkv take.mkv.audio.raw take.mkv.json out.mp4
um video compile edl.json out.mp4 --previewum backup
Spielstandordner sichern, vergleichen und wiederherstellen. Eine Wiederherstellung sichert vorher den aktuellen Stand, lässt sich also selbst rückgängig machen.
um backup create "C:\Users\me\Documents\My Games\Terraria" --name terraria-saves
um backup list
um backup diff terraria-saves
um backup restore terraria-savesum publish check
Prüft einen Mod-Ordner vor dem Teilen. Schlägt fehl bei byte-identischen Spieldateien, geleakten Schlüsseln und .env-Dateien; warnt bei Decompiler-Spuren, großen Engine-Archiven, absoluten Pfaden und fehlenden Credits.
um publish check ./MyMod --game "C:\Program Files (x86)\Steam\steamapps\common\Terraria"um kb
Die gemeinsame Wissensdatenbank. Die Suche funktioniert auch außerhalb des Repos, über eine synchronisierte Kopie von GitHub.
um kb search "unreal pak mod"
um kb search terraria --route loader-api
um kb show games/terraria/fal-arsenal.md
um kb new --game "Hades II" --title "A new boon god" --from-scan "hades"
um kb check knowledge/games/hades-ii/new-boon-god.md
um kb pr knowledge/games/hades-ii/new-boon-god.md --yes # after your human says OKBeispiele angepasst aus der eingebauten Hilfe jedes Moduls in um/. Zwei Windows-Werkzeuge ohne Build-Schritt liegen bei: WinDrive für Eingaben und ProcLoopback für Ton nur aus dem Spiel (PowerShell mit eingebettetem C#).
Häufige Fragen
Wie installiere ich die um-CLI?
Plugin-Installationen und Klone legen sie in den PATH. Überall sonst: uv tool install git+https://github.com/rehan-remade/universal-modder (oder pipx install). Auf PyPI gibt es sie nicht. Siehe die Installationsanleitung.
Braucht um einen KI-Agent?
Nein. Es ist eine normale Python-CLI, und jeder Befehl funktioniert auch von Hand. Sie wurde so entworfen, dass Agents sie aufrufen können, mit --json-Ausgabe, wo es darauf ankommt.