universal-modder

让 Claude 直接帮你做任意 PC 游戏 Mod

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 智能体 🍴 复刻 1105 🐛 待处理 19 👀 关注 54
GitHub ↗
GitHub 星标 ★ 9805
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,fal API调用需自付费用

项目预览

universal-modder 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类智能体
开发团队rehan-remade
定价模式🏷️完全免费
价格说明开源免费,fal API调用需自付费用
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型age-of-empires,claude-code,claude-code-plugin,fal,game-assets,game-modding,mcp,modding,reverse-engineering,tmodloader
GitHub 星标★ 9805
上线时间2026-09-30 00:00:00
代码更新2026-11-20
仓库体积40.9 MB
本站数据更新2026-11-20
维护状态活跃
收录时间2026-10-05
浏览次数10

项目介绍

universal-modder 是一套面向 Claude Code 的游戏模组开发工具包,目标是让 AI 直接参与几乎所有 PC 游戏的 Mod 制作。它通过技能(Skills)、工具集和 fal MCP 服务,把原本分散的逆向工程、资源生成与测试流程串成一条链:先对目标游戏做侦察与内存/文件结构分析,再用 fal 生成美术、3D 模型和音频素材,随后编写或修改 Mod 代码,最后在游戏内实测并产出展示视频。项目覆盖《帝国时代》等具体案例,也兼容 tModLoader 等模组框架,把 Claude Code 从代码助手扩展为能操作游戏资产的智能体。对想快速做 Mod 但缺乏逆向和美术能力的玩家与开发者,它降低了从想法到可玩 Mod 的门槛,把重复劳动交给 AI 与自动化工具。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-05 · 当前星标 ★ 9805

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 7 步

环境要求

  • Python 3.10 及以上
  • ffmpeg
  • uv(官方推荐,用于安装 um CLI)
  • fal API Key(生成美术/3D/音频素材时需要)
  • Blender(仅在做 3D 转精灵图渲染时需要)

安装与启动步骤

  1. 1克隆仓库

    任意 agent 的通用做法:克隆后在该目录内启动你的编码 agent,它会读取 AGENTS.md 与各技能文件。

    git clone https://github.com/rehan-remade/universal-modder
  2. 2Claude Code 安装

    在 Claude Code 会话中依次执行两条插件命令,装好后自动获得技能、fal MCP 服务与 um CLI。

    /plugin marketplace add rehan-remade/universal-modder
    /plugin install universal-modder@universal-modder
  3. 3Codex 安装

    在终端中执行两条 codex 插件命令,效果与 Claude Code 一致。

    codex plugin marketplace add rehan-remade/universal-modder
    codex plugin add universal-modder@universal-modder
  4. 4Gemini CLI 安装

    Gemini CLI 用户直接用 extensions install 指向仓库地址即可完成安装。

    gemini extensions install https://github.com/rehan-remade/universal-modder
  5. 5仅安装 Skills

    任何 agent 都可用 npx skills 只装技能部分,不装插件体系。

    npx skills add https://github.com/rehan-remade/universal-modder
  6. 6安装 um CLI

    插件安装和克隆会把 um 放到 PATH;其他场景用 uv 或 pipx 单独安装。

    uv tool install git+https://github.com/rehan-remade/universal-modder
  7. 7配置 fal 密钥

    导出 fal API Key 后才能生成图片等素材,无密钥可改用 um comfy 连本地 ComfyUI。

    export FAL_KEY=...

关键配置

配置项必填说明示例
FAL_KEY是fal API Key,同时供 fal MCP 服务与 um fal 调用。fal-xxxxxxxxxxxxxxxxxxxx
chat.plugins.enabled是VS Code / Copilot 需先开启该设置才能从源码安装插件。true

如何确认成功

在克隆目录内启动 agent,确认技能已加载、AGENTS.md 生效,且终端里 um 命令可直接调用。

常见问题

Q:没有 fal API Key 还能做素材吗?

A:可以。图片生成可改用 um comfy,它连接本地运行的 ComfyUI 服务,无需 fal 密钥。

Q:支持哪些 AI coding agent?

A:Claude Code、Codex、Gemini CLI、VS Code/Copilot、Cursor、OpenCode 等,也支持任意 agent 只装 Skills。

Q:做 3D 转精灵图还需要装什么?

A:需要额外安装 Blender,用于把 3D 模型渲染成游戏可用的精灵图。

Q:Windows 游戏怎么运行和测试?

A:Windows 游戏可以原生驱动,也可以在 WSL 环境下驱动,按你的系统选择即可。

注意事项

  • 各 agent 读取技能的路径不同:Codex、Gemini CLI、Copilot、Cursor、OpenCode 用 .agents/skills,Claude Code 用 .claude/skills,二者都是 skills/ 的副本。
  • 统一说明文档在 AGENTS.md,CLAUDE.md 和 GEMINI.md 都指向它。
  • MCP 配置分散在 .mcp.json、.codex/config.toml、.cursor/mcp.json、.vscode/mcp.json 与 opencode.json。
  • Cursor 也可直接克隆仓库使用;OpenCode 则在仓库内运行 opencode 命令。

核心亮点

  • 把侦察、逆向、素材生成、测试、出片串成完整流水线,而非单一工具
  • 集成 fal MCP,可直接生成美术、3D 与音频,省去外部素材流程
  • 以 Claude Code 插件形式分发,安装后即可在对话中调用,上手路径短

不足之处

  • 依赖 Claude Code 与 fal 服务,存在账号、额度与网络门槛
  • 对复杂商业游戏的逆向深度和实际成功率缺少系统评测

适用场景

  • 给老游戏做高清材质与模型替换 Mod
  • 为独立游戏快速生成新角色、音效并实测
  • 把 Mod 制作过程自动录制成展示视频发布

替代项目

Awesome-Game-Modding、modding-tools、Cheat Engine

上一篇:whoop-mcp

下一篇:OpenDots

同类项目推荐

superior-skills 开源

让 AI 代理直接上手交易,开箱即用的交易技能库

Open agent skills and tool schemas for Superior Trade — build, backtest, and deploy···

★ 233 2026-08-09
ai-agents-skills 开源

给编程智能体配一套可复用技能包,少写重复提示词

AI Agent Skills Repository - A curated collection of specialized skills for AI codin···

★ 300 2026-11-01
awesome-ai-agents-2026 开源

一站式导航AI智能体生态,快速找到所需工具与框架。

The most comprehensive list of AI agents, frameworks & tools in 2026. 300+ resources···

★ 2088 2026-08-09
metaswarm 开源

把多个 AI 编码助手编成一条带测试与质检的流水线

A self-improving multi-agent orchestration framework for Claude Code, Gemini CLI, an···

★ 433 2026-11-10
agency-agents-app 开源

一处浏览安装,多款 AI 编程工具同步 agent 角色

Agency Agents is a small, native app for browsing, installing, and tracking the agen···

★ 989 2026-10-11
pinchy 开源

自托管企业级 AI 智能体,离线可用,权限审计全掌控

Self-hosted AI agent platform built on OpenClaw. Enterprise-ready, offline-capable, ···

★ 192 2026-08-09
mcp-apple-notes 开源

让 Claude 直接读取你的 Apple 笔记,问答式检索个人知识库

Talk with your notes in Claude. RAG over your Apple Notes using Model Context Protoc···

★ 420 2026-08-09
designing-real-world-ai-agents-w··· 开源

手把手从零搭建多智能体AI系统,附代码视频,快速上手MCP实战。

Hands-on workshop: Build a multi-agent AI system from scratch — Deep Research Agent···

★ 523 2026-08-09
plamen 开源

让 Claude Code 自动审计智能合约,几分钟发现漏洞

Autonomous Web3 security audit agent for Claude Code

★ 316 2026-08-09