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 后预览当前值。该维度的存档目录无