rehan-remade/universal-modder

universal-modder – AI 기반 게임 모드 제작 툴킷

무엇인가요

• 대규모 언어 모델 코딩 에이전트(Claude, Codex, Gemini, Copilot, Cursor 등)가 소유한 거의 모든 PC 게임에 대해 자동으로 모드를 생성, 테스트, 배포할 수 있도록 해주는 에이전트 기술 모음과 작은 Python CLI(um)입니다.
• 리포지토리는 특정 게임이 어떻게 역설계되었는지, 어떤 엔진을 사용하는지, 성공한 정확한 단계를 기록한 지식 기반(knowledge/)을 제공합니다. 새 에이전트는 작업을 시작하기 전에 이 기반을 검색할 수 있습니다.

작동 방식

1. 에이전트 플러그인 – 원하는 LLM 코딩 보조 도구에 이 리포지토리를 플러그인으로 설치(Install 아래 표 참조). 플러그인은 skills/에 있는 기술과 각 에이전트가 읽는 설정 파일(AGENTS.md)을 추가합니다.
2. mod-any-game 기술 – 이는 주요 루프입니다. 다음과 같은 작업을 수행합니다:
   • 대상 게임에 대한 이전 작업을 지식 기반에서 검색합니다.
   • 정찰(엔진 탐지, 버전, 악성코드 방지 상태, 세이브 파일 위치).
   • 안전한 실험실(세이브 파일 백업, 프로세스 격리)을 설정합니다.
   • 게임 코드를 읽어(일스피, 길드라 등으로 역컴파일).
   • 최소한의 작동 가능한 모드 슬라이스를 생성합니다.
   • um fal 하위 명령을 통해 fal.ai를 호출하여 스프라이트, 텍스처, 3D 모델, 사운드, 음악, 음성 등을 생성합니다.
   • 자동화 도구(um win: 시작, 스크린샷, 입력 제어)를 사용해 게임 내에서 모드를 검증합니다.
   • 쇼케이스 영상(um video)을 기록합니다.
   • 모드를 패키지화하고 미래의 에이전트를 위한 새로운 현장 노트를 작성합니다.
3. CLI(um) – 각 단계에 대한 구체적인 명령어를 제공: 설치된 게임 스캔, 자산 생성, 3D에서 스프라이트 렌더링, Windows 자동화, 백업/복원, 지식 기반 CRUD, 배포 검사.
4. 안전 규칙 – 온라인 멀티플레이어 게임에는 손대지 않으며, 역컴파일된 게임 파일을 배포하지 않으며, 세이브 파일을 백업하고, 침입적인 작업 전에 사용자 확인을 요청합니다.

주요 구성 요소

• 기술 디렉터리 – Unity, Unreal, .NET/XNA, Godot, Source, Bethesda, Minecraft, AoE2, RE Engine, 네이티브 C++, 그리고 많은 인디 엔진을 포함한 12개 엔진의 "플레이북"용 미리 작성된 프롬프트와 스크립트. 각 플레이북은 해당 엔진의 일반적인 역설계 및 모드 제작 워크플로우를 인코딩합니다.
• 지식 기반 – Markdown 형식의 현장 노트(knowledge/games/<game>/<mod>.md)로 버전, 경로, 검증 단계, 주의사항을 기록합니다. 에이전트는 um kb search "grand theft auto"로 검색하고, 나중에 um kb pr …로 새로운 노트를 제출할 수 있습니다.
• Fal 통합 – 자산 생성은 Fal AI 서비스(이미지 → 3D, 텍스처 업스케일링, 오디오 합성 등)에 위임됩니다. CLI는 REST API를 래핑(um fal …)합니다.
• 자동화 유틸리티 – 안전한 마우스/키보드 주입 및 루프백 오디오 캡처용 PowerShell 도구, 게임 시작, 스크린샷 촬영, 동영상 녹화용 Python 래퍼.

리포지토리 내 예시 사용 사례

• Terraria – Fal로 생성된 모든 스프라이트를 포함한 호밍 미사일 런처와 전술 핵의 추가.
• Age of Empires II DE – 3D 모델에서 렌더링된 로봇 택시 유닛을 포함한 새로운 문명 생성.
• Minecraft × GTA V 마시업 – Minecraft의 렌더링 프레임을 GTA V로 스트리밍하고, WebSocket 브리지로 카메라와 물리를 동기화.

누구를 위한가요

• AI 지원 모드 파이프라인을 구축하는 개발자.
• 자동화된 역설계 및 자산 생성을 탐구하는 연구자.
• 싱글플레이어 게임 모드에 재현 가능하고 AI 기반 워크플로우를 원하는 애호가.

설치 빠른 시작

# CLI 설치 (Python 3.10+ 필요, uv 권장)
uv tool install git+https://github.com/rehan-remade/universal-modder
# 또는 pipx로
pipx install git+https://github.com/rehan-remade/universal-modder

# 자산 생성을 위한 Fal API 키 내보내기
export FAL_KEY=your_key_here

그런 다음 원하는 LLM 코딩 에이전트(Claude, Codex, Gemini, Copilot, Cursor 등)에 리포지토리를 플러그인으로 추가하고 um scan을 실행하여 게임을 탐지합니다.

라이선스 – MIT (폰트는 SIL OFL 하에).