publish-mod

发布一个 Mod

1. 检查

um publish check ./MyMod --game "<game install folder>"

• **失败：**与游戏文件逐字节完全相同的文件、泄露的密钥（fal/Anthropic/OpenAI/GitHub/AWS）、.env 文件。
• **警告：**源代码中的反编译特征（FUN_/DAT_/sub_ 名称、“Decompiled with” 标题）、大型引擎归档文件、绝对用户路径、缺少 README、未注明来源的 fal 资源。

修复所有失败项。谨慎处理每条警告。例如，AoE2 数据 Mod 确实会发布修改过的 .dat，这符合该平台的惯例。

2. 按照平台的预期方式打包

平台 / 加载器	软件包
tModLoader	构建 → .tmod；从游戏内的 Mod Sources 菜单发布（Steam Workshop）
BepInEx / Thunderstore	zip 文件，包含 manifest.json、icon.png（256×256）、README.md、plugins/<Mod>.dll；依赖项字符串格式如 BepInEx-BepInExPack-5.4.2100
Nexus Mods	按安装时的目录结构打包成 zip（Bethesda 使用 Data/...，BepInEx 使用 BepInEx/plugins/...，UE4SS 使用 ue4ss/Mods/...，~mods/*.pak）
AoE2 DE	官方 Mod 网站（ageofempires.com/mods）或游戏内上传器；数据 Mod 包含 resources/_common/dat/...
Steam Workshop	游戏自带的上传器或 SDK 工具
Minecraft	Modrinth / CurseForge jar，包含 fabric.mod.json / neoforge.mods.toml
ROM hacks / GameMaker	仅发布补丁（BPS/IPS/xdelta），绝不发布修改后的游戏文件

带有选项的 Nexus Mod 应提供 FOMOD 安装程序：参见 FOMOD 教程和 STEP 的 FOMOD 指南。Nexus Mods 自己的 Modding wiki介绍了该网站的其他惯例。

3. README（放在 zip 文件中并发布在页面上）

• 添加了什么：项目符号列表、GIF 或展示视频。
• 要求：游戏版本、加载器及其版本、依赖项。
• 安装、卸载和故障排查（日志所在位置）。
• 兼容性：支持多人游戏吗？有哪些已知冲突？
• 致谢：
  • 加载器和库；
  • 你参考的资料；
  • “使用 fal (fal.ai) 和 生成的美术/音频”（fal_manifest.jsonl 列出了所用模型）；
  • 如实披露 AI 使用情况（由哪个 Agent 和模型构建）。
• 代码的许可证（常见选择是 MIT/Apache）。资源的使用条款遵循模型许可证。

4. 版本和更新日志

在清单/构建文件中使用 semver，注明支持的游戏版本，并维护更新日志。游戏更新后，在提升版本前重新运行游戏内测试场景。

5. 发布内容

• 以视频开篇：使用展示视频技能；时长 20-45 秒，在 2-3 秒内展示游戏实况。
• 发布文案：吸引人的开场、内容介绍、制作致谢（由哪个 Agent 和 fal 构建）、链接。
• 如果视频使用了他人的素材，应注明对方的账号名，并事先征求许可。
• 是否发布始终由用户决定。先拟好内容给用户查看，再由用户按下发布按钮。