过去，为游戏制作模组需要掌握编程知识、了解游戏引擎的运作方式，还得能自己制作图像素材。如今，这些工作有一部分可以交给 AI 智能体完成。Claude Code 的 universal-modder 插件能教会智能体识别游戏引擎、选择合适的模组加载器、编写代码、生成精灵图，并在运行中的游戏里测试成果。本指南将介绍插件的工作方式、安装方法，以及如何用它制作你的第一个模组。
什么是 universal-modder
universal-modder 是一款免费的 Claude Code 插件，可帮助 AI 智能体为几乎所有 PC 游戏制作模组。它由 Rehan 开发，是一个托管在 GitHub 上的开源项目，采用 MIT License 发布。撰写本文时，最新版本为 0.2.0。我们此前介绍过 universal-modder 如何生成素材、编写代码，并直接在游戏中测试模组。
Claude Code 能够自主编写代码，但它不会自动了解某款游戏的具体架构，也不知道该游戏社区通常使用哪种模组加载器。这个插件正好弥补了这一不足。它为智能体提供了一系列针对不同引擎的操作指南、用于处理游戏的 um 命令行工具，以及 fal 服务的访问权限；fal 可以生成精灵图、纹理、3D 模型和音频。
这个插件既适合想为心爱的游戏添加自定义物品、敌人或机制，却不会编程的玩家，也适合希望借助工具检查游戏代码、找到合适函数的模组制作新手。
如何为 Claude Code 安装 universal-modder
安装插件之前，首先要下载并安装负责为你编写代码的 AI 智能体。这里使用的是 Claude Code。
如何安装 Claude Code
Claude Code 是 Anthropic 推出的 AI 编程智能体，可在终端中运行。它能读取和创建文件、运行命令，并在你的电脑上编写代码。要使用它，你需要订阅 Claude 的付费方案，例如 Pro、Max、Team 或 Enterprise；也可以使用已启用 API 计费的 Claude Console 账户。
系统要求：
- Windows 10 1809 或更高版本、macOS 13 或更高版本，或 Ubuntu 20.04 或更高版本。
- 至少 4 GB 内存。
- 网络连接。
- Windows 用户建议安装 Git for Windows。
你可能会制作模组的大多数游戏都运行在 Windows 上，而且插件的部分工具——包括启动游戏、截屏和录制视频——也是专为 Windows 设计的。因此，本指南后续将重点介绍 Windows 安装流程。
安装 Git for Windows
访问 Git 官方网站，下载并运行安装程序。安装过程中保持默认设置即可。Claude Code 需要 Git，原因有二：它会使用 Git 自带的 Git Bash shell，而插件本身也需要从 GitHub 下载。
安装 Claude Code
右键点击“开始”按钮，选择“终端”或“Windows PowerShell”。将 irm https://claude.ai/install.ps1 | iex 粘贴到窗口中并按 Enter。在 macOS 和 Linux 上，打开终端并运行 curl -fsSL https://claude.ai/install.sh | bash。安装完成后，关闭终端并重新打开一个窗口。进入你打算使用的项目文件夹，然后运行 claude 启动 Claude Code。你可以运行 claude --version 验证是否安装成功，命令应返回已安装的版本号。如果遇到问题，运行 claude doctor，程序会告诉你缺少什么。
首次启动并登录账户
为之后制作的模组单独创建一个文件夹，例如 C:\mods。智能体会在其中保存代码、素材和工作日志。在该文件夹中打开终端，并运行 claude 启动 Claude Code。首次运行时，程序会要求你选择配色主题和登录方式。选择 Claude 订阅或 Console 身份验证均可。随后会打开浏览器页面进行授权。登录并批准访问权限后，返回终端。最后，Claude Code 会询问你是否信任当前文件夹。确认后，输入框就会出现。
如何连接 universal-modder
安装插件本身之前，建议先配置好其工具链所需的程序。完成后，只需将插件添加到 Claude Code，并提供素材生成服务的 API 密钥即可。
工具链包含以下组件：
- Python 3.10 或更高版本。命令行工具本身由 Python 编写。
- uv。推荐使用的 Python 包管理器。安装 uv 后，um 会在首次启动时自动下载所需库。
- ffmpeg。用于录制和编辑视频。
- Blender。只有需要将 3D 模型转换成精灵图时才需要安装。
在 Windows 上，可以通过内置的 winget 包管理器安装所有这些程序。打开终端，依次运行以下命令：
- winget install Python.Python.3.12
- winget install astral-sh.uv
- winget install Gyan.FFmpeg
- winget install BlenderFoundation.Blender
安装完成后重启终端。运行 python --version、uv --version 和 ffmpeg -version，确认所有程序均已正确安装。
安装插件
在模组文件夹中启动 Claude Code，然后输入添加插件市场的命令： /plugin marketplace add rehan-remade/universal-modder。接着运行 /plugin install universal-modder\@universal-modder 安装插件本身。程序会询问要使用哪种安装范围。选择 User，这样插件就能在任何文件夹中使用。安装后查看 Claude Code 的提示。如果插件要求重新加载组件，请运行 /reload-plugins。如果你使用 Claude Desktop，请打开一个本地 Code 会话，点击输入框旁边的 +，再选择 Plugins > Add plugin。添加 universal-modder 插件市场，安装插件，并选择所需的安装范围。
如何获取 fal API 密钥
fal 是一项用于生成图像、素材、模型及其他模组资源的服务。即使没有 API 密钥，插件仍可运行，但智能体将无法自行生成精灵图、模型或音效。这项服务需要付费：每次生成都会从账户余额中扣费，而 3D 模型和视频是费用最高的项目之一。访问 fal.ai 并创建账户，然后为余额充值。接着打开 API 密钥页面，创建新密钥并复制。密钥只会显示一次，请立即保存。然后通过 FAL_KEY 环境变量将密钥提供给系统。在 Windows 上，于终端运行以下命令，并将占位内容替换为你自己的密钥： setx FAL_KEY your_key。
在 macOS 和 Linux 上，将 export FAL_KEY=your_key 添加到 \~/.bashrc 或 \~/.zshrc 文件中，然后重启终端。你也可以在项目文件夹中创建 .env 文件，并写入 FAL_KEY=your_key。um 工具可以从该文件读取密钥，但 Claude Code 中的 fal MCP 服务器只能从环境变量中读取密钥。
插件命令
插件包含两类命令：一种是在 Claude Code 中通过斜杠命令调用的技能，另一种是智能体在终端中运行的 um 工具命令。你不必把它们全记下来。大多数情况下，只要用日常语言描述需求，智能体就会选择合适的技能。不过，了解这些命令有助于你弄清楚智能体正在做什么。
技能
所有技能都使用插件前缀，例如 /universal-modder:mod-any-game。你可以紧接在技能名称后面写下任务。
- mod-any-game。核心技能，负责从最初构想到最终完成模组的整个项目流程，并针对 12 类游戏引擎提供操作指南。开始任何项目，都推荐先用它。
- game-recon。在开发开始前进行侦察，识别游戏引擎、反作弊系统、存档文件夹，以及社区常用的模组加载器。结果会写入 MODDING_PLAN.md。
- reverse-engineering。使用 ILSpy、Ghidra、Cheat Engine、RenderDoc 等工具检查游戏代码和文件格式。
- fal-assets。通过 fal 生成带透明背景的精灵图、像素美术、纹理、3D 模型、音效、音乐和配音。
- asset-pipeline。根据游戏要求调整图像素材，包括移除背景、调整帧尺寸和调色板、制作精灵表，以及从指定角度渲染 3D 模型。
- game-automation。启动游戏、截屏、按键并点击菜单，让智能体能够自行测试模组。
- showcase-video。录制游戏窗口并保留游戏音频，然后剪辑一段带标题和配乐的短视频。
- mashup-mods。融合两款游戏、将一款游戏的内容移植到另一款游戏中，并处理完整转换项目。
- publish-mod。进行发布前检查、打包模组、编写包含安装说明的 README、准备鸣谢名单，并为 Nexus Mods、Steam Workshop、Thunderstore、mod.io 或 GitHub 撰写发布帖文。
- share-field-notes。搜索知识库，并根据已完成的项目撰写新的实战笔记。
如何使用插件制作模组
下面以 Terraria 模组为例，完整演示整个流程。Terraria 很适合作为第一个模组项目，因为它没有反作弊系统，tModLoader 可在 Steam 上通过官方渠道获取，而且拥有庞大的模组生态。你也可以看看我们整理的另一篇文章： 最佳 Terraria 模组。universal-modder 的知识库已经收录了针对这款游戏的详细笔记。其他游戏的流程大体相同，只是具体使用的工具会有所不同。
开始之前，确保你已通过 Steam 购买并安装游戏。然后在 Steam 商店中找到免费的 tModLoader 应用，并将其添加到你的库中。没有它，加载器就无法运行；智能体也不会绕过所有权验证。手动启动一次 tModLoader，让它创建所需文件夹，然后关闭程序。创建一个项目文件夹，例如 C:\mods\terraria-boomerang，在其中打开终端，并运行 claude 启动 Claude Code。
调用核心技能并直接描述任务。需求越具体，智能体需要追问的内容就越少：/universal-modder:mod-any-game 为 Steam 版 Terraria 制作一个模组，添加一把回旋镖；它会在敌人之间反弹四次，然后返回玩家手中。请通过 fal 按照游戏的视觉风格生成精灵图。智能体会进一步确认细节，并询问你如何定义完成。通常，这意味着要制作出能正常运行的游戏内模组，并生成一段 20–45 秒的视频。如果你不需要视频，请一开始就说明。项目文件夹中会生成一份名为 MODLOG.md 的工作日志。
首次启动安装了模组的游戏之前，智能体会使用 um backup create 为你的存档创建备份。它还会通过 -tmlsavedirectory 参数设置独立的存档文件夹，确保你的正式角色和世界不会受到影响。智能体会将游戏切换到固定尺寸的窗口，以保证截图和点击坐标始终一致。等待项目完成后，再亲自测试成果。智能体会独立制作出完整且可运行的模组。
开发限制
插件有严格的规则，即使你提出要求，智能体也不会违反。制作模组前请先了解这些限制，做到心中有数。插件不会：
- 修改受反作弊保护的在线游戏。这包括 Easy Anti-Cheat、BattlEye、Vanguard、官方服务器上的 VAC、Ricochet 和 ACE。作为替代方案，智能体可能会建议使用离线模式、私人服务器，或 Steam Workshop、地图编辑器等官方工具。
- 制作多人游戏作弊工具。自瞄、ESP、加速外挂和类似工具都不允许制作。
- 绕过保护措施。智能体不会篡改反作弊、DRM 或游戏所有权验证机制。
- 分发游戏文件。已完成的模组只包含你的代码、素材和补丁。提取出的资源和反编译代码仍会留在你自己的电脑上。
- 处理你不拥有的游戏。插件不会下载游戏、ROM 文件或光盘镜像。
在向游戏文件夹中安装加载器、接管鼠标和键盘，或发布任何内容之前，智能体都会征求你的许可。修改 Windows 注册表之前，工具也会备份相关键值。
新手建议
- 从已经拥有热门模组加载器的游戏入手，例如 Terraria、Stardew Valley、Minecraft，或使用 Unity 引擎制作的游戏。智能体能更快做出可运行的成果。
- 一次只给它一个小任务。第一个物品正常运行后，再让它添加下一个。
- 在进行费用较高的生成任务前，先询问价格。智能体可以使用 um fal price 查询费用。
- 如果项目要持续几天，可以在同一文件夹中开启新会话，并让它读取 MODLOG.md 后继续。日志记录了智能体接手未完成工作的全部必要信息。
- 智能体测试游戏或录制视频时，不要使用电脑。额外的鼠标点击可能会干扰它的坐标判断。
