Minecraft(我的世界)中文论坛

 找回密码
 注册(register)

!header_login!

只需一步,立刻登录

查看: 17017|回复: 73

[Mod开发教程] Harbinger - 面向中文社区的 1.12.2 Forge Mod 开发指南

    [复制链接]
3TUSK 当前离线
帖子
主题
精华
贡献
最后登录
1970-1-1
爱心
积分
7012
钻石
性别
保密
注册时间
2013-3-8
查看详细资料
发表于 2019-3-8 12:00:16 | 显示全部楼层 |阅读模式

您尚未登录,立即登录享受更好的浏览体验!

您需要 登录 才可以下载或查看,没有帐号?注册(register)

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



评分

参与人数 53人气 +98 金粒 +1028 绿宝石 +60 贡献 +13 收起 理由
洪放来也 + 1 + 15 付学费
乙烯_中国 + 60 MCBBS有你更精彩~
土球球 + 5 + 50 + 5 精华 II
1145138446 + 2 + 24 神乎其技!6的飞起!
h_Ray + 2 MCBBS有你更精彩~
Ling_Haner + 2 MCBBS有你更精彩~
!!!.3.. + 1 + 6 MCBBS有你更精彩~
753159@z7 + 1 MCBBS有你更精彩~
SevenTailCat + 1 MCBBS有你更精彩~
Entity_07 + 1 付学费
lowu45678 + 1 + 15 向大佬低头!!学费怪怪递上!.
wujichen158 + 1 + 15 感谢作者的引路!
ArcoWave_龙梦 + 1 向大佬学习!
袋里的鲨 + 2 MCBBS有你更精彩~
c、江秋菌 + 1 + 5 为了实现能量!
1143246234 + 2 + 20 MCBBS有你更精彩~
1257375501 + 2 Ssssssssssssssssssss
nikoniko_ni + 2 MCBBS有你更精彩~
tianyuexiao + 1 + 15 神乎其技,不服不行!
SnowWings + 20 太厉害了

查看全部评分

故里故里 当前离线
帖子
主题
精华
贡献
最后登录
1970-1-1
爱心
积分
657
钻石
性别
保密
注册时间
2013-6-6
查看详细资料
发表于 2019-3-8 12:09:18 | 显示全部楼层
3t不愧是写教程出身的(雾
回复

使用道具 举报

梨木利亚 当前离线
帖子
主题
精华
贡献
最后登录
1970-1-1
爱心
积分
5013
钻石
性别
保密
注册时间
2013-9-25
查看详细资料
发表于 2019-3-8 12:25:24 来自手机 | 显示全部楼层
大喜過望,宜加分。
回复

使用道具 举报

重生是希望 当前离线
帖子
主题
精华
贡献
最后登录
1970-1-1
爱心
积分
2693
钻石
性别
保密
注册时间
2012-6-8
查看详细资料
发表于 2019-3-8 12:41:45 | 显示全部楼层
迟来的平定者 ←_←
回复

使用道具 举报

zh470947848 当前离线
帖子
主题
精华
贡献
最后登录
1970-1-1
爱心
积分
3605
钻石
性别
保密
注册时间
2015-2-19
查看详细资料
发表于 2019-3-8 19:03:48 | 显示全部楼层
3T万岁(高呼
回复

使用道具 举报

鸭蛋只吃黄 当前离线
帖子
主题
精华
贡献
最后登录
1970-1-1
爱心
积分
5858
钻石
性别
保密
注册时间
2015-7-18
查看详细资料
发表于 2019-3-8 20:18:54 | 显示全部楼层
大喜过望, 感谢 dalao
回复

使用道具 举报

耗子 当前离线
帖子
主题
精华
贡献
最后登录
1970-1-1
爱心
积分
11793
钻石
性别
保密
注册时间
2012-2-18
查看详细资料
发表于 2019-3-8 21:24:59 | 显示全部楼层
关于跨Mod兼容,可以介绍一下Forge模组中的@Optional注解
回复

使用道具 举报

liach 当前离线
帖子
主题
精华
贡献
最后登录
1970-1-1
爱心
积分
3523
钻石
性别
保密
注册时间
2014-4-2
查看详细资料
发表于 2019-3-8 22:58:48 | 显示全部楼层
个人认为盲目依赖forge是硬伤。Minecraft modding很多内容和forge没有关系,甚至很多理念mod和插件可以共享。
回复

使用道具 举报

3TUSK 当前离线
帖子
主题
精华
贡献
最后登录
1970-1-1
爱心
积分
7012
钻石
性别
保密
注册时间
2013-3-8
查看详细资料
 楼主| 发表于 2019-3-9 02:59:55 | 显示全部楼层
liach 发表于 2019-3-8 22:58
个人认为盲目依赖forge是硬伤。Minecraft modding很多内容和forge没有关系,甚至很多理念mod和插件可以共享 ...

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

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

使用道具 举报

3TUSK 当前离线
帖子
主题
精华
贡献
最后登录
1970-1-1
爱心
积分
7012
钻石
性别
保密
注册时间
2013-3-8
查看详细资料
 楼主| 发表于 2019-3-9 03:02:57 | 显示全部楼层
耗子 发表于 2019-3-8 21:24
关于跨Mod兼容,可以介绍一下Forge模组中的@Optional注解

其实很早以前是有写到过 @Optional 的,但后来因为某些原因最终先暂时撤掉了,但原稿还在。

一句话:我(们)需要考虑一下怎么讲 @Optional 最合适……
回复

使用道具 举报

liach 当前离线
帖子
主题
精华
贡献
最后登录
1970-1-1
爱心
积分
3523
钻石
性别
保密
注册时间
2014-4-2
查看详细资料
发表于 2019-3-10 07:34:26 | 显示全部楼层
Optional 个人认为可以和 SideOnly 一起讲解。原理类似 SideOnly 但是服务对象不同 (服务 @APi 接口)
回复

使用道具 举报

猿汐 当前离线
帖子
主题
精华
贡献
最后登录
1970-1-1
爱心
积分
2083
钻石
性别
保密
注册时间
2019-2-15
查看详细资料
头像被屏蔽
发表于 2019-3-10 14:07:27 | 显示全部楼层
...膜拜大佬
回复

使用道具 举报

我是叶辉 当前离线
帖子
主题
精华
贡献
最后登录
1970-1-1
爱心
积分
836
钻石
性别
保密
注册时间
2016-4-28
查看详细资料
发表于 2019-3-10 19:26:18 | 显示全部楼层
感谢楼主大大的教程。
回复

使用道具 举报

hjtest001 当前离线
帖子
主题
精华
贡献
最后登录
1970-1-1
爱心
积分
364
钻石
性别
保密
注册时间
2015-11-20
查看详细资料
发表于 2019-3-14 20:23:54 | 显示全部楼层
楼主,这个是还未完成版么?怎么有好多章节页面打开是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版或之类的离线版本么?
因为那个电子书网页打开奇慢无比,点一个章节有时候几分钟都没出来。
回复

使用道具 举报

3TUSK 当前离线
帖子
主题
精华
贡献
最后登录
1970-1-1
爱心
积分
7012
钻石
性别
保密
注册时间
2013-3-8
查看详细资料
 楼主| 发表于 2019-3-17 02:18:42 | 显示全部楼层
hjtest001 发表于 2019-3-14 20:23
楼主,这个是还未完成版么?怎么有好多章节页面打开是404错误,如下这些都是这样。
5.2.4 红石信号敏感的方 ...

你可以倒回去看一下本贴的说明:
未完成的章节目前会返回 404

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

离线版本——有鉴于整套指南用的是 GitBook,你可以用 GitBook CLI($ npm install gitbook-cli -g)然后用它自己构建:
  1. # 导出 PDF 版本的
  2. $ gitbook pdf ./ ./book-pdf

  3. # 导出 EPUB 版本的
  4. $ gitbook epub ./ ./book-epub
复制代码

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

使用道具 举报

您需要登录后才可以回帖 登录 | 注册(register)

本版积分规则

Archiver|小黑屋|Mcbbs.net ( 京ICP备15023768号-1 ) | 京公网安备 11010502037624号 | 手机版

GMT+8, 2020-7-12 17:43 , Processed in 0.068068 second(s), Total 25, Slave 24 queries, Release: Build.2020.07.08.1452, Gzip On, Redis On.

"Minecraft"以及"我的世界"为Mojang Synergies AB的商标 本站与Mojang以及微软公司没有从属关系

© 2010-2020 我的世界中文论坛 版权所有 本站原创图文内容版权属于原创作者,未经许可不得转载

快速回复 返回顶部 返回列表