Repolode
rehan-remade

rehan-remade/universal-modder

Um conjunto de skills, ferramentas de CLI e um servidor MCP para agentes de programação com IA escanearem, modificarem e testarem jogos de PC que você possui, com assets gerados pelo fal.

Estrelas
8,461
Forks
934
Issues abertas
26
Último commit
há 11 horas

O que é?

O Universal Modder oferece um fluxo de trabalho para modificar jogos de PC com agentes de programação com IA, como Claude Code, Codex, Cursor e Gemini CLI. O agente identifica a instalação, a engine e a versão do jogo, escolhe uma abordagem para modificá-lo, analisa o código, cria um mod funcional e o testa no jogo em execução. A CLI `um`, incluída no projeto, cuida de escanear instalações, gerar sprites, modelos 3D e áudio pelo fal, capturar janelas e áudio e editar vídeos de apresentação.

O projeto abrange várias famílias de engines, incluindo Unity, Unreal, .NET/XNA, Godot, Minecraft, Age of Empires II e títulos da Bethesda, com ferramentas de engenharia reversa como ILSpy, Ghidra e Frida. As skills seguem um fluxo fixo: consultar anotações existentes, fazer o reconhecimento, criar backups dos saves, desenvolver uma parte por vez, gerar assets, verificar o resultado e registrar as descobertas. Os agentes também podem contribuir com anotações de campo para uma base de conhecimento compartilhada no repositório.

O projeto se recusa a injetar código em jogos online com anti-cheat ou a trapacear contra outros jogadores, e nunca distribui arquivos de jogos nem código decompilado. Para configurar o projeto, são necessários Git, Python 3.10+ e ffmpeg; para gerar assets, também é preciso ter uma chave de API do fal.

Recursos principais

  • 01Escaneia instalações da Steam, Epic e Xbox para identificar a engine, a versão e o anti-cheat.
  • 02Oferece skills para agentes fazerem engenharia reversa, reconhecimento, geração de assets e testes dentro do jogo.
  • 03Gera sprites, modelos 3D, texturas e áudio pelo fal.
  • 04Captura janelas de jogos e apenas o áudio do jogo, e envia comandos de entrada somente para a janela do jogo.
  • 05Faz backup das pastas de saves antes das alterações e inclui uma verificação de publicação que bloqueia arquivos do jogo.

Casos de uso

  • Adicionar novas armas ou inimigos a um mod de Terraria usando sprites gerados por IA.
  • Criar uma nova civilização ou unidade para Age of Empires II DE.
  • Gravar e editar um vídeo de apresentação de um mod de jogo finalizado.
  • Verificar se alguém já modificou um jogo e qual engine ele usa.

Início rápido

  1. 1

    Instale a CLI um com uv

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

    Armazene sua chave de API da fal (opcional, para gerar recursos)

    um fal key set
  3. 3

    Instale as skills no seu agente de programação com IA

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

Antes de usar

  • Modifica apenas jogos de PC que você possui, e o README pede que os agentes evitem trapacear contra outros jogadores.
  • A geração de recursos requer uma chave de API paga da fal, uma chave Sprixen para sprites ou um servidor ComfyUI local.
  • O Blender é necessário para renderizar modelos 3D como sprites, e os jogos de Windows são controlados nativamente ou pelo WSL.

Tópicos

Perguntas frequentes

O que é universal-modder?
Um conjunto de skills, ferramentas de CLI e um servidor MCP para agentes de programação com IA escanearem, modificarem e testarem jogos de PC que você possui, com assets gerados pelo fal. O Universal Modder oferece um fluxo de trabalho para modificar jogos de PC com agentes de programação com IA, como Claude Code, Codex, Cursor e Gemini CLI. O agente identifica a instalação, a engine e a versão do jogo, escolhe uma abordagem para modificá-lo, analisa o código, cria um mod funcional e o testa no jogo em execução. A CLI `um`, incluída no projeto, cuida de escanear instalações, gerar sprites, modelos 3D e áudio pelo fal, capturar janelas e áudio e editar vídeos de apresentação.
universal-modder é gratuito? Qual é a licença?
universal-modder é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
universal-modder ainda é mantido?
Manutenção ativa. O último commit de universal-modder foi em 19 de out. de 2026.
Para que posso usar universal-modder?
Adicionar novas armas ou inimigos a um mod de Terraria usando sprites gerados por IA. Criar uma nova civilização ou unidade para Age of Empires II DE. Gravar e editar um vídeo de apresentação de um mod de jogo finalizado. Verificar se alguém já modificou um jogo e qual engine ele usa.
Como instalar universal-modder?
Instale a CLI um com uv: uv tool install git+https://github.com/rehan-remade/universal-modder Armazene sua chave de API da fal (opcional, para gerar recursos): um fal key set Instale as skills no seu agente de programação com IA: npx skills add https://github.com/rehan-remade/universal-modder
Onde consigo universal-modder?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/rehan-remade/universal-modder

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados