world
- 提交:
a40e7105530a7578ed7a19f6e2fbacef4c10f2e6 - 语言:
zh-CN - 配置文件:
config/world.toml - 字段数量:
42 - 说明: world.toml: 世界存档、生成器、出生点、光照和 GPU 计算设置。
粘贴或上传 TOML 后预览当前值。
| 配置项 | 类型 | 默认值 | 当前值 | 说明 | 提示 |
|---|---|---|---|---|---|
chunk_load_parallelism | integer | 4 | 粘贴或上传 TOML 后预览当前值。 | 每名玩家同时构建区块的最大任务数 | 无 |
chunk_update_delay_ms | integer | 1000 | 粘贴或上传 TOML 后预览当前值。 | 玩家移动后延迟应用区块中心更新的毫秒数。若延迟后玩家仍在原区块第一圈 8 邻域内,只处理新增边缘区块和延迟卸载区块。 | 无 |
default_dimension | string | "minecraft:overworld" | 粘贴或上传 TOML 后预览当前值。 | 玩家没有存档时默认进入的维度。可以指向任意已配置维度,不要求存在 minecraft:overworld。 | 无 |
dimension | string | "minecraft:overworld" | 粘贴或上传 TOML 后预览当前值。 | 默认维度资源键 | 无 |
dimension_type | string | "minecraft:overworld" | 粘贴或上传 TOML 后预览当前值。 | 默认维度类型资源键 | 无 |
game_mode | string | "survival" | 粘贴或上传 TOML 后预览当前值。 | 默认游戏模式:survival、creative、adventure 或 spectator | 无 |
generator | string | "empty" | 粘贴或上传 TOML 后预览当前值。 | 存档区块不存在时使用的世界生成器:empty、vanilla_flat 或 vanilla_noise | 无 |
generator_preset | string | "minecraft:classic_flat" | 粘贴或上传 TOML 后预览当前值。 | 世界生成器预设。vanilla_flat 使用 Minecraft flat_level_generator_preset ID,例如 minecraft:classic_flat。 | 无 |
gpu | object | 见 #gpu | 见 #gpu | 世界光照与 vanilla_noise 后处理 GPU 计算设置(实验性)。GPU 不可用时回退 CPU。 | 无 |
instances | array | 见 #instances | 见 #instances | 写时复制世界副本;从源维度读取初始区块,并将变更区块单独持久化 | 无 |
light | string | "static" | 粘贴或上传 TOML 后预览当前值。 | 世界光照模式:static、dynamic,或 0 到 15 的固定亮度整数 | 无 |
light_algorithm | string | "fast" | 粘贴或上传 TOML 后预览当前值。 | 世界光照计算算法:fast 或 ray_trace | 无 |
path | string | "world" | 粘贴或上传 TOML 后预览当前值。 | 世界存档目录 | 无 |
precompiled_chunks | object | 见 #precompiled_chunks | 见 #precompiled_chunks | 预编译区块数据包缓存。只读世界推荐启用,它会复用已编码的区块数据包,避免为每个玩家重复构建完整区块对象。 | 无 |
read_only | boolean | false | 粘贴或上传 TOML 后预览当前值。 | 启用只读世界模式。玩家世界修改会被拒绝,不会写入世界。 | 无 |
seed | integer | 0 | 粘贴或上传 TOML 后预览当前值。 | vanilla_noise 使用的世界生成种子。0 对应 Minecraft 默认种子值。 | 无 |
simulation_distance | integer | 3 | 粘贴或上传 TOML 后预览当前值。 | 初始模拟距离 | 无 |
spawn | object | 见 #spawn | 见 #spawn | 玩家出生坐标与朝向 | 无 |
spawn_protection_radius | integer | 16 | 粘贴或上传 TOML 后预览当前值。 | 出生点保护半径,单位为方块。0 表示关闭出生点保护。 | 无 |
view_distance | integer | 3 | 粘贴或上传 TOML 后预览当前值。 | 初始区块视距 | 无 |
worlds | array | 见 #worlds | 见 #worlds | 世界存储项。每个条目将一个维度映射到独立存档目录。 | 无 |
复杂类型详情
gpu
- 类型
object- 默认值
- 无
- 当前值
- 粘贴或上传 TOML 后预览当前值。
- 说明
- 世界光照与 vanilla_noise 后处理 GPU 计算设置(实验性)。GPU 不可用时回退 CPU。
| 配置项 | 类型 | 默认值 | 当前值 | 说明 | 提示 |
|---|---|---|---|---|---|
gpu.device | string | "discrete" | 粘贴或上传 TOML 后预览当前值。 | GPU 选择器:discrete、integrated、cpu、auto,或数字适配器索引 | 无 |
gpu.enable | boolean | false | 粘贴或上传 TOML 后预览当前值。 | 启用实验性 GPU 世界计算。关闭时使用 CPU;GPU 不可用时回退 CPU。 | 无 |
instances
- 类型
array- 默认值
- 无
- 当前值
- 粘贴或上传 TOML 后预览当前值。
- 说明
- 写时复制世界副本;从源维度读取初始区块,并将变更区块单独持久化
| 配置项 | 类型 | 默认值 | 当前值 | 说明 | 提示 |
|---|---|---|---|---|---|
instances.copy_on_write | boolean | 无 | 粘贴或上传 TOML 后预览当前值。 | 从源维度读取未变更区块,并将变更区块写入该副本路径 | 无 |
instances.dimension | string | 无 | 粘贴或上传 TOML 后预览当前值。 | 该副本暴露给玩家的维度资源键 | 无 |
instances.id | string | 无 | 粘贴或上传 TOML 后预览当前值。 | 稳定的世界副本标识 | 无 |
instances.path | string | 无 | 粘贴或上传 TOML 后预览当前值。 | 该副本变更区块的存储路径。留空时使用主世界目录下按维度名清理后的目录。 | 无 |
instances.source_dimension | string | 无 | 粘贴或上传 TOML 后预览当前值。 | 副本尚未复制区块时读取的源维度 | 无 |
precompiled_chunks
- 类型
object- 默认值
- 无
- 当前值
- 粘贴或上传 TOML 后预览当前值。
- 说明
- 预编译区块数据包缓存。只读世界推荐启用,它会复用已编码的区块数据包,避免为每个玩家重复构建完整区块对象。
| 配置项 | 类型 | 默认值 | 当前值 | 说明 | 提示 |
|---|---|---|---|---|---|
precompiled_chunks.block_state_cache_limit | integer | 65536 | 粘贴或上传 TOML 后预览当前值。 | 不保留完整区块对象时,为插件查询保留的单方块状态数量上限。0 表示关闭方块状态查询缓存。 | 无 |
precompiled_chunks.enable | boolean | false | 粘贴或上传 TOML 后预览当前值。 | 启用预编译区块数据包。只读世界收益最大;可写世界在方块变更时会失效受影响区块的数据包。 | 无 |
precompiled_chunks.light | boolean | true | 粘贴或上传 TOML 后预览当前值。 | 将光照数据也纳入预编译数据包。动态光照或需要外部刷新光照时可关闭,让光照单独重建。 | 无 |
precompiled_chunks.max_cached_packet_bytes | integer | 16777216 | 粘贴或上传 TOML 后预览当前值。 | 预编译区块数据包缓存可使用的最大总字节数。0 表示不限制字节数。玩家可以跑图的世界应将此值设得保守。 | 无 |
precompiled_chunks.max_cached_packets | integer | 256 | 粘贴或上传 TOML 后预览当前值。 | 内存中保留的最大预编译区块数据包数量。0 表示不限制。 | 无 |
spawn
- 类型
object- 默认值
- 无
- 当前值
- 粘贴或上传 TOML 后预览当前值。
- 说明
- 玩家出生坐标与朝向
| 配置项 | 类型 | 默认值 | 当前值 | 说明 | 提示 |
|---|---|---|---|---|---|
spawn.pitch | number | 0.0 | 粘贴或上传 TOML 后预览当前值。 | 出生点俯仰角 | 无 |
spawn.x | number | 0.0 | 粘贴或上传 TOML 后预览当前值。 | 出生点 X 坐标 | 无 |
spawn.y | number | 0.0 | 粘贴或上传 TOML 后预览当前值。 | 出生点 Y 坐标 | 无 |
spawn.yaw | number | 0.0 | 粘贴或上传 TOML 后预览当前值。 | 出生点水平朝向 | 无 |
spawn.z | number | 0.0 | 粘贴或上传 TOML 后预览当前值。 | 出生点 Z 坐标 | 无 |
worlds
- 类型
array- 默认值
- 无
- 当前值
- 粘贴或上传 TOML 后预览当前值。
- 说明
- 世界存储项。每个条目将一个维度映射到独立存档目录。
| 配置项 | 类型 | 默认值 | 当前值 | 说明 | 提示 |
|---|---|---|---|---|---|
worlds.dimension | string | 无 | 粘贴或上传 TOML 后预览当前值。 | 该世界存储服务的维度资源键 | 无 |
worlds.dimension_type | string | 无 | 粘贴或上传 TOML 后预览当前值。 | 进入该维度时使用的维度类型资源键 | 无 |
worlds.id | string | 无 | 粘贴或上传 TOML 后预览当前值。 | 稳定的世界存储标识 | 无 |
worlds.path | string | 无 | 粘贴或上传 TOML 后预览当前值。 | 该维度的存档目录 | 无 |