Справочник

CLI um

Десять групп команд берут на себя механическую часть моддинга, чтобы агент не импровизировал. У каждой группы есть --help с примерами.

um scan

Находит установленные игры и снимает отпечаток с одной: движок, скриптовая среда, античит, мод-лоадеры, сохранения. Только чтение. В конце — ранжированные пути и руководство, которое стоит прочитать.

um scan
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 agents

um fal

Игровые ассеты из fal через обычный REST. Нужен FAL_KEY. Каждый вызов попадает в журнал, так что любой ассет можно отследить и сгенерировать заново.

um fal
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-2

um comfy

Изображения с локального сервера ComfyUI: без ключа API, на вашей видеокарте. Запускает любой workflow, экспортированный через Export (API).

um comfy
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:=42

um sprite

Превращает сгенерированный арт в точные кадры, которые ждёт игра.

um sprite
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.png

um render3d

Рендерит GLB в кадры спрайтов с камеры игры через Blender. Пресеты: aoe2 (16 направлений), iso8, trueiso, topdown, side, turntable.

um render3d
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 eevee

um win

Управление Windows-играми из агента — нативно или из WSL: захват окна, безопасный для GPU, ввод только в игру, запись только со звуком игры.

um win
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 first

um video

Демо-ролики на ffmpeg и Pillow: контактные листы для выбора моментов и EDL (JSON), который собирается в видео с титрами, нарезкой в ритм и музыкой.

um video
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 --preview

um backup

Снапшоты, сравнение и восстановление папок сохранений. Перед восстановлением снимается текущее состояние, так что и восстановление можно отменить.

um backup
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-saves

um publish check

Проверка папки мода перед публикацией. Ошибка — при побайтовых копиях файлов игры, утёкших ключах и .env; предупреждение — при следах декомпилятора, крупных архивах движка, абсолютных путях и отсутствии титров.

um publish check
um publish check ./MyMod --game "C:\Program Files (x86)\Steam\steamapps\common\Terraria"

um kb

Общая база знаний. Поиск работает и вне репозитория — по синхронизированной копии с GitHub.

um kb
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 OK

Примеры взяты из встроенной справки модулей в um/. В комплекте две Windows-утилиты без сборки: ввод WinDrive и запись только звука игры ProcLoopback (PowerShell со встроенным C#).

Частые вопросы

Как установить CLI um?

Установка плагина и клонирование добавляют его в PATH. В остальных случаях: uv tool install git+https://github.com/rehan-remade/universal-modder (или pipx install). В PyPI его нет. См. руководство по установке.

Нужен ли для um ИИ-агент?

Нет. Это обычный Python-CLI, все команды можно запускать вручную. Он рассчитан на вызов агентами, поэтому там, где важно, есть вывод --json.