自定义

  关于1.13前的自定义，请见“自定义/1.13前”。

使用新生成器在主世界生成的诡异森林生物群系。

  本文章介绍的是世界类型。关于彩蛋维度，请见“20w14infinite § 世界生成”。

自定义（Customized）是一种世界类型，它用自定的特性取代了世界的普通地形。相比1.13前的自定义世界，它“与此前的彻底地不同”，“不在屏幕上出现50个意义不明的滑块”，而是借助JSON文件编辑自定义世界。

访问

自定义世界生成使用JSON文件进行，创建世界时可以导入这些文件。

在创建世界菜单中，选定“更多选项”，然后点击“导入世界”按钮。然后，选择用于自定义世界生成的JSON文件，此时会弹出一个警告弹窗，警告该功能目前还处于实验性阶段。点击“是”以继续。接下来，开启“允许作弊”选项，然后就可以开始生成自定义世界了。

当前，访问自定义维度的唯一方法是使用/execute in <维度名称> run tp @s ~ ~ ~命令，这会将玩家传送到指定的维度（请参阅JSON格式）。 在演示文件中，维度为minecraft:use_teleport_command。

JSON格式

主条目：自定义维度

自定义世界的文件存储格式如下：

• 根标签
  •  bonus_chest：可设为true或false，这决定了该世界是否会生成奖励箱。
  •  generate_features：可设为true或false，这决定了该世界是否会自然生成建筑（等同于创建世界时的“生成建筑”选项）。
  •  seed：该世界的种子（数字）。
  •  legacy_custom_options（字符串）：自定义世界的预设值，用来生成旧的自定义世界。只存在于旧的自定义世界中。
  •  dimensions：此世界中维度的列表。运作良好的世界需要minecraft:overworld（主世界）、minecraft:the_nether（下界）和minecraft:the_end（末地）维度，自定义维度允许使用任何其他命名空间ID。
    • 一个维度
      •  type：可以是一组维度的生成选项（列表），或者是默认的维度的命名空间ID值（字符串）。后一种情况下维度会使用指定的默认维度的生成选项。注意：如果多个自定义维度使用了同一个默认维度的ID，游戏会在生成维度时崩溃。
        •  bed_works：可以是true或false。玩家是否可以使用床。‌^{[需要测试]}
        •  ender_dragon（可选）：可以是true或false。该维度是否有一条末影龙的Boss。
        •  has_ceiling：可以是true或false。该维度是否拥有一个基岩天花板。
        •  has_skylight：可以是true或false。该维度是否有天空光照。
        •  has_raids：可以是true或false。带有不祥之兆的玩家是否可以触发袭击。
        •  natural：可以是true或false。‌^{[需要测试]}当为false时，指南针会随机转动。当为true时，下界传送门会生成僵尸猪灵。
        •  piglin_safe：可以是true或false。猪灵和疣猪兽是否不会僵尸化。
        •  respawn_anchor_works：可以是true或false。玩家是否可以使用重生锚。‌^{[需要测试]}
        •  shrunk：可以是true或false。决定了维度是否和下界一样，被当做8米/方块看待。‌^{[需要测试]}
        •  ultrawarm：可以是true或false。维度是否表现得类似于下界（水会蒸发，海绵会干）。这也会使得熔岩流动更快、扩散更远。‌^{[需要测试]}
        •  fixed_time：可以是false或任意0至24000之间的整数。如果将它设为一个数字，游戏内的昼夜时间将会固定在这个指定值上。然而，至少在某些世界中，‌^{[需要测试]}false被当做0来解释，故而产生了一个固定不动的日出。要确保正常的昼夜循环，请将此属性保留为undefined（即不写该字段）。
        •  logical_height：玩家使用紫颂果或下界传送门可以到达的最大高度。不会影响现有的传送门。‌^{[需要测试]}
        •  ambient_light：该维度拥有多少光照，在demo文件中，默认是0.5（需要测试上下界及精确的效果‌^{[需要测试]}）。
        •  biome_zoomer：可以是FuzzyOffsetConstantColumnBiomeZoomer（用于主世界）或FuzzyOffsetBiomeZoomer（用于下界或末地），该标签可选。‌^{[需要测试]}
        •  infiniburn：一个方块标签的命名空间ID，决定该维度中火可以在什么方块上永久燃烧。
      •  generator：维度的生成设置。
        •  type：世界生成器的ID。
        • 其他组件（见下）

生成器类型

 generator标签的格式取决于生成器的ID（ type）。

当生成器ID类型是minecraft:noise时：

•  generator: 维度使用的生成设置。
  •  type：生成器ID，此情形下为minecraft:noise。
  •  seed：用于生成该维度的种子。大部分情况下，这个值与世界种子一致，但是可以与其不一样，不一样的时候该维度就会使用这个值作为种子生成，而不是世界种子。 ‌^{[需要测试]}
  •  settings：地形的形状。可以设为一个字符串以使用预设，或者可以设为一个包括自定义选项列表的复合标签。使用字符串值时，settings对象可以设定为一系列默认设置，包括minecraft:overworld用于生成普通的主世界、minecraft:amplified用于生成放大化的主世界、minecraft:nether生成常规的下界、minecraft:caves生成类似下界却拥有主世界地形特征的世界、minecraft:end生成末地主岛和minecraft:floating_islands生成末地浮岛。
    •  bedrock_roof_position：从世界高度至基岩天花板的顶部基岩坐标的距离，如果它超出了0-255的界，天花板就不会出现在世界中。例如，将其设置为32，天花板的顶部就会出现在y=224处。就算天花板设置得很低，自然地形依旧会在其上生成‌^{[需要测试]}
    •  bedrock_floor_position：基岩地板的Y坐标，和bedrock_roof_position很像。同时将天花板和地板的值设置为255将会在世界最底部生成一层单层基岩。‌^{[需要测试]}
    •  sea_level：海平面高度。在0和255之间。
    •  disable_mob_generation：可以为true或false。‌^{[需要测试]}
    •  structures：结构设置。
      •  stronghold（可选）：要塞的生成设置。
        •  count：要塞的最大数量，有效范围为1-4095，默认值为128。如果不希望生成要塞，可以删除整个 stronghold标签。
        •  spread：第一个环的要塞数量，有效范围为0-1023，默认值为3。设置为0时会使世界中某些位置上反复生成多个要塞。‌^{[需要测试]}到达最大数量前，第i个环的要塞数量为s + s*2/i，其中s为第i-1个环的要塞数量，除法向下取整。
        •  distance：控制各环到原点的距离（第i个环到原点的平均距离为该值的6i-2倍），单位为区块，有效范围为0-1023，默认值为32。
      •  structures：该维度中使用的结构。
        •  <命名空间ID>：该字段的键应该为一个结构的命名空间ID，Java版数据值 §结构处有一个它们的列表。如果没有在此列出结构，biome_source > type指定的维度默认结构就会以一个极大的增率生成在它们平常所自然生成的生物群系中。故而对于非超平坦世界，所有的结构都应在此罗列清楚以避免不稳定的生成。
          •  spacing（数字）：以区块为单位，两个该种类的结构之间的最大距离。
          •  separation（数字）：以区块为单位，两个该种类的结构之间的最小距离；必须比spacing小。
          •  salt（整数）：‌^{[需要测试]}帮助进行随机化的数字；参见盐 (密码学)。
    •  noise：世界生成参数。
      •  top_slide：世界地形的顶部曲线的设置。
        •  target（整数）：曲线的负对数曲率。负值会使影响区域内的山丘更加圆润，正值会使其更加平坦。绝对值越大效果越明显。
        •  size（整数）：定义了以世界地形顶部为中心的影响区域大小。size由以下公式计算size = <以方块为单位的高度> * 0.25 / size_vertical
        •  offset（整数）：从世界地形顶部移动影响区域。offset使用和size相同的公式，故而offset = <以方块为单位的高度> * 0.25 / size_vertical。对于top_slide，正值向下移动，负值向上移动。
      •  bottom_slide：世界地形的底部曲线的设置。
        •  target（整数）：曲线的负对数曲率。负值会移除基岩地板并使浮岛的底部更加圆润，正值会生成一个基岩地板。绝对值越大效果越明显。
        •  size（整数）：定义了以世界地形底部为中心的影响区域大小。和在top_slide中使用的公式相同。
        •  offset（整数）：从世界地形底部移动影响区域。和在top_slide中使用的公式相同。对于bottom_slide，正值向上移动，负值向下移动。
      •  sampling：‌^{[需要测试]}
        •  xz_scale（双精度浮点数）：伸缩X和Z轴的噪声。更大的值会造成更复杂的水平形状。
        •  xz_factor（双精度浮点数）：平滑水平方向上的噪声。
        •  y_scale（双精度浮点数）：伸缩Y轴的噪声。更大的值会造成更复杂的垂直形状。
        •  y_factor（双精度浮点数）：平滑垂直方向上的噪声。
      •  size_vertical（整数）：改变陆块在Y轴上的比例。1至15之间的值可以逐渐地增加山丘高度，大于20的值将会使得所有陆地高于通常的海平面63，比32更高的值会使得通常的陆地高度到达100+。‌^{[需要测试]}
      •  size_horizontal（整数）：改变陆块在X和Z轴上的比例，生物群系不会因此改变。‌^{[需要测试]}
      •  height（整数）：通过竖直压缩整个世界来改变世界生成的最大高度。例如，当height=128时，陆地会从Y=32处从海中裸出。‌^{[需要测试]}
      •  density_factor（双精度浮点数）：‌^{[需要测试]}
      •  density_offset（双精度浮点数；值域为-1至1）：影响平均陆地高度（非海平面）。‌^{[需要测试]}
      •  random_density_offset（布尔值；可选）：‌^{[需要测试]}
      •  simplex_surface_noise（布尔值）：‌^{[需要测试]}
      •  island_noise_override（布尔值；可选）：决定该世界是否会像末地一样，以小岛环绕着主岛的形式生成。
      •  amplified（布尔值；可选）：在放大化和正常地形生成之间切换。可与“vanilla_layered”类型以及任何维度（下界、末路之地和自定义）的巨型生物群系一起使用。
    •  default_block：决定世界地形顶部下方生成的方块；参见Java版数据值 §方块
      •  Name：方块ID
      •  Properties：方块状态
        •  state（字符串）：方块状态键值对。
    •  default_fluid：海洋与湖泊所使用的方块；参见Java版数据值 §流体.
      •  Name（字符串）：方块ID
      •  Properties：方块状态
        •  state（字符串）：方块状态键值对。
  •  biome_source：设置要生成的生物群系和其形状。
    •  seed（长整型数）：用来生成生物群系的种子。在大多数情况下，这与维度种子完全相同（甚至与世界种子完全相同），但也可能不同，并且该维度中的该生物群系将基于此种子而不是维度种子生成。‌^{[需要测试]}
    •  type（字符串）：生物群系生成类型。参数位于“biome_source”复合标签中。type的一些可选值包括minecraft:vanilla_layered、minecraft:fixed、minecraft:checkerboard、minecraft:multi_noise和minecraft:the_end。‌^{[需要更多信息]}
      • vanilla_layered：主世界中使用的默认生成和巨型生物群系生成。
        •  large_biomes（布尔值）：决定生物群系的规模。值为true时生物群系将生成为“巨型生物群系”世界类型。
        •  legacy_biome_init_layer（布尔值）：决定世界是否为default_1_1。‌^{[需要测试]}
      • multi_noise：用于下界三维生物群系生成。‌^{[需要测试]}
        •  preset（字符串）：要使用的一组生物群系预设，与 biomes互斥‌‌^{[需要测试]}当前唯一支持的有效值是minecraft:nether。
        •  biomes：生物群系列表，以及它们的生成概率。
          • ：生物群系及其属性
            •  biome（字符串）：生物群系。
            •  parameters：生物群系属性。
              •  altitude（单精度浮点数）：‌^{[需要测试]}
              •  weirdness（单精度浮点数）：‌^{[需要测试]}
              •  offset（单精度浮点数）：‌^{[需要测试]}
              •  temperature（单精度浮点数）：影响雨雪、树叶与草的颜色，详见生物群系 §生物群系颜色。
              •  humidity（单精度浮点数）：‌^{[需要测试]}
      • the_end：用于在末路之地中生成的生物群系，以生物群系minecraft:the_end为中心，周围环绕着其它生物群系。‌^{[需要测试]}
      • fixed：单生物群系维度。
        •  biome：该维度所使用的生物群系。
      • checkerboard：一种生物群系生成方式，其中每个生物群系单元呈正方形（或接近正方形），并沿对角线重复排列。
        •  biomes：沿着对角线重复的生物群系列表（可以超过3个）。
        •  scale：确定指数规模上正方形单元的大小。

当生成器ID类型是minecraft:flat（用于生成超平坦世界地形）时：

•  generator：维度使用的生成设置。
  •  type：生成器的ID，此情形下为minecraft:flat。
  •  settings：超平坦设置。
    •  layers：层设置。
      • ：一个超平坦的层。此列表自上而下解释。
        •  height：该层竖直上的方块数量。
        •  block：该层使用方块。
    •  biome：该维度使用的单一生物群系。
    •  structures：结构生成设置。
      •  <structure name>：用20w21a之前的预设生成的一种结构。该复合标签包含预设中设置的参数。不会更改有关结构生成的任何内容，但由于旧的预设而设置于此。
      •  structures：此维度中要使用的结构列表。
        •  <命名空间ID>：该字段的键应该为一个结构的命名空间ID，Java版数据值 §结构处有一个它们的列表。[注：与非超平坦世界相反，若不列出任何结构，那么所有结构皆不会生成]
          •  spacing：目的不明。当用末地城进行测试时，任何10或更低的值都不会生成此结构。（数字）‌^{[需要测试]}
          •  separation：结构间距，单位是？（可能是区块），最小值、最大值或是平均值？（数字）‌‌^{[需要测试]}
          •  salt：‌^{[需要测试]}帮助进行随机化的数字；参见盐 (密码学)。

当生成器ID类型是minecraft:debug时（用于生成调试世界时）：‌^{[需要更多信息]}

•  generator：维度使用的生成设置。
  •  type：生成器的ID，此情形下为minecraft:debug。

历史

Java版
1.8		2014年4月22日			自定义世界的预览视频在TeamMojang的Youtube频道放出。
		14w17a			加入自定义世界类型。
		14w25a			海底神殿的生成可被自定义。
1.8.2		1.8.2-pre7			自定义世界中草方块的生成现在与海平面保持一致。
1.13		18w06a			暂时移除了自定义世界。
					之前版本创建的自定义世界不再被加载。
		2018年5月15日			Erik Broes在Reddit上指出自定义世界将会“在1.13之后”回归，但“与此前的彻底地不同”，“不会再在屏幕上出现50个意义不明的滑块。”
2019年4月10日					Helen Zbihlyj称1.14不会重新加入自定义世界。
1.16		20w21a			重新加入了自定义世界。
					自定义世界现在由JSON文件驱动。
					现在可添加自定义维度，而原版已有的维度也可进行调整。
					目前自定义世界只能通过导入JSON文件来生成，而调整世界的菜单尚未加入游戏。
		pre1			自定义世界现在由数据包驱动。
Java版（即将到来）
1.16.2		20w28a			自定义世界现在可以自定义生物群系。

漏洞

关于“自定义”的漏洞由漏洞追踪器维护，请在此汇报漏洞。

参考

环境

参见：Template:Environment/content [编辑]