CrispyW0nton/KotorModdingKnowledgeBase

# KOTOR 模组制作知识库 [](https://creativecommons.org/licenses/by-sa/4.0/) [](https://discord.gg/openkotor) ## 🎯 这是什么？ 这是一个精选的知识库，包含了 OpenKotOR 模组制作社区所掌握的全部知识，涵盖： - **Aurora/Odyssey 引擎的工作原理**（渲染、walkmesh、脚本、GUI、保存/加载） - **如何制作 KOTOR 模组**（模型、纹理、脚本、关卡、补丁） - **如何对引擎二进制文件进行逆向工程**（Ghidra 分析、类布局、函数地址） - **有哪些工具以及如何使用它们**（reone、PyKotor、HoloLSP、kotorblender 等 20 多种工具） 所有知识均提取自 **8,875 条 Discord 消息**、**独立的逆向工程文档**以及 **PyKotor Wiki”，并附有完整的[署名](ATTRIBUTION.md)。 ## 📖 从这里开始 **刚接触 KOTOR 模组制作？** 建议按以下顺序阅读： 1. 📁 [文件格式参考](docs/file-formats/file-formats-reference.md) — 了解你将要处理的文件类型 2. 🛠️ [工具参考](docs/modding/tools-reference.md) — 寻找合适的工具来完成工作 3. 🧩 [模型工作流](docs/modding/model-workflow.md) — 在 Blender 中导入/导出模型 4. 📝 [脚本指南](docs/modding/scripting-guide.md) — 编写和编译 NWScript 5. 🐛 [已知问题](docs/engine/known-issues.md) — 避免常见的坑 **想要深入研究？** 6. 🏗️ [引擎架构](docs/engine/aurora-odyssey-engine.md) — 引擎的构建方式 7. 🔄 [Walkmesh 系统](docs/engine/walkmesh-system.md) — 碰撞/寻路的完整逆向工程 8. 🔍 [二进制分析](docs/reverse-engineering/binary-analysis.md) — Ghidra 目标和版本差异 9. 🧬 [类层次结构](docs/reverse-engineering/engine-class-hierarchy.md) — 从二进制文件中提取的 C++ RTTI 转储 ## 📚 完整文档索引 ### 引擎内部机制 (`docs/engine/`) | 文档 | 涵盖内容 | |----------|--------| | [Aurora/Odyssey 架构](docs/engine/aurora-odyssey-engine.md) | 核心设计、类层次结构、渲染管线、NWScript VM | | [Walkmesh 系统](docs/engine/walkmesh-system.md) | BWM 格式、AABB 射线投射、多层 walkmesh 限制及修复 | | [渲染管线](docs/engine/rendering-pipeline.md) | Shader、3 光源限制、透明度、渲染顺序、材质 | | [NWScript VM](docs/engine/nwscript-vm.md) | 字节码执行、动作队列、事件系统 | | [GUI 系统](docs/engine/gui-system.md) | XML 格式、控件类型、STRREF 值 | | [字体渲染](docs/engine/font-system.md) | 位图字体、TXI 元数据、PyKotor API | | [保存/加载管线](docs/engine/save-load-system.md) | 资源作用域、存档封装、搜索优先级 | | [引擎日志分析](docs/engine/engine-log-analysis.md) | reone 日志模式、脚本链、诊断信息 | | [已知问题](docs/engine/known-issues.md) | 记录了 **367 个 bug** 及其解决方案 | ### 文件格式 (`docs/file-formats/`) | 文档 | 涵盖内容 | |----------|--------| | [格式参考](docs/file-formats/file-formats-reference.md) | 所有 KOTOR 格式：BIF、ERF、RIM、2DA、GFF、MDL、WOK、TXI、NSS | | [PyKotor Walkmesh 速查表](docs/file-formats/pykotor-walkmesh-cheatsheet.md) | BWM runtime 模型、二进制布局、身份索引 | ### 模组制作指南 (`docs/modding/`) | 文档 | 涵盖内容 | |----------|--------| | [模型工作流](docs/modding/model-workflow.md) | Blender 导入/导出、MDL/MDX、绑定、walkmesh、supermodel | | [纹理工作流](docs/modding/texture-workflow.md) | TGA/TPC 转换、TXI 元数据、纹理包、法线贴图 | | [关卡设计](docs/modding/level-design.md) | LYT/VIS/RIM 编辑、walkmesh、生成点 | | [脚本指南](docs/modding/scripting-guide.md) | NWScript 编译、事件链、设计模式 | | [工具参考](docs/modding/tools-reference.md) | 20 多种工具的描述与链接 | | [Shader 覆盖与补丁](docs/modding/shader-override-and-patches.md) | kpatch 格式、内存钩子 | ### 逆向工程 (`docs/reverse-engineering/`) | 文档 | 涵盖内容 | |----------|--------| | [二进制分析](docs/reverse-engineering/binary-analysis.md) | EXE 版本、K2 1.0≡1.0b 差异、Ghidra 配置 | | [MDL 节点结构](docs/reverse-engineering/mdl-node-structures.md) | MdlNodeEmitter（304 字节）、所有字段偏移量 | | [引擎类层次结构](docs/reverse-engineering/engine-class-hierarchy.md) | 来自 KOTOR2 二进制文件的完整 C++ RTTI | ### 社区 (`docs/community/`) | 文档 | 涵盖内容 | |----------|--------| | [项目与资源](docs/community/projects-and-resources.md) | 67 个 GitHub 仓库、贡献者、资源合集 | ## 📦 资产与资源 在寻找模组制作者的资源？请查看 [`ASSET-INDEX.md`](ASSET-INDEX.md) 获取完整列表： | 分类 | 数量 | 精选推荐 | |----------|-------|------------| | **模型** | 29 | 角色包（FBX）、区域环境（.blend）、游戏资产（MDL） | | **纹理** | 6 | Korriban 区域纹理（81 个 TGA）、参考图 | | **动画** | 1 | 自定义动画核心 | | **Shader** | 1 | Shader 集合 | | **文档** | 9 | 恢复的 KOTOR2 源码（711 个 C++ 文件！）、RE 分析（3,468 个 markdown 文件） | | **补丁** | 2 | 包含 NSS 源码的社区补丁 | | **游戏文件** | 12 | 来自实际游戏的 MDL、MDX、WOK、UTC、RIM | | **图像** | 1,003 | 截图、UI 参考、bug 报告 | | **视频** | 123 | 玩法片段、教程 | ## 🗂️ 仓库结构 ``` KotorModdingKnowledgeBase/ ├── README.md ← You are here ├── ATTRIBUTION.md ← Sources and contributor credits ├── CONTRIBUTING.md ← How to add to this knowledge base ├── LICENSE ← CC BY-SA 4.0 ├── ASSET-INDEX.md ← Every asset categorized │ ├── docs/ ← KNOWLEDGE WIKI (21 documents) │ ├── engine/ ← How the engine works (9 docs) │ ├── file-formats/ ← Binary format specs (2 docs) │ ├── modding/ ← How-to guides (6 docs) │ ├── reverse-engineering/← RE documentation (3 docs) │ └── community/ ← Projects & resources (1 doc) │ ├── extracted_channels/ ← Raw Discord messages (markdown) ├── Saved/Codex/ ← AI-extracted knowledge briefs (79 files) ├── analysis/ ← Automated analysis output ├── chunks/ ← Processing pipeline data ├── tools/ ← Reusable processing scripts └── [raw assets] ← Models, textures, archives, game files ``` ## 🔍 快速参考 | 我想... | 阅读这篇 | |--------------|-----------| | 了解引擎 | [架构](docs/engine/aurora-odyssey-engine.md) | | 编辑 walkmesh | [Walkmesh 系统](docs/engine/walkmesh-system.md) | | 处理模型 | [模型工作流](docs/modding/model-workflow.md) | | 编写脚本 | [脚本指南](docs/modding/scripting-guide.md) | | 逆向工程 | [二进制分析](docs/reverse-engineering/binary-analysis.md) | | 寻找工具 | [工具参考](docs/modding/tools-reference.md) | | 修复 bug | [已知问题](docs/engine/known-issues.md) | | 寻找资产 | [资产索引](ASSET-INDEX.md) | ## 📊 统计 | | | |---|---| | 知识文档 | 21 | | 提取的 Discord 消息 | 8,875 | | 收录的代码片段 | 233 | | 记录的 GitHub 仓库 | 67 | | 带有修复方法的已知问题 | 367 | | 索引的模组制作者资源 | 71 | | 总源文件数 | 1,319 | ## 🙏 致谢 整理自 **OpenKotOR Discord 社区**，感谢 modawan、Wizard、Lane、Lachjames、DarthParametric 等许多人的贡献。完整的致谢名单请参见 [ATTRIBUTION.md](ATTRIBUTION.md)。 知识通过本地 AI (qwen30lead) 提取，并由 GLM-5.2 合成。 *这是一个由粉丝创建的知识库。Knights of the Old Republic 是 LucasArts/Disney 的商标。本项目与 LucasArts、BioWare、Aspyr 或 Disney 没有任何隶属关系，也未获得其认可。*

标签：Aurora引擎, ESC1, Ghidra, Ruby, 云资产清单, 后端开发, 游戏Mod, 游戏引擎, 知识库, 系统运维工具, 逆向工具, 逆向工程, 防御加固