用户:MashKJo/1.12.2模组开发笔记/实现新维度 - 版本历史

MashKJo：/* 实现populate方法 */

2024-10-22T05:45:23Z

实现populate方法

←上一版本		2024年10月22日 (二) 13:45的版本
第336行：		第336行：

	由此可见，在主世界的区块生成过程中，只有通过WorldGenerator生成的结构的生成过程才可以通过监听事件来精确地干涉。在你自己的区块生成类中，你实现这个方法的时候，你可以不发布任何事件，但如果你要考虑你的模组和其他干涉世界生成的模组的交互的话，那么你最好还是把这些事件的发布都给加上。		由此可见，在主世界的区块生成过程中，只有通过WorldGenerator生成的结构的生成过程才可以通过监听事件来精确地干涉。在你自己的区块生成类中，你实现这个方法的时候，你可以不发布任何事件，但如果你要考虑你的模组和其他干涉世界生成的模组的交互的话，那么你最好还是把这些事件的发布都给加上。

			=== 等等：我要做的维度的世界生成特性和主世界完全不一样啊！ ===
			的确，上述笔记仅仅是简单地说了一下如何生成一个类似于主世界的维度。

			不过读者也该学会变通，比如如果你要创建一个全是空岛的维度，那么你就该去参考天境模组中的天境维度或深渊国度模组中的奥穆索维度的ChunkGenerator代码。

			如果你要创建一个整个世界都是无边无际的建筑的维度（这种维度最常见的例子就是魔法金属模组中的亡灵古墓），那么你可以考虑先把每一种房间都硬编码出来，再通过一定的算法计算出这些房间各自的生成权重，最后把这些东西体现在generateChunk中即可。

			如果你要创建一个整个世界只有一个建筑、其他地方全是虚空的维度（这种维度最常见的例子是虚无世界模组中的远古神殿），那么你可以考虑直接硬编码，也可以利用WorldGenerator在populate方法中生成该建筑。

			如果……

			总而言之，读者应该尽量变通。如果读者明明用手写代码的方式开发模组，却在遇到世界生成这种非常复杂的部分时，总期望着有一招能吃遍天下鲜，那我的评价是：不如去用MCreator。手写代码真是难为你了。

	== 注释与外部链接 ==		== 注释与外部链接 ==

MashKJo：/* 实现populate方法 */

2024-10-22T05:13:38Z

实现populate方法

←上一版本		2024年10月22日 (二) 13:13的版本
第323行：		第323行：

	==== 实现populate方法 ====		==== 实现populate方法 ====
			在原版的主世界区块生成类中，Forge在这里patch了三个事件。
			* PopulateChunkEvent.Pre
			* PopulateChunkEvent.Populate
			* PopulateChunkEvent.Post

			实现该方法大致的流程是：
			* 令BlockFalling.fallInstantly的值为true
			* 执行PopulateChunkEvent.Pre事件
			* 生成除了洞穴和峡谷以外的大型结构，之后反复判断PopulateChunkEvent.Populate事件，这用来决定那些由WorldGenerator控制的结构是否生成，且这段时间还会调用Biome类的decorate实例方法
			* 执行PopulateChunkEvent.Post事件
			* 令BlockFalling.fallInstantly的值为false

			由此可见，在主世界的区块生成过程中，只有通过WorldGenerator生成的结构的生成过程才可以通过监听事件来精确地干涉。在你自己的区块生成类中，你实现这个方法的时候，你可以不发布任何事件，但如果你要考虑你的模组和其他干涉世界生成的模组的交互的话，那么你最好还是把这些事件的发布都给加上。

	== 注释与外部链接 ==		== 注释与外部链接 ==

MashKJo：/* 实现generateChunk方法 */

2024-10-22T04:49:48Z

实现generateChunk方法

←上一版本		2024年10月22日 (二) 12:49的版本
第277行：		第277行：
	==== 实现generateChunk方法 ====		==== 实现generateChunk方法 ====
	最难以理解的部分要来了。		最难以理解的部分要来了。

			这一部分，笔者只能说尽力地为读者讲解了，因为笔者对这一部分也只是一知半解。其实大部分Modder对这部分估计也不懂，很多模组的这块代码几乎就是照搬原版。因为Mojang在这块的代码写得实在是太抽象了，就连MCP都无法反混淆这些离谱的局部变量。我估计MC圈子里能完全看懂这些代码的只有Mojang员工和极少数社区开发者了。

			所以，这部分的代码，如果读者不想听原理，且自己做的维度的地形生成和主世界差不多的话，直接去GitHub上一些模组的源代码仓库Copy + Paste就可以了（当然请注意这么做可能会引发一些版权问题，请先看好哪些模组采取限制宽松的开源协议，不过话说回来，大家这块的代码都是抄的原版代码，真的会有人去追究这种事情吗）。

	实现generateChunk方法，大概是这样的：		实现generateChunk方法，大概是这样的：
第303行：		第307行：

	然后，新建一个ChunkPrimer对象。再接连调用三个方法：generateHeightMap、setBlocksInChunk和replaceBiomeBlocks。这三个方法都用private修饰，实际上这体现了ChunkPrimer对象写入数据的一些步骤，你当然也可以把这三个方法的代码全塞在generateChunk这个方法里，但是完全没必要。把这些代码分成三个方法，更能体现代码模块化的原则。		然后，新建一个ChunkPrimer对象。再接连调用三个方法：generateHeightMap、setBlocksInChunk和replaceBiomeBlocks。这三个方法都用private修饰，实际上这体现了ChunkPrimer对象写入数据的一些步骤，你当然也可以把这三个方法的代码全塞在generateChunk这个方法里，但是完全没必要。把这些代码分成三个方法，更能体现代码模块化的原则。

			然后，就开始进行结构的生成了。

			这一切工作都做完后，便可以构造Chunk对象了。但是别急着返回该对象——我们还需要调用Chunk类的generateSkylightMap实例方法，然后才能返回。如果你不这么做，你会发现，进入你的新维度后，维度的TPS和FPS都非常低，整个维度也非常昏暗，且如果你什么都不做，整个维度都不能生成生物；但如果你放置了一个方块，那么该方块所在的区块会疯狂生成生物，很可能造成Memory Leak。
	===== generateHeightMap =====		===== generateHeightMap =====
			通常你需要用到generateNoiseOctaves方法，但接下来的事笔者也不懂了，请自行去GitHub上找现成的代码看吧。

	===== setBlocksInChunk =====		===== setBlocksInChunk =====
			原版主世界的区块生成类中，这个方法的代码是最抽象的。它有一个六重循环，循环里有大量意义不明的局部变量，最内层循环还有让人十分看不懂的一些if语句。同样建议直接去参考别人的代码。不过如果你真的想搞明白其中的原理的话，推荐去看交错次元模组的ChunkGeneratorBetweenlands源代码，在其中，setBlocksInChunk中的每个局部变量都有了意义明确的名字，只能说Angry Pixel牛逼！

	===== replaceBiomeBlocks =====		===== replaceBiomeBlocks =====
			这个方法的代码逻辑相对来说还算简单，原版主世界区块生成类中，Forge在这个方法的开头patch进去了一个事件，借此你可以操控主世界的表层方块替换。也建议在你的区块生成类中加上对于这个事件的判断。

			这个方法中<code>surfaceNoise</code>开始发力，然后又是一个二重循环，在其中调用Biome类的genTerrainBlocks实例方法。

	==== 实现populate方法 ====		==== 实现populate方法 ====

	== 注释与外部链接 ==		== 注释与外部链接 ==

MashKJo：/* 实现generateChunk方法 */

2024-10-22T04:09:24Z

实现generateChunk方法

@@ 第276行： / 第276行： @@
 ==== 实现generateChunk方法 ====
 ===== generateHeightMap =====
 ===== setBlocksInChunk =====
-===== 计算天空光照分布 =====
+===== replaceBiomeBlocks =====
 ==== 实现populate方法 ====
 == 注释与外部链接 ==

MashKJo：/* 声明与初始化变量 */

2024-10-22T03:49:05Z

声明与初始化变量

@@ 第175行： / 第175行： @@
   private MapGenBase structureGenerator1 = new ...;
   ...
   private Biome[] biomesForGeneration;
+  {
@@ 第193行： / 第202行： @@
       this.noiseGeneratorN = new NoiseGeneratorPerlin(this.rand, ...);
       ...
+  }
@@ 第226行： / 第238行： @@
 读者可能会感到奇怪：不是说维度的区块生成没有通用程式吗？当然没有，只不过这些代码在许多模组的新维度区块生成类中都能找到，甚至连参数值都不改的，它们应该都是借鉴于原版主世界生成的相关代码。这里我们可以注意到，只有地表噪音的类型是NoiseGeneratorPerlin。
 然后是一个World类型的变量，这也显得理所应当——这个类中当然要有一个World实例了。
@@ 第232行： / 第256行： @@
 然后就是声明了一大堆MapGenBase子类变量，这些主要用于生成大型结构。这些变量一般在声明之时就初始化，然后在初始化块中再赋值——赋的这个值，笔者也不懂其具体含义，这块读者直接参阅原版的相关源代码，就知道怎么填了。
 然后是一个Biome数组，它用于存储该维度中所有的生物群系种类，并在generateChunk阶段以此为依据替换表层方块。如果你的维度中只有一个生物群系，那么这个Biome数组完全没必要声明，你直接在generateChunk里面向结果编程就好了。
 最后说一句，区块生成类的构造器并没有对形参列表的强制要求（不像TileEntity和Entity，前者要求有一个零参构造器，后者要求有一个形参只有一个World类型参数的构造器），因此这里传入什么参数就完全看你个人的需求了。

MashKJo：/* 声明与初始化变量 */

2024-10-22T03:19:14Z

声明与初始化变量

@@ 第202行： / 第202行： @@
 然后，便是声明了一大堆噪声算法相关的变量。读者可能会被他们镇住。NoiseGeneratorOctaves使用的是八度噪声算法，NoiseGeneratorPerlin使用的是柏林噪声算法，这两种算法到底是怎么回事，读者可以自行查阅，笔者在这里就不讲了——因为讲了也没用，因为Minecraft早就用NoiseGeneratorOctaves和NoiseGeneratorPerlin这两个类把这两个算法的计算过程封装好了。这两种算法都具有伪随机特性，可以看到：我们都传入了this.rand，而this.rand的seed是当前的世界种子，那也就保证了相同的世界种子生成的两个世界中，该维度的地形生成是一样的。这些噪声变量用于生成高度分布图。
 然后是一个World类型的变量，这也显得理所应当——这个类中当然要有一个World实例了。
@@ 第210行： / 第234行： @@
 然后是一个Biome数组，它用于存储该维度中所有的生物群系种类，并在generateChunk阶段以此为依据替换表层方块。如果你的维度中只有一个生物群系，那么这个Biome数组完全没必要声明，你直接在generateChunk里面向结果编程就好了。
 ==== 实现generateChunk方法 ====
 ===== generateHeightMap =====

MashKJo：/* 维度区块生成的一般步骤 */

2024-10-22T02:53:12Z

维度区块生成的一般步骤

@@ 第199行： / 第199行： @@
 的确，如果没有清晰的教程指引的话，任何人在初学这块的时候很容易在第一步就卡住——那为什么会卡住呢？还不是因为不知所谓的变量太多了！让我们先来理一理。
 ==== 实现generateChunk方法 ====
 ===== generateHeightMap =====

MashKJo：/* 声明与初始化变量 */

2024-10-22T02:34:59Z

声明与初始化变量

@@ 第163行： / 第163行： @@
 === 维度区块生成的一般步骤 ===
 ==== 声明与初始化变量 ====
 ==== 实现generateChunk方法 ====

MashKJo：/* 维度区块生成的一般步骤 */

2024-10-22T02:17:53Z

维度区块生成的一般步骤

←上一版本		2024年10月22日 (二) 10:17的版本
第162行：		第162行：

	=== 维度区块生成的一般步骤 ===		=== 维度区块生成的一般步骤 ===
	~~TODO~~		==== 声明与初始化变量 ====

			==== 实现generateChunk方法 ====
			===== generateHeightMap =====

			===== setBlocksInChunk =====

			===== 计算天空光照分布 =====

			==== 实现populate方法 ====

	== 注释与外部链接 ==		== 注释与外部链接 ==

MashKJo：/* 维度区块生成的一般步骤 */

2024-10-21T12:10:06Z

维度区块生成的一般步骤

←上一版本		2024年10月21日 (一) 20:10的版本
第162行：		第162行：

	=== 维度区块生成的一般步骤 ===		=== 维度区块生成的一般步骤 ===
			TODO

	== 注释与外部链接 ==		== 注释与外部链接 ==

用户:MashKJo/1.12.2模组开发笔记/实现新维度 - 版本历史

MashKJo：​/* 实现populate方法 */

MashKJo：​/* 实现populate方法 */

MashKJo：​/* 实现generateChunk方法 */

MashKJo：​/* 实现generateChunk方法 */

MashKJo：​/* 声明与初始化变量 */

MashKJo：​/* 声明与初始化变量 */

MashKJo：​/* 维度区块生成的一般步骤 */

MashKJo：​/* 声明与初始化变量 */

MashKJo：​/* 维度区块生成的一般步骤 */

MashKJo：​/* 维度区块生成的一般步骤 */

MashKJo：/* 实现populate方法 */

MashKJo：/* 实现populate方法 */

MashKJo：/* 实现generateChunk方法 */

MashKJo：/* 实现generateChunk方法 */

MashKJo：/* 声明与初始化变量 */

MashKJo：/* 声明与初始化变量 */

MashKJo：/* 维度区块生成的一般步骤 */

MashKJo：/* 声明与初始化变量 */

MashKJo：/* 维度区块生成的一般步骤 */

MashKJo：/* 维度区块生成的一般步骤 */