Harbinger：迟来的先驱者
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：
前言
正文
附录
实战
后记
本指南全部内容均以 MIT 许可证授权。查阅 https://github.com/TeamCovertDragon/Harbinger/tree/bleeding/LICENSE 获得详细信息。
在同意将您的贡献以 MIT 许可证授权的前提下，我们欢迎您直接向 Harbinger 发起 Pull Request，为这份规模浩大（也不过一两万字而已）的指南的最终完成贡献您的一份力量。
两年多来，Harbinger 也得到过不少人的帮助。首先在此向所有直接参与维护的人致敬。 除此以外，还要特别感谢那些在幕后以各种形式帮到笔者的人们——没有他们，也许 Harbinger 将永远不会有今天这个样子。
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 将永远不会有今天这个样子。
3t不愧是写教程出身的（雾
大喜過望，宜加分。
迟来的平定者 ←_←
3T万岁(高呼
大喜过望, 感谢 dalao
关于跨Mod兼容，可以介绍一下Forge模组中的@Optional注解
个人认为盲目依赖forge是硬伤。Minecraft modding很多内容和forge没有关系，甚至很多理念mod和插件可以共享。
liach 发表于 2019-3-8 22:58
个人认为盲目依赖forge是硬伤。Minecraft modding很多内容和forge没有关系，甚至很多理念mod和插件可以共享 ...
然而 Forge 是个 de facto 的业界标准，先讲这个似乎也是非常符合直觉的选择……
耗子 发表于 2019-3-8 21:24
关于跨Mod兼容，可以介绍一下Forge模组中的@Optional注解
其实很早以前是有写到过 @Optional 的，但后来因为某些原因最终先暂时撤掉了，但原稿还在。
一句话：我（们）需要考虑一下怎么讲 @Optional 最合适……
Optional 个人认为可以和 SideOnly 一起讲解。原理类似 SideOnly 但是服务对象不同 （服务 @APi 接口）
...膜拜大佬
感谢楼主大大的教程。
楼主，这个是还未完成版么？怎么有好多章节页面打开是404错误，如下这些都是这样。
5.2.4 红石信号敏感的方块
9.1.2 流体储罐
9.1.3 打粉机19.3 大型结构
19.3.1 MapGenBase
19.3.2 MapGenStructure
19.3.3 Template
19.4 新维度
19.4.1 可选的 WorldType
19.4.2 WorldProvider
19.4.3 IChunkGenerator
19.4.4 BiomeProvider
另外我想问下这个指南会出离线PDF版或之类的离线版本么？
因为那个电子书网页打开奇慢无比，点一个章节有时候几分钟都没出来。
5.2.4 红石信号敏感的方块
9.1.2 流体储罐
9.1.3 打粉机19.3 大型结构
19.3.1 MapGenBase
19.3.2 MapGenStructure
19.3.3 Template
19.4 新维度
19.4.1 可选的 WorldType
19.4.2 WorldProvider
19.4.3 IChunkGenerator
19.4.4 BiomeProvider
另外我想问下这个指南会出离线PDF版或之类的离线版本么？
因为那个电子书网页打开奇慢无比，点一个章节有时候几分钟都没出来。
hjtest001 发表于 2019-3-14 20:23
楼主，这个是还未完成版么？怎么有好多章节页面打开是404错误，如下这些都是这样。
5.2.4 红石信号敏感的方 ...
你可以倒回去看一下本贴的说明：
未完成的章节目前会返回 404
实际上应该是“还未开始动笔的章节”。暂时先不改了，等下一次目录更新的时候再动。
离线版本——有鉴于整套指南用的是 GitBook，你可以用 GitBook CLI（$ npm install gitbook-cli -g）然后用它自己构建：
- # 导出 PDF 版本的
- $ gitbook pdf ./ ./book-pdf
- # 导出 EPUB 版本的
- $ gitbook epub ./ ./book-epub
在本指南正式完成之前我们没有发布 PDF/EPUB 版的计划，因为在可预见的未来中整个指南的内容仍然会快速变化，导出 PDF 有可能会让过时的信息流传开来，与本指南的目标之一“传播最新最准确的关于 Mod 开发的信息”相违。
...看不明白新手qwq
支持支持！简略没关系，关键要更完啊！！！不要像其他教程一样...
这个更新速度貌似可以啊
可以,虽然不清楚，
有没有1.12.2的带中文注释的事件列表？
502mc 发表于 2019-4-6 20:40
有没有1.12.2的带中文注释的事件列表？
有考虑过，但不是目前的重点。
目前的重点还是补全缺失章节的内容，比如 GUI、世界生成/新维度、实体及 AI、渲染等等等等…… 对各个事件的讲述会随着这些章节穿插进行。
emmmmmmmmmmmmmmmmmmm
为什么都是无效的链接？谢谢！
昨天链接还能打开来着，怎么今天不行了
很全面的讲解，多谢了~
为什么感觉所有教程都是竭力避开注册新世界这个环节？
MashKJo 发表于 2019-4-27 21:43
为什么感觉所有教程都是竭力避开注册新世界这个环节？
很简单：
1. 因为都没接触过所以都不敢写，怕误人子弟。（思考一下你见过多少有加新维度的 Mod？）
2. 因为觉得是“高级篇”的内容所以决定放后面写，然后在真正动笔之前就先弃坑了。
有鉴于人手不足和时间不足，你可以期待一下 Harbinger 在这本回复发布一周之内更新这一章。
u.s.knowledge 发表于 2019-4-28 16:47
很简单：
1. 因为都没接触过所以都不敢写，怕误人子弟。（思考一下你见过多少有加新维度的 Mod？）
2. 因 ...
还有，我有点儿疑惑，为什么有些章节只写一半就不写了，比如实体那章，连AITasks和AI列表都没有讲到。物品和方块的材质json也没有？
MashKJo 发表于 2019-4-30 12:28
还有，我有点儿疑惑，为什么有些章节只写一半就不写了，比如实体那章，连AITasks和AI列表都没有讲到。物 ...
很简单：时间不够。
实体是个非常棘手的东西，暂时不知道什么时候能更新。你应该注意到了，实体那一章基本是空白。
物品和方块的模型 JSON——这条回复发布之后的一周之内应该就会有。
感谢大佬
本帖最后由 u.s.knowledge 于 2019-5-1 07:14 编辑
其实物品模型其实是第十一章的内容，不过此前和其他编者的讨论中发现把物品模型这样的内容放得太靠后似乎不太合适，所以第四章（讲物品）的 4.1 节重新加入了非常基础的物品模型的介绍。
方块的入门介绍重写了一遍。之前的那个版本大约是一两年前写出来的东西……
MashKJo 发表于 2019-4-30 12:28
还有，我有点儿疑惑，为什么有些章节只写一半就不写了，比如实体那章，连AITasks和AI列表都没有讲到。物 ...
其实物品模型其实是第十一章的内容，不过此前和其他编者的讨论中发现把物品模型这样的内容放得太靠后似乎不太合适，所以第四章（讲物品）的 4.1 节重新加入了非常基础的物品模型的介绍。
方块的入门介绍重写了一遍。之前的那个版本大约是一两年前写出来的东西……
eclipse上点击 run client 出现 Unrecognized option: -Xincgc