# Minecraft Dimension

> Minecraft Dimension Definition 维度定义：LEVEL_STEM 注册表、data/<namespace>/dimension/ 数据包路径、tags/dimension/ 标签、JSON 格式（type 维度类型、generator 块生成器）、Chunk Generators 块生成器类型（debug 调试网格、flat 超平坦 settings、noise 噪声 biome_source+settings 海平面/最小建造高度/总高度）、Biome Sources 生物群系源（checkerboard 棋盘格 biomes+scale、fixed 固定生物群系、multi_noise 多噪声 preset 参数列表 或 biomes 参数点列表 用于主世界和地狱、the_end 末地）、Multi-noise Parameter Lists 多噪声参数列表（data/<namespace>/worldgen/multi_noise_biome_source_parameter_list preset 参数）、Definition Behavior 定义行为（服务器启动加载一次、/reload 不重新加载、动态加载所有可用维度、禁用数据包移除维度 禁止创建后添加/移除维度 可能损坏存档）、Vanilla 维度（无维度文件 通过世界预设注册 维度文件覆盖世界预设定义）。

- Skill: `zmjjkk123-hub/minecraft-dimension` (Agent Skill)
- Install (CLI): `npx skillmds@latest add zmjjkk123-hub/minecraft-dimension`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zmjjkk123-hub/minecraft-dimension/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ZMJJKK123-hub (https://skillmd.com/u/zmjjkk123-hub)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/zmjjkk123-hub/minecraft-dimension

---


# Dimension Definitions

This content applies only to Java Edition.

Dimension definition files are the data-driven definitions of dimensions in datapacks.

## Definition format

Dimensions use the `LEVEL_STEM` registry; the datapack path is `dimension` (definitions in `data/<namespace>/dimension`, tags in `data/<namespace>/tags/dimension`).

Definition files use JSON with the following structure:

- JSON file root object
  - `type` (string/compound, required): dimension type; inline definitions are parsed but fail datapack verification (no namespace ID) and interrupt connection.
  - `generator` (compound, required): chunk generator.
    - `type` (string, required): chunk generator type; extra fields per type (below).

### Chunk generators

The chunk generator decides how terrain generates, plus the dimension's sea level, min build height, and total height. Noise generators read these from noise settings; the other two hardcode min height 0 and height 384 (flat sea level −64, debug 63).

- `debug`: generates the debug mode grid of blocks; no other terrain; fixed plains biome.
- `flat`: generates superflat worlds. `settings` (compound, required): flat generator settings.
- `noise`: generates complex terrain with a noise generator. Fields:
  - `biome_source` (compound, required): biome distribution (below).
  - `settings` (string/compound, required): noise settings.

### Biome sources

Only noise generators can set a biome source; others use a fixed source.

- `checkerboard`: places biomes in a checkerboard. `biomes` (string/list, required: ID, tag, or list), `scale` (int, 0≤v≤62, default 2; each increment doubles the cell size; 0 = one chunk per cell).
- `fixed`: always uses one biome. `biome` (string, required).
- `multi_noise`: places biomes by biome noise; used by the Overworld and Nether. Either `preset` (string/compound, required) referencing a parameter list, or a non-empty `biomes` list of parameter points, each `biome` (string, required) + `parameters` (compound, required).
- `the_end`: used by the End dimension.

## Multi-noise parameter lists

Stored in `data/<namespace>/worldgen/multi_noise_biome_source_parameter_list`; root object: `preset` (string, required): a biome parameter (vanilla provides `overworld` and `nether`). These lists only reference hardcoded parameters; vanilla uses them to temporarily modify Overworld biome distribution for experimental biomes.

## Definition behavior

Dimension data is loaded only once at server startup; `/reload` does not reload it — a server restart is required. All available dimensions load dynamically when the save loads; disabling the providing datapack removes the dimension (adding/removing dimensions after world creation is discouraged — it may corrupt saves). Vanilla defines no dimension files; it registers dimensions via world presets, but dimension files override world preset definitions.