Harbinger 是一套基于 Minecraft 1.12.2 和 Forge 的中文 Mod 开发指南。
顾名思义,Harbinger(英文“先驱者”之意)的最终目标就是覆盖“所有优秀的 Minecraft Modder 都或多或少了解的有关 Minecraft 和 Forge 的一切”。 说得夸张一些,这部开发指南是来终结 xkcd 927 的诅咒的。
Harbinger 最早于 2016 年 12 月中旬开始动笔,当时的项目代号为 Epsilon(第五个希腊字母“厄普西隆”),且最初的目标是一套同时覆盖 1.10.2、1.11.2 和 1.12.2 的 Mod 开发指南。 随着时间的推移及社区主流的变化,本指南最终放弃了 1.10.2 和 1.11.2 的有关内容,转而全力记载基于 1.12.2 的 Minecraft 及对应版本的 Forge 的 Modding 相关内容。
2018 年 8 月下旬,该项目停用 Epsilon 这个项目代号,并正式命名为 Harbinger,托管在 GitHub 上 Team CovertDragon 的 Organization 名下。 原本的计划是将 Harbinger 作为 TCD 的内部教材使用,但随后考虑到中文社区长久以来的 Mod 开发资源的空白与断层,TCD 成员与笔者遂决定将其打造成面向全中文社区的开发指南。
有鉴于其文本量过大,导致在 MCBBS 上维护 Harbinger 成本过高(排版、版本追踪、问题追踪等),所以本指南所有源文件全部托管于 https://github.com/TeamCovertDragon/Harbinger 仓库中。
本指南使用 GitBook 作为框架,电子书构建结果可随时在 https://harbinger.covertdragon.team/ 查看。本网站时刻监听源仓库更新,在 bleeding 分支上的新 commit 会立刻触发一次构建,所以不必担心更新速度的问题。
以下是 Harbinger 的总目录(含前言、正文、附录、实战与后记),全部指向 https://harbinger.covertdragon.team/ 。未完成的章节目前会返回 404:
前言
正文
- 1. 站在巨人的肩膀上
- 2. 一切的开始
- 3. 事件
- 4. 物品
- 5. 方块
- 6. 注册表
- 7. 物理端、逻辑端与网络 IO
- 8. 实体
- 9. 方块实体(TileEntity)
- 10. 附魔
- 11. 渲染概论
- 12. 药水与状态效果
- 13. 国际化与本地化
- 14. 用户交互界面(GUI)
- 15. 音效控制
- 16. 粒子效果
- 17. 资源包
- 18. 用户输入
- 19. 世界生成与新维度
- 20. 村庄
- 21. 合成表
- 22. 进度(Advancement)
- 23. 战利品表
- 24. 命令
- 25. Forge 权限系统
- 26. Forge 配置文件系统
- 27. Forge 流体系统
- 28. Forge Capability 系统
- 29. 跨 Mod 兼容及 Add-on 制作
- 30.
附录
- 31. 附录 I:???
- 32. 附录 II:???
- 33. 附录 III:???
- 34. 附录 IV:???
- 35. 附录 V:???
- 36. 附录 VI:???
- 37. 附录 VII:???
- 38. 附录 VIII:???
实战
后记
本指南全部内容均以 MIT 许可证授权。查阅 https://github.com/TeamCovertDragon/Harbinger/tree/bleeding/LICENSE 获得详细信息。
在同意将您的贡献以 MIT 许可证授权的前提下,我们欢迎您直接向 Harbinger 发起 Pull Request,为这份规模浩大
两年多来,Harbinger 也得到过不少人的帮助。首先在此向所有直接参与维护的人致敬。 除此以外,还要特别感谢那些在幕后以各种形式帮到笔者的人们——没有他们,也许 Harbinger 将永远不会有今天这个样子。