RimWorld Modding Skill · 环世界Mod制作技能

⚠️ AI 生成声明：本项目（包括所有代码、文档、模板）由 AI（Claude Code）生成， 人工进行了审查和修改。使用者应自行验证所有内容的正确性和安全性。

⚠️ AI-Generated Disclosure: This project (including all code, documentation, and templates) was generated by AI (Claude Code) with human review and modification. Users should independently verify all content for correctness and safety.

Claude Code 环世界 Mod 制作全流程技能——从环境搭建到 Steam Workshop 发布。 Claude Code agent skill for full-cycle RimWorld mod development.

功能特性

• 全流程覆盖: XML Def、C#、Harmony 补丁、资源制作、调试、Workshop 发布
• 中英双语: 教程用中文，代码/XML 用英文
• 原版验证: 所有 Def 模式均对照 RimWorld 1.6 原版文件验证
• RimSage MCP 集成: 实时源码搜索，写 Def 前先查原版
• 测试版先行: 测试版 → 验证 → 正规化 → 可选发布
• 错误学习系统: 自动记录排查过的错误，加载 Skill 时读取，避免重复犯错
• 批量处理: 支持 Markdown 需求清单，批量生成多个 Mod 内容，逐项确认
• AI 生成标注: 生成的代码自动标记 AI 辅助来源，透明合规
• 代码模板: 近战/远程武器、服装/护甲、原材料、建筑、配方、ThingComp、Harmony 补丁、需求清单 (9 个)

目录结构

rimworld-modding-skill/
├── SKILL.md                 # 核心指令文件（必需）
├── README.md                # 项目介绍（推荐）
├── LICENSE                  # MIT
├── .gitignore
├── .mcp.json.example        # MCP 配置模板
├── references/              # 参考文档 + 工作流
│   ├── 01-environment.md
│   ├── 02-project-structure.md
│   ├── 03-xml-defs.md       # 核心：ThingDef、RecipeDef
│   ├── 04-xml-patching.md
│   ├── 05-csharp-basics.md
│   ├── 06-harmony.md
│   ├── 07-assets.md
│   ├── 08-debugging.md
│   ├── 09-workshop.md
│   ├── 10-api-reference.md
│   ├── 11-platform-adaptation.md  # 跨平台适配
│   └── workflows/           # 任务工作流（7 个）
│       ├── new-mod.md
│       ├── formalize-mod.md
│       ├── add-item.md
│       ├── add-building.md
│       ├── batch-process.md
│       ├── patch-vanilla.md
│       └── debug-crash.md
├── learnings/               # 错误学习记录
│   └── errors.txt           # 历史错误（每次加载 Skill 时自动读取）
├── assets/                  # 静态资源
│   └── templates/           # 代码模板（9 个）
│       ├── weapon-melee.xml
│       ├── weapon-ranged.xml
│       ├── apparel.xml
│       ├── resource-stuff.xml
│       ├── building.xml
│       ├── recipe.xml
│       ├── harmony-patch.cs
│       ├── thingcomp.cs
│       └── requirements-template.md
└── tests/                   # 测试用例
    └── evals.json

🖥️ 平台支持

各平台工具映射详见 references/11-platform-adaptation.md

安装

# Claude Code（原生）
cp -r rimworld-modding-skill ~/.claude/skills/rimworld-modding/

# Copilot CLI
cp -r rimworld-modding-skill ~/.copilot/skills/rimworld-modding/

# TRAE
cp -r rimworld-modding-skill ~/.trae/skills/rimworld-modding/

# Codex / Gemini CLI
cp -r rimworld-modding-skill ~/.codex/skills/rimworld-modding/

需求

• RimWorld 1.6
• RimSage MCP（推荐，用于源码搜索）
• .mcp.json 配置 rimworld-source MCP 服务器（所有平台通用）

致谢

特别感谢 RimSage（MIT 协议开源项目）。

如果你做过 RimWorld mod，大概率经历过这种事：想给武器加个燃烧伤害，但不记得 extraMeleeDamages 到底要不要写 Class 属性——于是打开 Data/Core/Defs/ 层层翻找，grep 半天才找到答案。

RimSage 把这个变成了几秒内的事。它给 RimWorld 源码做了语义索引，你用自然语言描述想查什么——"所有带燃烧附加伤害的近战武器"——它直接返回结构和字段名。本 Skill 排查报错和创建新类型模板时全靠它快速找到原版参照，不用肉眼翻几千行 XML。

感谢 RimSage 作者为 mod 社区造了这个轮子 🙏

许可证

MIT

Features (EN)

• Full coverage: XML Defs, C# modding, Harmony patching, assets, debugging, Workshop
• Bilingual: Chinese tutorials + English code/XML
• Vanilla-verified: All Def patterns validated against RimWorld 1.6 base game files
• RimSage MCP: Real-time source code search for verifying Def structures
• Test-first pipeline: Test version → verify → formalize → optional publish
• Error Learning: Auto-records debugged errors, reads them on skill load
• Batch Processing: Markdown requirement lists, batch generate multiple mod items with per-item confirmation
• AI Attribution: Auto-annotates AI-generated code in comments
• Templates: Ready-to-use XML/C# templates for weapons, apparel/armor, resources/stuff, buildings, recipes, ThingComp, Harmony, requirements (9 templates)

Installation (EN)

# Claude Code (native)
cp -r rimworld-modding-skill ~/.claude/skills/rimworld-modding/

# Copilot CLI
cp -r rimworld-modding-skill ~/.copilot/skills/rimworld-modding/

# TRAE
cp -r rimworld-modding-skill ~/.trae/skills/rimworld-modding/

# Codex / Gemini CLI
cp -r rimworld-modding-skill ~/.codex/skills/rimworld-modding/

Acknowledgments

This project depends on:

• RimSage (MIT License) — AI-powered RimWorld source code search MCP server. Provides search_rimworld_source, get_def_details, and read_rimworld_file. Used under the MIT License.

Thanks to the RimSage author for building such a powerful tool for the RimWorld modding community.

License

MIT