um scan
Encuentra juegos instalados y analiza uno: motor, runtime de scripts, anti-cheat, mod loaders, partidas. Solo lectura. Termina con rutas ordenadas y la guía que hay que leer.
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
Assets de juego desde fal por REST simple. Necesita FAL_KEY. Cada llamada queda en un registro, así cualquier asset se puede rastrear y regenerar.
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
Imágenes desde un servidor ComfyUI local: sin clave de API, con tu propia GPU. Ejecuta cualquier workflow exportado con Export (API).
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
Convierte el arte generado en los fotogramas exactos que espera el juego.
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
Renderiza un GLB en fotogramas de sprite desde la cámara del juego con Blender. Presets: aoe2 (16 direcciones), 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
Controla juegos de Windows desde un agente, nativo o desde WSL: captura de ventana segura para la GPU, entrada que solo llega al juego, grabación solo con el audio del juego.
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
Vídeos de presentación con ffmpeg y Pillow: hojas de contacto para elegir momentos y un EDL (JSON) compilado en un vídeo con títulos, cortes al ritmo y música.
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
Instantáneas, diferencias y restauración de carpetas de partidas. Una restauración guarda antes el estado actual, así que también se puede deshacer.
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
Revisa una carpeta de mod antes de compartirla. Falla con archivos del juego idénticos, claves filtradas y archivos .env; avisa de huellas de descompiladores, archivos grandes del motor, rutas absolutas y créditos ausentes.
um publish check ./MyMod --game "C:\Program Files (x86)\Steam\steamapps\common\Terraria"um kb
La base de conocimiento compartida. La búsqueda funciona también fuera del repo, con una copia sincronizada de 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 OKEjemplos adaptados de la ayuda integrada de cada módulo en um/. Incluye además dos herramientas de Windows sin compilar: entrada WinDrive y audio solo del juego ProcLoopback (PowerShell con C# integrado).
Preguntas frecuentes
¿Cómo instalo la CLI um?
Instalar el plugin o clonar el repo la añade al PATH. En cualquier otro caso: uv tool install git+https://github.com/rehan-remade/universal-modder (o pipx install). No está en PyPI. Consulta la guía de instalación.
¿um necesita un agente de IA?
No. Es una CLI de Python normal y todos los comandos funcionan a mano. Está pensada para que los agentes la llamen, con salida --json donde importa.