world
- Commit:
a40e7105530a7578ed7a19f6e2fbacef4c10f2e6 - Language:
en - Config file:
config/world.toml - Field count:
42 - Description: world.toml: world save, generator, spawn, lighting, and GPU calculation settings.
Paste or upload TOML to preview current values.
| Path | Type | Default | Current | Description | Notice |
|---|---|---|---|---|---|
chunk_load_parallelism | integer | 4 | Paste or upload TOML to preview current values. | Maximum number of chunk build tasks per player | None |
chunk_update_delay_ms | integer | 1000 | Paste or upload TOML to preview current values. | Delay in milliseconds before applying chunk center updates after player movement. If the player remains in the first neighbor ring, only the new edge chunks and delayed unload chunks are processed. | None |
default_dimension | string | "minecraft:overworld" | Paste or upload TOML to preview current values. | Dimension used when a player joins without saved player data. It may point to any configured dimension; minecraft:overworld is not required. | None |
dimension | string | "minecraft:overworld" | Paste or upload TOML to preview current values. | Default dimension resource key | None |
dimension_type | string | "minecraft:overworld" | Paste or upload TOML to preview current values. | Default dimension type resource key | None |
game_mode | string | "survival" | Paste or upload TOML to preview current values. | Default game mode: survival, creative, adventure, or spectator | None |
generator | string | "empty" | Paste or upload TOML to preview current values. | World generator used when no saved chunk exists: empty, vanilla_flat, or vanilla_noise | None |
generator_preset | string | "minecraft:classic_flat" | Paste or upload TOML to preview current values. | World generator preset. vanilla_flat uses Minecraft flat_level_generator_preset IDs such as minecraft:classic_flat. | None |
gpu | object | See #gpu | See #gpu | Experimental GPU calculation settings for world lighting and vanilla_noise post-processing. Unavailable GPU falls back to CPU. | None |
instances | array | See #instances | See #instances | Copy-on-write world instances that start from a source dimension and persist changed chunks separately | None |
light | string | "static" | Paste or upload TOML to preview current values. | World lighting mode: static, dynamic, or a fixed brightness integer from 0 to 15 | None |
light_algorithm | string | "fast" | Paste or upload TOML to preview current values. | World lighting calculation algorithm: fast or ray_trace | None |
path | string | "world" | Paste or upload TOML to preview current values. | World save directory | None |
precompiled_chunks | object | See #precompiled_chunks | See #precompiled_chunks | Precompiled chunk packet cache. Recommended for read-only worlds because it reuses encoded chunk packets instead of rebuilding complete chunk objects for every player. | None |
read_only | boolean | false | Paste or upload TOML to preview current values. | Enable read-only world mode. Player world edits are rejected and not written. | None |
seed | integer | 0 | Paste or upload TOML to preview current values. | World generation seed used by vanilla_noise. 0 matches the default Minecraft seed value. | None |
simulation_distance | integer | 3 | Paste or upload TOML to preview current values. | Initial simulation distance | None |
spawn | object | See #spawn | See #spawn | Player spawn position and rotation | None |
spawn_protection_radius | integer | 16 | Paste or upload TOML to preview current values. | Spawn protection radius in blocks. 0 disables spawn protection. | None |
view_distance | integer | 3 | Paste or upload TOML to preview current values. | Initial chunk view distance | None |
worlds | array | See #worlds | See #worlds | World storage entries. Each entry maps one dimension to its own save folder. | None |
Complex Type Details
gpu
- Type
object- Default
- None
- Current
- Paste or upload TOML to preview current values.
- Description
- Experimental GPU calculation settings for world lighting and vanilla_noise post-processing. Unavailable GPU falls back to CPU.
| Path | Type | Default | Current | Description | Notice |
|---|---|---|---|---|---|
gpu.device | string | "discrete" | Paste or upload TOML to preview current values. | GPU selector: discrete, integrated, cpu, auto, or a numeric adapter index | None |
gpu.enable | boolean | false | Paste or upload TOML to preview current values. | Enable experimental GPU world calculation. Disabled uses CPU; unavailable GPU falls back to CPU. | None |
instances
- Type
array- Default
- None
- Current
- Paste or upload TOML to preview current values.
- Description
- Copy-on-write world instances that start from a source dimension and persist changed chunks separately
| Path | Type | Default | Current | Description | Notice |
|---|---|---|---|---|---|
instances.copy_on_write | boolean | None | Paste or upload TOML to preview current values. | Read unchanged chunks from the source dimension and write changed chunks to this instance path | None |
instances.dimension | string | None | Paste or upload TOML to preview current values. | Dimension resource key exposed to players for this instance | None |
instances.id | string | None | Paste or upload TOML to preview current values. | Stable world instance id | None |
instances.path | string | None | Paste or upload TOML to preview current values. | Storage path for chunks changed by this instance. Empty uses a sanitized dimension folder under the main world path. | None |
instances.source_dimension | string | None | Paste or upload TOML to preview current values. | Source dimension used when the instance has no copied chunk | None |
precompiled_chunks
- Type
object- Default
- None
- Current
- Paste or upload TOML to preview current values.
- Description
- Precompiled chunk packet cache. Recommended for read-only worlds because it reuses encoded chunk packets instead of rebuilding complete chunk objects for every player.
| Path | Type | Default | Current | Description | Notice |
|---|---|---|---|---|---|
precompiled_chunks.block_state_cache_limit | integer | 65536 | Paste or upload TOML to preview current values. | Maximum number of individual block states retained for plugin queries when full chunk objects are not kept. 0 disables the block-state query cache. | None |
precompiled_chunks.enable | boolean | false | Paste or upload TOML to preview current values. | Enable precompiled chunk packets. Read-only worlds benefit most; writable worlds invalidate affected chunk packets when blocks change. | None |
precompiled_chunks.light | boolean | true | Paste or upload TOML to preview current values. | Include lighting data in precompiled packets. Disable this when dynamic lighting or externally refreshed lighting should be rebuilt separately. | None |
precompiled_chunks.max_cached_packet_bytes | integer | 16777216 | Paste or upload TOML to preview current values. | Maximum total bytes used by precompiled chunk packet cache. 0 disables the byte limit. Keep this conservative for worlds where players can travel far. | None |
precompiled_chunks.max_cached_packets | integer | 256 | Paste or upload TOML to preview current values. | Maximum number of precompiled chunk packets kept in memory. 0 disables the packet-count limit. | None |
spawn
- Type
object- Default
- None
- Current
- Paste or upload TOML to preview current values.
- Description
- Player spawn position and rotation
| Path | Type | Default | Current | Description | Notice |
|---|---|---|---|---|---|
spawn.pitch | number | 0.0 | Paste or upload TOML to preview current values. | Spawn pitch | None |
spawn.x | number | 0.0 | Paste or upload TOML to preview current values. | Spawn X coordinate | None |
spawn.y | number | 0.0 | Paste or upload TOML to preview current values. | Spawn Y coordinate | None |
spawn.yaw | number | 0.0 | Paste or upload TOML to preview current values. | Spawn yaw | None |
spawn.z | number | 0.0 | Paste or upload TOML to preview current values. | Spawn Z coordinate | None |
worlds
- Type
array- Default
- None
- Current
- Paste or upload TOML to preview current values.
- Description
- World storage entries. Each entry maps one dimension to its own save folder.
| Path | Type | Default | Current | Description | Notice |
|---|---|---|---|---|---|
worlds.dimension | string | None | Paste or upload TOML to preview current values. | Dimension resource key served by this world storage | None |
worlds.dimension_type | string | None | Paste or upload TOML to preview current values. | Dimension type resource key used when entering this dimension | None |
worlds.id | string | None | Paste or upload TOML to preview current values. | Stable world storage id | None |
worlds.path | string | None | Paste or upload TOML to preview current values. | Save folder for this dimension | None |