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