维度类型

维度类型（Dimension types）以JSON文件的形式存储在数据包中，文件路径为data/<命名空间>/dimension_type/<维度类型名称>.json。维度类型定义了维度中的世界建筑高度限制，环境光照等。

JSON格式

• 根节点
  • ultrawarm：为true时，水桶无法放出水，湿海绵会变干，熔岩会流动得更快、扩散得更远。
  • natural：为false时，此维度无法使用床睡觉和重置重生点，下界传送门方块不会生成僵尸猪灵，嘎枝之心无法生成嘎枝。
  • coordinate_scale：传送到该维度时的坐标缩放值。取值范围为0.00001到30000000.0的闭区间。
  • has_skylight：该维度是否有天空光照。
  • has_ceiling：该维度是否拥有一个基岩天花板，影响地图的行为。注意这仅仅是逻辑上是否拥有一个天花板，维度是否真的有一个天花板与此无关。
  • ambient_light：该维度拥有多少环境光照，该值越高，渲染得越亮。设置为0.5或更高时，0和15光照等级渲染的方块无异；设置为-2或更低时，低光照等级下只渲染绿色管道^{[需要检查源代码]}；设置为2或更高时，生物阴影会在高光照等级下过浓。
  • fixed_time：（可选）如果设置本字段，该维度的昼夜时间将会固定在这个指定值上。要保持正常的昼夜循环，则不应设置本字段。
  • monster_spawn_light_level：取值为0到15的闭区间。怪物生成位置的最大光照。该光照的计算公式是：雷雨时max( skyLight - 10, blockLight )，其他天气时max( internalSkyLight, blockLight )。
    • 整数提供器，见已配置的地物/int provider[显示]
  • monster_spawn_block_light_limit：取值为0到15的闭区间。怪物生成位置的最大方块光照。
  • piglin_safe：猪灵、猪灵蛮兵和疣猪兽是否不会僵尸化。
  • bed_works：玩家试图使用床时，其是否不会爆炸。
  • respawn_anchor_works：玩家试图使用重生锚时，其是否不会爆炸。
  • has_raids：带有不祥之兆的玩家是否可以触发袭击。
  • logical_height：玩家使用紫颂果或下界传送门可以到达的总高度。不会影响超过该限制高度的既有传送门。取值为0到4064的闭区间，且不能大于height。
  • min_y：该维度中可以存在方块的最低高度。数值必须在-2032至2031之间且为16的整数倍（也就是说，-2032是最小有效值，2016是最大有效值）。
  • height：该维度中可以存在方块的总高度。数值必须在16至4064之间且为16的整数倍。维度中可以存在方块的最大高度值为min_y与height值之和减去1，此值不能超过2031。
  • infiniburn：该维度中火可以在哪些方块上永久燃烧。应当填写一个方块标签的命名空间ID，带有前缀#。
  • effects：（可选，默认为minecraft:overworld）可以是minecraft:overworld、minecraft:the_nether或minecraft:the_end，用于确定该维度的天空效果。设为overworld（主世界）会使维度的天空中出现云、太阳、星星和月亮；设为the_nether（下界）会使维度中有浓厚的迷雾阻挡视野，效果与下界类似；设为the_end（末地）会使维度拥有类似于末地的，黑暗的、斑驳的天空，并无视各生物群系自带的天空颜色与迷雾颜色。

内置维度类型

游戏中包含的内置维度类型：

• overworld：主世界
• the_nether：下界
• the_end：末地
• overworld_caves：主世界洞穴

默认值

以下为各内置维度类型数据的默认值：

属性	主世界	下界	末地	主世界洞穴
ultrawarm	False	True	False	False
natural	True	False	False	True
piglin_safe	False	True	False	False
respawn_anchor_works	False	True	False	False
bed_works	True	False	False	True
has_raids	True	False	True	True
has_skylight	True	False	False	True
has_ceiling	False	True	False	True
coordinate_scale	1.0	8.0	1.0	1.0
fixed_time	未指定	18000	6000	未指定
ambient_light	0.0	0.1	0.0	0.0
min_y	-64	0	0	-64
height	384	256	256	384
logical_height	384	128	256	384
monster_spawn_light_level	0-7	7	0-7	0-7
monster_spawn_block_light_limit	0	15	0	0
infiniburn	#infiniburn_overworld	#infiniburn_nether	#infiniburn_end	#infiniburn_overworld
effects	overworld	the_nether	the_end	overworld

历史

Java版
1.16			pre1				向数据包中加入了维度类型dimension_type。
1.16.2			pre1				维度类型现在使用和数据包中其他资源相同的文件夹结构，从data/minecraft/dimension_type/<命名空间>/<路径>移动到data/<命名空间>/dimension_type/<路径>。
			pre2				shrunk参数被coordinate_scale参数代替了。
1.17			20w49a				加入了min_y和height参数，数值分别在-2048到2047，以及0到4096之间有效。
			21w05a				min_y和height参数的有效区间现在分别从-2048到2047、0到4096，调整到-2032到2031、0到4064。
1.18.2			22w06a				现在infiniburn的值需要有#前缀。
1.19			22w11a				维度类型不再能于维度文件行内定义，必须引用一个dimension_type文件夹下的独立文件。
			pre1				加入了monster_spawn_block_light_limit和monster_spawn_light_level字段。
1.21.4			pre1				现在natural不再控制时钟和指南针是否不会随机转动。

外部链接

• misode.github.io上的维度类型生成器