Repolode
rehan-remade

rehan-remade/universal-modder

AI 코딩 에이전트가 fal 생성 에셋으로 보유한 PC 게임을 조사·모딩·테스트할 수 있게 하는 스킬, CLI 도구, MCP 서버 모음입니다.

스타
8,461
포크
934
열린 이슈
26
마지막 커밋
10시간 전

어떤 프로젝트인가요?

Universal Modder는 Claude Code, Codex, Cursor, Gemini CLI 같은 AI 코딩 에이전트에 PC 게임 모딩 워크플로를 제공합니다. 에이전트는 게임 설치 위치와 엔진, 버전을 파악하고 모딩 방법을 선택한 뒤 게임 코드를 살펴 작동하는 모드를 만들고, 실행 중인 게임에서 테스트합니다. 함께 제공되는 `um` CLI는 설치된 게임을 검색하고, fal을 통해 스프라이트·3D 모델·오디오를 생성하며, 창과 오디오를 캡처하고, 소개 영상을 편집합니다.

이 프로젝트는 Unity, Unreal, .NET/XNA, Godot, Minecraft, Age of Empires II, Bethesda 게임 등 다양한 엔진 계열을 지원하며, ILSpy, Ghidra, Frida 같은 리버스 엔지니어링 도구도 활용합니다. 스킬은 기존 기록 검색, 사전 조사, 세이브 백업, 기능 일부 구현, 에셋 생성, 검증, 조사 결과 기록의 고정된 순서를 따릅니다. 에이전트는 저장소의 공유 지식 베이스에 현장 기록을 추가할 수도 있습니다.

이 프로젝트는 안티치트가 적용된 온라인 게임에 코드를 삽입하거나 다른 플레이어를 상대로 치트를 사용하는 것을 금지하며, 게임 파일이나 디컴파일된 코드를 배포하지 않습니다. 설치에는 Git, Python 3.10 이상, ffmpeg가 필요하며, 에셋 생성을 위해 fal API 키도 필요합니다.

핵심 기능

  • 01Steam, Epic, Xbox 설치 경로를 검색해 엔진, 버전, 안티치트를 파악합니다.
  • 02리버스 엔지니어링, 사전 조사, 에셋 생성, 게임 내 테스트를 위한 에이전트 스킬을 제공합니다.
  • 03fal을 통해 스프라이트, 3D 모델, 텍스처, 오디오를 생성합니다.
  • 04게임 창과 게임 오디오만 캡처하며, 입력도 게임 창에만 전달할 수 있습니다.
  • 05변경 전에 세이브 폴더를 백업하고, 게임 파일이 포함된 게시물을 차단하는 검사를 제공합니다.

활용 사례

  • AI 생성 스프라이트를 활용해 Terraria 모드에 새 무기나 적을 추가합니다.
  • Age of Empires II DE의 새 문명이나 유닛을 만듭니다.
  • 완성된 게임 모드의 소개 영상을 녹화하고 편집합니다.
  • 게임의 모딩 사례가 있는지, 어떤 엔진을 사용하는지 확인합니다.

빠른 시작

  1. 1

    uv로 um CLI를 설치하세요

    uv tool install git+https://github.com/rehan-remade/universal-modder
  2. 2

    fal API 키를 저장하세요(선택 사항, 에셋 생성용)

    um fal key set
  3. 3

    AI 코딩 에이전트에 스킬을 설치하세요

    npx skills add https://github.com/rehan-remade/universal-modder

사용 전 알아둘 점

  • 소유한 PC 게임만 모딩하며, README에서는 에이전트가 다른 플레이어를 상대로 치트를 사용하지 않도록 안내합니다.
  • 에셋 생성에는 유료 fal API 키, 스프라이트용 Sprixen 키 또는 로컬 ComfyUI 서버가 필요합니다.
  • 3D를 스프라이트로 렌더링하려면 Blender가 필요하며, Windows 게임은 네이티브 환경 또는 WSL에서 실행합니다.

토픽

자주 묻는 질문

universal-modder은(는) 무엇인가요?
AI 코딩 에이전트가 fal 생성 에셋으로 보유한 PC 게임을 조사·모딩·테스트할 수 있게 하는 스킬, CLI 도구, MCP 서버 모음입니다. Universal Modder는 Claude Code, Codex, Cursor, Gemini CLI 같은 AI 코딩 에이전트에 PC 게임 모딩 워크플로를 제공합니다. 에이전트는 게임 설치 위치와 엔진, 버전을 파악하고 모딩 방법을 선택한 뒤 게임 코드를 살펴 작동하는 모드를 만들고, 실행 중인 게임에서 테스트합니다. 함께 제공되는 `um` CLI는 설치된 게임을 검색하고, fal을 통해 스프라이트·3D 모델·오디오를 생성하며, 창과 오디오를 캡처하고, 소개 영상을 편집합니다.
universal-modder은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
universal-modder은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
universal-modder은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. universal-modder의 마지막 커밋은 2026년 10월 19일입니다.
universal-modder은(는) 어디에 사용할 수 있나요?
AI 생성 스프라이트를 활용해 Terraria 모드에 새 무기나 적을 추가합니다. Age of Empires II DE의 새 문명이나 유닛을 만듭니다. 완성된 게임 모드의 소개 영상을 녹화하고 편집합니다. 게임의 모딩 사례가 있는지, 어떤 엔진을 사용하는지 확인합니다.
universal-modder는 어떻게 설치하나요?
uv로 um CLI를 설치하세요: uv tool install git+https://github.com/rehan-remade/universal-modder fal API 키를 저장하세요(선택 사항, 에셋 생성용): um fal key set AI 코딩 에이전트에 스킬을 설치하세요: npx skills add https://github.com/rehan-remade/universal-modder
universal-modder은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/rehan-remade/universal-modder

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트