# 自定义维度

# 声明新维度

引擎中默认带有overworld，nether，the end三个原生维度，以及编号为3到20的自定义维度，可以直接使用。

此外，还可以通过配置添加编号为22到2147483647的新自定义维度：

1. addon目录中的behavior目录下新增netease_dimension文件夹

2. 添加一个以维度id命名的json文件：

   如dm23333.json：

   复制 json

   {
      "format_version": "1.14.0",
      "netease:dimension_info": {
        "components": {	//必须有这个字段
        }
      }
   }
   

   可以使用以下python代码来生成一个随机的维度id：

   复制 python

   import random, sys
   print random.randint(22, sys.maxint)
   

对于三个原生维度以及18个自带的自定义维度，也可以配置相应文件名的json（注：三个原生维度对应的文件名分别为：overworld.json，nether.json，the end.json，请勿使用维度id命名），编写components字段来修改他们的属性，但是一些属性无法对原生维度修改，详见下面的说明。

# 维度配置

components中可以配置的组件如下：

使用白名单，只允许生成沉船和要塞，其他所有原版结构都不生成，结构名称和/locate (opens new window)指令中的相同。

"netease:ban_vanilla_structure": {
  "allowlist": ["ancient_city", "stronghold"]
}

使用黑名单，除了不生成废弃传送门和海底神殿外，其他原版结构正常生成。

"netease:ban_vanilla_structure": {
  "blocklist": ["ruined_portal", "monument"]
}

注意，allowlist和blocklist只允许配置其中一个，都不配置则默认屏蔽所有原版结构，例如CustomBiomesMod中的dm23333.json：

{
  "format_version": "1.14.0",
  "netease:dimension_info": {
    "components": {
      "netease:dimension_type": "minecraft:overworld",	//类型为主世界
      "netease:generator_noise": {},	//使用噪声生成器
      "netease:spawn_biomes": ["dm23333_ice_plains"],	//玩家会在冰原下出生
      "netease:ban_vanilla_structure": {}	//屏蔽所有原版结构
    }
  }
}

注：

• 自定义末地推荐在群系中配置不生成末影龙及相关逻辑（参考：群系地貌），即使开了末影龙逻辑也不会生成传送门，有需要可以搭配自定义传送门使用。
• 如果已经进入过某个维度，该维度地形已被存档，那么再配置维度类型可能会出现存档地形和生成地形融合的奇怪现象，可以在进入维度前通过 UpgradeMapDimensionVersion 接口提升该维度版本号，废弃原本的存档信息。