
universal-modder
让 Claude 直接帮你做任意 PC 游戏 Mod
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-05 · 当前星标 ★ 9805
使用教程
环境要求
- Python 3.10 及以上
- ffmpeg
- uv(官方推荐,用于安装 um CLI)
- fal API Key(生成美术/3D/音频素材时需要)
- Blender(仅在做 3D 转精灵图渲染时需要)
安装与启动步骤
-
1克隆仓库
任意 agent 的通用做法:克隆后在该目录内启动你的编码 agent,它会读取 AGENTS.md 与各技能文件。
git clone https://github.com/rehan-remade/universal-modder -
2Claude Code 安装
在 Claude Code 会话中依次执行两条插件命令,装好后自动获得技能、fal MCP 服务与 um CLI。
/plugin marketplace add rehan-remade/universal-modder /plugin install universal-modder@universal-modder -
3Codex 安装
在终端中执行两条 codex 插件命令,效果与 Claude Code 一致。
codex plugin marketplace add rehan-remade/universal-modder codex plugin add universal-modder@universal-modder -
4Gemini CLI 安装
Gemini CLI 用户直接用 extensions install 指向仓库地址即可完成安装。
gemini extensions install https://github.com/rehan-remade/universal-modder -
5仅安装 Skills
任何 agent 都可用 npx skills 只装技能部分,不装插件体系。
npx skills add https://github.com/rehan-remade/universal-modder -
6安装 um CLI
插件安装和克隆会把 um 放到 PATH;其他场景用 uv 或 pipx 单独安装。
uv tool install git+https://github.com/rehan-remade/universal-modder -
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
同类项目推荐
superior-skills
开源
让 AI 代理直接上手交易,开箱即用的交易技能库
Open agent skills and tool schemas for Superior Trade — build, backtest, and deploy···
ai-agents-skills
开源
给编程智能体配一套可复用技能包,少写重复提示词
AI Agent Skills Repository - A curated collection of specialized skills for AI codin···
awesome-ai-agents-2026
开源
一站式导航AI智能体生态,快速找到所需工具与框架。
The most comprehensive list of AI agents, frameworks & tools in 2026. 300+ resources···
metaswarm
开源
把多个 AI 编码助手编成一条带测试与质检的流水线
A self-improving multi-agent orchestration framework for Claude Code, Gemini CLI, an···
agency-agents-app
开源
一处浏览安装,多款 AI 编程工具同步 agent 角色
Agency Agents is a small, native app for browsing, installing, and tracking the agen···
pinchy
开源
自托管企业级 AI 智能体,离线可用,权限审计全掌控
Self-hosted AI agent platform built on OpenClaw. Enterprise-ready, offline-capable, ···
mcp-apple-notes
开源
让 Claude 直接读取你的 Apple 笔记,问答式检索个人知识库
Talk with your notes in Claude. RAG over your Apple Notes using Model Context Protoc···
designing-real-world-ai-agents-w···
开源
手把手从零搭建多智能体AI系统,附代码视频,快速上手MCP实战。
Hands-on workshop: Build a multi-agent AI system from scratch — Deep Research Agent···
plamen
开源
让 Claude Code 自动审计智能合约,几分钟发现漏洞
Autonomous Web3 security audit agent for Claude Code