레퍼런스

um CLI

모딩의 기계적인 부분을 맡는 명령 그룹 10개. 에이전트가 즉흥으로 하지 않아도 됩니다. 모든 그룹에 예시가 담긴 --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 키 없이 내 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)을 제목과 박자 맞춘 컷, 음악이 들어간 영상으로 컴파일.

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(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 출력이 있습니다.