worlds.txt 与 blockgroups.yml

基本信息

属性 值
worlds.txt src/main/resources/worlds.txt（126 行）
blockgroups.yml src/main/resources/blockgroups.yml（20 行）
custom-blockgroups.yml src/main/resources/custom-blockgroups.yml（1 行，仓库内仅 block-groups: 空键）
格式 均为 YAML
运行时路径 <MC 根目录>/dynmap/ 下同名文件

worlds.txt 头部注释（worlds.txt:3）说明其语义：同名的世界定义会覆盖 configuration.txt 中的定义；删除该文件后由 dynmap.jar 在下次启动时重新生成。仓库内所有行都以 # 注释开头（worlds.txt:2），即仓库默认不含任何生效的世界覆盖。

功能

worlds.txt

按世界名逐项覆盖世界设置。可覆盖的键由 worlds.txt:12-30 的示例给出：

键 作用 示例行
title 网页上显示的世界标题 worlds.txt:13
enabled false 关闭该世界 worlds.txt:15
sendposition false 隐藏该世界的玩家位置 worlds.txt:17
sendhealth false 隐藏该世界的玩家血量 worlds.txt:19
fullrenderlocations 非连续区块世界的额外扫描点列表 worlds.txt:23-27
visibilitylimits 限制可渲染区域（矩形 x0,z0→x1,z1 或圆形 x,z+r） worlds.txt:29-30

blockgroups.yml

把方块按"材质类别"分组，供着色器按组而非按单方块取贴图。仓库内定义 7 个组 + 2 个聚合组：

组名 源码行 说明
vanilla-logs blockgroups.yml:2 原版木头与蘑菇方块（4 项）
vanilla-leaves blockgroups.yml:4 原版树叶（2 项）
vanilla-plants blockgroups.yml:6 原版植物（21 项）
vanilla-ground blockgroups.yml:8 原版地表方块（18 项）
modded-logs blockgroups.yml:10 模组木头（36 项）
modded-leaves blockgroups.yml:12 模组树叶（30 项）
modded-plants blockgroups.yml:14 模组植物（258 项，含 harvestcraft:pam* 全系列）
modded-ground blockgroups.yml:16 模组地表方块（74 项）
gtnh-all-plants blockgroups.yml:18 聚合组，引用 6 个 vanilla-*/modded-* 组（6 项）
gtnh-all-ground blockgroups.yml:20 聚合组，引用 vanilla-ground + modded-ground（2 项）

聚合语法为 @组名 前缀，例如 blockgroups.yml:18 的 '@vanilla-logs', '@vanilla-leaves', …。

数值

数值名 值
worlds.txt 生效条目数（仓库默认） 0（全部注释）
blockgroups.yml 组数 10（8 个具体组 + 2 个聚合组）
custom-blockgroups.yml 组数 0（仅空 block-groups: 键）
modded-plants 组的方块条目数 258（blockgroups.yml:14，全文件最大的一组）

blockgroups.yml 中出现的模组命名空间（取自 :10–:16）包括 IC2、Thaumcraft、Natura、BiomesOPlenty、HardcoreEnderExpansion、Forestry、ExtraTrees、TwilightForest、thaumicbases、witchery、ForbiddenMagic、miscutils、GalaxySpace、TaintedMagic、harvestthenether、harvestcraft、WitchingGadgets、ProjRed|Exploration、Botania、GalacticraftCore、GalacticraftMars、chisel、dreamcraft、OpenBlocks、RandomThings、ToxicEverglades。

[!NOTE] 命名空间写法不统一是本文件的事实特征，不能据名推断 mod 归属：既有 Thaumcraft: 也有 thaumicbases:（小写），既有 Forestry: 也有 ForbiddenMagic:，而 ProjRed|Exploration 使用了竖线（非 1.7.10 常见的冒号/斜杠写法）。此处仅按原文照录。

交互

触发 行为
取消 worlds.txt 某行注释 覆盖 configuration.txt 中的同名世界定义
删除 worlds.txt 下次启动由 jar 重新生成
在 custom-blockgroups.yml 追加组 与 blockgroups.yml 合并生效（仓库内该文件为空）

相关条目