自定义维度

  本文章介绍的是数据包内容。关于其他含义，请见“维度”。

自定义维度（Custom Dimension）是位于数据包中用于定义世界的新维度的JSON文件。这些维度可以通过运行/execute in <维度> run teleport <坐标>到达。所有维度在世界被打开时即全部加载，而不是在世界重新加载时；这也意味着所有对这些维度文件的修改必须要重新打开世界来生效，而不仅仅是运行/reload命令。

用途

新的维度以JSON文件的形式存储在数据包的data/<命名空间>/dimension/<维度名称>.json内。

维度语法

• 根标签。
  •  type：维度类型的命名空间ID。可以是预设的minecraft:overworld、minecraft:overworld_caves、minecraft:the_nether或minecraft:the_end，也可以是自定义的维度类型（需自行使用JSON文件配置，详见维度类型段落）。
  •  generator：维度的生成设置。
    •  type（字符串）：生成器的ID。前缀是minecraft:，之后是flat、noise或debug。
    • 其他组件（见下）

生成器类型

• •  type：生成器的ID。可以为noise、flat或debug。

    当 type是minecraft:noise时，附加参数如下：

  •  settings：地形生成器中使用的噪声设置。可以为一个噪声设置ID或一个噪声设置对象。
  •  biome_source：设置要生成的生物群系及其形态。
    •  type：生物群系生成类型。可以为minecraft:vanilla_layered、minecraft:fixed、minecraft:checkerboard、minecraft:multi_noise和minecraft:the_end。

      如果type为multi_noise（用于下界和21w37a之后版本的主世界），附加的参数如下：

    •  preset：（与 biomes互斥）要使用的一组生物群系原版预设。可以是nether或overworld
    •  biomes：（与 preset互斥）（不能为空）生物群系列表，包括其目标噪声参数。
      • ：一个生物群系及其属性。
        •  biome：一个生物群系ID。一个生物群系ID可以重复多次以带有不同参数。
        •  parameters：代表应该放置生物群系的最理想条件。这些值不会影响生物群系内的地形生成，而是影响游戏在何处选择安放这些生物群系。在每个特定点，都会选择一个与这一点在各个噪声图上的参数最接近的生物群系。例如，如果某一点的温度为-1，湿度为0.2，海拔为0.5，怪异度为0，那么则会选择桦木森林丘陵（温度-0.1、湿度0.2、海拔0.25、怪异度0）而不是沙漠（温度0.5、湿度-0.5、海拔0、怪异度0）。列表中的每一组参数组合必须独一无二，否则只生成其中第一项的生物群系。
          • 生物群系噪声值参数

      如果type为the_end（原版中末地的生物群系生成方式。以生物群系minecraft:the_end（末地）为中心，周围环绕着其他生物群系），没有附加参数。

      如果type为fixed（单一生物群系。），附加的参数如下：

    •  biome：生成的单一生物群系的ID。

      如果type为checkerboard（每个生物群系单元呈正方形或近似正方形，并沿对角线重复排列），附加的参数如下：

    •  biomes：沿着对角线重复的生物群系列表。可以为一个生物群系ID或一个生物群系标签，或者一个生物群系ID的列表。
    •  scale：（可选，默认为2）在指数尺度上确定正方形的大小。取值范围为0到62的闭区间。

    当 type是minecraft:debug（用于生成调试模式维度）时，没有附加参数。

    当 type是minecraft:flat（用于生成超平坦地形）时，附加参数如下：

  •  settings：超平坦设置。
    • 超平坦生成器设置

维度类型

维度类型设置以JSON文件的形式存储在数据包的data/<命名空间>/dimension_type/<维度类型名称>.json内。

语法

• 根标签
• 自定义维度/Data

默认值

这些是原版中的3个维度使用的设置。

属性	主世界	下界	末地
ultrawarm	false	true	false
natural	true	false	false
coordinate_scale	1.0	8.0	1.0
piglin_safe	false	true	false
respawn_anchor_works	false	true	false
bed_works	true	false	false
has_raids	true	false	true
has_skylight	true	false	false
has_ceiling	false	true	false
fixed_time	不适用	18000	6000
ambient_light	0.0	0.1	0.0
min_y	-64	0	0
height	384	256	256
logical_height	384	128	256
infiniburn	#minecraft:infiniburn_overworld	#minecraft:infiniburn_nether	#minecraft:infiniburn_end

历史

Java版
1.16		pre1			向数据包中加入了dimension和dimension_type。
1.16.2		20w29a			自定义世界的噪声设置从dimension移动至worldgen。
		pre1			自定义维度现在使用和数据包中其他资源相同的文件夹结构：<命名空间>/<类型>/<资源>.json。
		pre2			自定义维度类型中的 shrunk参数被 coordinate_scale参数代替了。

漏洞

Template:Issue list