维度¶

维度（Dimension）是Minecraft基岩版中相互独立的世界空间。每个维度拥有各自的地形、天气、光照规则和独立的方块与实体数据。基岩版原版包含三个维度；在国际版和中国版中，自定义维度分别由不同的数据驱动格式和接口体系提供。

原版维度¶

主世界¶

主世界（Overworld）是玩家默认出生和活动的维度，也是内容最丰富的维度。主世界的Y轴范围为-64至319（基游戏版本1.18.0及以上），拥有昼夜交替和天气系统。主世界包含最多种类的生物群系，从地表的平原、森林、海洋到地下的洞穴和深暗之域。

下界¶

下界（Nether）是一个充满岩浆和危险生物的维度，Y轴范围为0至255，有效建造高度为0至127。下界没有昼夜交替和天气系统，光照环境固定。下界中水无法放置（会立即蒸发），床和重生锚具有特殊行为。主世界的1格距离对应下界的8格距离，这一坐标比例常被用于快速旅行。

末地¶

末地（The End）是一个由虚空中的浮岛组成的维度，Y轴范围为0至255。末地没有昼夜交替和天气系统。末地的中心岛是末影龙的栖息地，外围浮岛上分布着末地城和紫颂花等结构和植被。

维度间传送¶

玩家通过传送门（Portal）在维度之间移动：

下界传送门：由黑曜石框架和火构成，连接主世界和下界。
末地传送门：位于要塞中，连接主世界和末地。
末地折跃门：连接末地中心岛与外围浮岛。

此外，/tp命令也可以直接将实体传送至指定维度的指定坐标。

自定义维度¶

基岩版的国际版和中国版分别采用独立的自定义维度方案。两者的文件夹、JSON结构、可配置内容和运行时接口均不相同，不能将一方的格式直接迁移到另一方使用。

国际版数据驱动自定义维度¶

国际版支持通过行为包中的dimensions/目录定义自定义维度。该类文件使用minecraft:dimension结构声明维度标识符，并通过组件描述维度的部分属性。当前公开的维度定义主要包含以下内容：

维度标识符：自定义维度的赋命名空间标识符。
维度边界：通过minecraft:dimension_bounds设置维度的垂直边界。
维度生成器：通过minecraft:generation设置维度使用的生成器类型。

国际版附加包维度能力边界和字段级说明可参见附加包/维度与参考/维度定义。

注意

国际版数据驱动维度定义并不等同于完整的世界生成器配置。当前公开格式不提供中国版netease:biome_source式的生物群系源配置，也不提供完整自定义光照规则和天气系统的能力。这些方面仍受引擎硬编码行为或其他独立数据驱动系统限制。

脚本API自定义维度¶

国际版脚本API近年来新增了实验性的自定义维度接口。@minecraft/server中的DimensionRegistry.registerCustomDimension可在system.beforeEvents.startup阶段注册新的自定义维度类型。该接口目前属于预发布或实验性API，需要对应版本和实验性脚本API支持。

脚本API注册的自定义维度用于创建由脚本管理的目标空间。现阶段该接口注册的是虚空生成器维度，通常需要脚本在维度中放置平台、结构或其他内容，并处理传送、常加载区域和初始化逻辑。它不同于数据驱动维度JSON，也不同于中国版模组SDK接口。

网易数据驱动自定义维度¶

中国版提供了独立的网易数据驱动自定义维度格式。该格式的文件位于附加包behavior/netease_dimension/目录中，而不是国际版的dimensions/目录。新增维度通常以维度ID命名JSON文件，修改原生维度则使用overworld.json、nether.json或the end.json等文件名。

网易数据驱动维度文件使用netease:dimension_info作为根内容，其components字段可配置中国版专有组件，例如：

netease:dimension_type：指定维度类型。
netease:generator_noise、netease:generator_flat、netease:generator_legacy：指定生成器。
netease:spawn_biomes：指定出生可用生物群系列表。
netease:biome_source：配置该维度的生物群系源。
netease:ban_vanilla_structure等组件：控制原版结构生成。

这些组件和国际版minecraft:dimension格式没有对应关系。特别是netease:biome_source属于中国版网易数据驱动能力，不能写入国际版数据驱动维度文件。

模组SDK维度接口¶

中国版还通过模组SDK提供维度相关运行时接口，用于实体切换维度、地图维度数据处理、加载区块查询等运行时逻辑。这类接口属于中国版模组SDK的Python接口体系，不属于国际版脚本API，也不属于网易数据驱动JSON本身。

因此，中国版自定义维度开发通常同时涉及网易数据驱动配置和模组SDK接口：前者描述维度和生成规则，后者处理运行时传送、存档更新或服务端逻辑。二者均与国际版附加包数据驱动和脚本API保持独立。

维度与存档¶

每个维度的数据在存档中独立存储。区块数据、实体数据和方块实体数据均以维度为单位组织。当玩家不在某个维度时，该维度中除常加载区域以外的区块不会被加载和更新。