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. 站在巨人的肩膀上
  
  • 1.1 MCP
  • 1.2 Forge
  • 1.3 ForgeGradle
    
• 2. 一切的开始
  
  • 2.1 Mod 元数据
    
• 3. 事件
• 4. 物品
  
  • 4.1 ItemStack
  • 4.2 物品进阶
    
    • 4.2.1 Meta-hack
    • 4.2.2 食物
    • 4.2.3 工具及武器等
    • 4.2.4 护甲
    • 4.2.5 投掷物
      
    
    
• 5. 方块
  
  • 5.1 方块状态
  • 5.2 高级的方块
    
    • 5.2.1 矿石
    • 5.2.2 作物
    • 5.2.3 树苗
    • 5.2.4 红石信号敏感的方块
    • 5.2.5 类似空气的方块
      
  • 5.3 掉落概论
    
• 6. 注册表
• 7. 物理端、逻辑端与网络 IO
  
  • 7.1 TileEntity 内建的解决方案
  • 7.2 Container 内建的解决方案
  • 7.3 实体的解决方案
  • 7.4 Forge 的扩展
    
    • 7.4.1 SimpleNetworkWrapper
    • 7.4.2 FMLEventChannel
      
    
    
• 8. 实体
• 9. 方块实体（TileEntity）
  
  • 9.1 实例
    
    • 9.1.1 箱子，或别的种类的物品容器
    • 9.1.2 流体储罐
    • 9.1.3 打粉机
      
    
    
• 10. 附魔
• 11. 渲染概论
  
  • 11.1 方块及物品模型
    
    • 11.1.1 自定义物品模型映射
    • 11.1.2 染色
      
  • 11.2 自定义模型
    
    • 11.2.1 IBakedModel
    • 11.2.2 IModel
    • 11.2.3 ICustomModelLoader
    • 11.2.4 ItemOverrideList
      
  • 11.3 实体模型
    
    • 11.3.1 ModelBase
    • 11.3.2 相关事件
      
  • 11.4 TESR
  • 11.5 Render Layer
  • 11.6 Forge 的扩展
    
    • 11.6.1 Forge BlockState V1
    • 11.6.2 其他格式的模型
    • 11.6.3 FastTESR
    • 11.6.4 动画状态机
    • 11.6.5 TileEntityItemStackRenderer
      
    
    
• 12. 药水与状态效果
  
  • 12.1 状态效果
  • 12.2 状态效果与属性修饰符
  • 12.3 药水类型
    
• 13. 国际化与本地化
  
  • 13.1 文本组件（ITextComponent）
    
• 14. 用户交互界面（GUI）
• 15. 音效控制
• 16. 粒子效果
• 17. 资源包
• 18. 用户输入
  
  • 18.1 键盘输入
  • 18.2 鼠标输入
    
• 19. 世界生成与新维度
  
  • 19.1 地图特性（Feature）
    
    • 19.1.1 矿石生成
      
  • 19.2 生物群系（Biome）
    
    • 19.2.1 复用地图特性
    • 19.2.2 生物群系装饰器（Decorator）
    • 19.2.3 刷新生物
    • 19.2.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
      
    
    
• 20. 村庄
  
  • 20.1 村民职业
  • 20.2 村庄结构
    
• 21. 合成表
  
  • 21.1 Forge 的扩展
    
    • 21.1.1 矿物词典（Ore Dictionary）
    • 21.1.2 IConditionFactory
    • 21.1.3 IIngredientFactory
    • 21.1.4 IRecipeFactory
    • 21.1.5 常量池（_constants.json）
      
  • 21.2 重新实现 IRecipe
  • 21.3 扩展篇：熔炉配方及燃料值
  • 21.4 扩展篇：酿造台配方
  • 21.5 扩展篇：铁砧“配方”
    
• 22. 进度（Advancement）
  
  • 22.1 自定义进度触发条件
  • 22.2 自定义 Item Predicate
    
• 23. 战利品表
  
  • 23.1 战利品表条件（Loot Condition）
  • 23.2 战利品表函数（Loot Function）
    
• 24. 命令
  
  • 24.1 函数（.mcfunction）
  • 24.2 Forge 的扩展：CommandTreeBase
    
• 25. Forge 权限系统
  
  • 25.1 IPermissionHandler
    
• 26. Forge 配置文件系统
  
  • 26.1 Forge 可视化配置文件编辑界面
  • 26.2 Configuration 类
    
• 27. Forge 流体系统
  
  • 27.1 Fluid 与 FluidStack
  • 27.2 流体方块
  • 27.3 流体容器
    
    • 27.3.1 物品形式的容器
    • 27.3.2 方块形式的容器
    • 27.3.3 流体容器之间的交互
      
    
    
• 28. Forge Capability 系统
  
  • 28.1 Forge 内建的 Capability
    
    • 28.1.1 IItemHandler
    • 28.2.2 IFluidHandler, IFluidHandlerItem
    • 28.2.3 IEnergyStorage
    • 28.2.4 IAnimation
      
  • 28.2 属于你自己的第一个 Capability
    
• 29. 跨 Mod 兼容及 Add-on 制作
  
  • 29.1 跨 Mod 通信（Inter-Mod Communication，IMC）
  • 29.2 使用第三方 Capability
    
• 30.
  

附录

• 31. 附录 I：？？？
• 32. 附录 II：？？？
• 33. 附录 III：？？？
• 34. 附录 IV：？？？
• 35. 附录 V：？？？
• 36. 附录 VI：？？？
• 37. 附录 VII：？？？
• 38. 附录 VIII：？？？
  

实战

• 39. 实战：？？？
• 40. 实战：？？？
  

后记

• 后记
  
  • 跋：《Aboard Harbinger Gunship》
  • 写在后面：鸣谢名单
    
  
  

---

本指南全部内容均以 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和插件可以共享。

然而 Forge 是个 de facto 的业界标准，先讲这个似乎也是非常符合直觉的选择……

换言之，以现在这个风格写下去，可以非常简单地将它改造成基于别的框架的 Modding 指南。

其实很早以前是有写到过 @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版或之类的离线版本么？
因为那个电子书网页打开奇慢无比，点一个章节有时候几分钟都没出来。

你可以倒回去看一下本贴的说明：

实际上应该是“还未开始动笔的章节”。暂时先不改了，等下一次目录更新的时候再动。

离线版本——有鉴于整套指南用的是 GitBook，你可以用 GitBook CLI（$ npm install gitbook-cli -g）然后用它自己构建：

在本指南正式完成之前我们没有发布 PDF/EPUB 版的计划，因为在可预见的未来中整个指南的内容仍然会快速变化，导出 PDF 有可能会让过时的信息流传开来，与本指南的目标之一“传播最新最准确的关于 Mod 开发的信息”相违。

...看不明白新手qwq

支持支持！简略没关系，关键要更完啊！！！不要像其他教程一样...

这个更新速度貌似可以啊

可以,虽然不清楚，

有没有1.12.2的带中文注释的事件列表？