world

  • 提交: a40e7105530a7578ed7a19f6e2fbacef4c10f2e6
  • 语言: zh-CN
  • 配置文件: config/world.toml
  • 字段数量: 42
  • 说明: world.toml: 世界存档、生成器、出生点、光照和 GPU 计算设置。
TOML 在线预览
粘贴或上传配置文件,文档中的匹配字段会显示当前值。
world.toml
粘贴或上传 TOML 后预览当前值。
配置项类型默认值当前值说明提示
chunk_load_parallelisminteger4粘贴或上传 TOML 后预览当前值。每名玩家同时构建区块的最大任务数
chunk_update_delay_msinteger1000粘贴或上传 TOML 后预览当前值。玩家移动后延迟应用区块中心更新的毫秒数。若延迟后玩家仍在原区块第一圈 8 邻域内,只处理新增边缘区块和延迟卸载区块。
default_dimensionstring"minecraft:overworld"粘贴或上传 TOML 后预览当前值。玩家没有存档时默认进入的维度。可以指向任意已配置维度,不要求存在 minecraft:overworld。
dimensionstring"minecraft:overworld"粘贴或上传 TOML 后预览当前值。默认维度资源键
dimension_typestring"minecraft:overworld"粘贴或上传 TOML 后预览当前值。默认维度类型资源键
game_modestring"survival"粘贴或上传 TOML 后预览当前值。默认游戏模式:survival、creative、adventure 或 spectator
generatorstring"empty"粘贴或上传 TOML 后预览当前值。存档区块不存在时使用的世界生成器:empty、vanilla_flat 或 vanilla_noise
generator_presetstring"minecraft:classic_flat"粘贴或上传 TOML 后预览当前值。世界生成器预设。vanilla_flat 使用 Minecraft flat_level_generator_preset ID,例如 minecraft:classic_flat。
gpuobject见 #gpu见 #gpu世界光照与 vanilla_noise 后处理 GPU 计算设置(实验性)。GPU 不可用时回退 CPU。
instancesarray见 #instances见 #instances写时复制世界副本;从源维度读取初始区块,并将变更区块单独持久化
lightstring"static"粘贴或上传 TOML 后预览当前值。世界光照模式:static、dynamic,或 0 到 15 的固定亮度整数
light_algorithmstring"fast"粘贴或上传 TOML 后预览当前值。世界光照计算算法:fast 或 ray_trace
pathstring"world"粘贴或上传 TOML 后预览当前值。世界存档目录
precompiled_chunksobject见 #precompiled_chunks见 #precompiled_chunks预编译区块数据包缓存。只读世界推荐启用,它会复用已编码的区块数据包,避免为每个玩家重复构建完整区块对象。
read_onlybooleanfalse粘贴或上传 TOML 后预览当前值。启用只读世界模式。玩家世界修改会被拒绝,不会写入世界。
seedinteger0粘贴或上传 TOML 后预览当前值。vanilla_noise 使用的世界生成种子。0 对应 Minecraft 默认种子值。
simulation_distanceinteger3粘贴或上传 TOML 后预览当前值。初始模拟距离
spawnobject见 #spawn见 #spawn玩家出生坐标与朝向
spawn_protection_radiusinteger16粘贴或上传 TOML 后预览当前值。出生点保护半径,单位为方块。0 表示关闭出生点保护。
view_distanceinteger3粘贴或上传 TOML 后预览当前值。初始区块视距
worldsarray见 #worlds见 #worlds世界存储项。每个条目将一个维度映射到独立存档目录。

复杂类型详情

gpu

类型
object
默认值
当前值
粘贴或上传 TOML 后预览当前值。
说明
世界光照与 vanilla_noise 后处理 GPU 计算设置(实验性)。GPU 不可用时回退 CPU。
配置项类型默认值当前值说明提示
gpu.devicestring"discrete"粘贴或上传 TOML 后预览当前值。GPU 选择器:discrete、integrated、cpu、auto,或数字适配器索引
gpu.enablebooleanfalse粘贴或上传 TOML 后预览当前值。启用实验性 GPU 世界计算。关闭时使用 CPU;GPU 不可用时回退 CPU。

instances

类型
array
默认值
当前值
粘贴或上传 TOML 后预览当前值。
说明
写时复制世界副本;从源维度读取初始区块,并将变更区块单独持久化
配置项类型默认值当前值说明提示
instances.copy_on_writeboolean粘贴或上传 TOML 后预览当前值。从源维度读取未变更区块,并将变更区块写入该副本路径
instances.dimensionstring粘贴或上传 TOML 后预览当前值。该副本暴露给玩家的维度资源键
instances.idstring粘贴或上传 TOML 后预览当前值。稳定的世界副本标识
instances.pathstring粘贴或上传 TOML 后预览当前值。该副本变更区块的存储路径。留空时使用主世界目录下按维度名清理后的目录。
instances.source_dimensionstring粘贴或上传 TOML 后预览当前值。副本尚未复制区块时读取的源维度

precompiled_chunks

类型
object
默认值
当前值
粘贴或上传 TOML 后预览当前值。
说明
预编译区块数据包缓存。只读世界推荐启用,它会复用已编码的区块数据包,避免为每个玩家重复构建完整区块对象。
配置项类型默认值当前值说明提示
precompiled_chunks.block_state_cache_limitinteger65536粘贴或上传 TOML 后预览当前值。不保留完整区块对象时,为插件查询保留的单方块状态数量上限。0 表示关闭方块状态查询缓存。
precompiled_chunks.enablebooleanfalse粘贴或上传 TOML 后预览当前值。启用预编译区块数据包。只读世界收益最大;可写世界在方块变更时会失效受影响区块的数据包。
precompiled_chunks.lightbooleantrue粘贴或上传 TOML 后预览当前值。将光照数据也纳入预编译数据包。动态光照或需要外部刷新光照时可关闭,让光照单独重建。
precompiled_chunks.max_cached_packet_bytesinteger16777216粘贴或上传 TOML 后预览当前值。预编译区块数据包缓存可使用的最大总字节数。0 表示不限制字节数。玩家可以跑图的世界应将此值设得保守。
precompiled_chunks.max_cached_packetsinteger256粘贴或上传 TOML 后预览当前值。内存中保留的最大预编译区块数据包数量。0 表示不限制。

spawn

类型
object
默认值
当前值
粘贴或上传 TOML 后预览当前值。
说明
玩家出生坐标与朝向
配置项类型默认值当前值说明提示
spawn.pitchnumber0.0粘贴或上传 TOML 后预览当前值。出生点俯仰角
spawn.xnumber0.0粘贴或上传 TOML 后预览当前值。出生点 X 坐标
spawn.ynumber0.0粘贴或上传 TOML 后预览当前值。出生点 Y 坐标
spawn.yawnumber0.0粘贴或上传 TOML 后预览当前值。出生点水平朝向
spawn.znumber0.0粘贴或上传 TOML 后预览当前值。出生点 Z 坐标

worlds

类型
array
默认值
当前值
粘贴或上传 TOML 后预览当前值。
说明
世界存储项。每个条目将一个维度映射到独立存档目录。
配置项类型默认值当前值说明提示
worlds.dimensionstring粘贴或上传 TOML 后预览当前值。该世界存储服务的维度资源键
worlds.dimension_typestring粘贴或上传 TOML 后预览当前值。进入该维度时使用的维度类型资源键
worlds.idstring粘贴或上传 TOML 后预览当前值。稳定的世界存储标识
worlds.pathstring粘贴或上传 TOML 后预览当前值。该维度的存档目录