リファレンス

um CLI

MOD 作りの機械的な部分を担う 10 のコマンドグループ。エージェントが即興でやらずに済みます。各グループに例つきの --help があります。

um scan

インストール済みのゲームを探し、特徴を調べます:エンジン、スクリプト実行環境、アンチチート、MOD ローダー、セーブ。読み取り専用。最後に順位付きのルートと読むべきプレイブックを出します。

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 キー不要、自分の GPU で。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

Blender で GLB をゲームのカメラ視点のスプライトにレンダリング。プリセット: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)からタイトル付きでビートに合わせた BGM 入り動画に。

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

公開前に MOD フォルダを検査。バイト単位で同じゲームファイル、漏れた鍵、.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 ツールも 2 つ同梱:WinDrive の入力と ProcLoopback のゲーム音のみ録音(C# 埋め込みの PowerShell)。

よくある質問

um CLI のインストール方法は?

プラグインのインストールや clone で PATH に入ります。それ以外は uv tool install git+https://github.com/rehan-remade/universal-modder(または pipx install)。PyPI にはありません。インストールガイドを参照。

um には AI エージェントが必要?

いいえ。普通の Python CLI なので、どのコマンドも手で実行できます。エージェントから呼びやすいよう、必要な箇所で --json 出力に対応しています。