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 将永远不会有今天这个样子。

 
                
                    