地图模板
基本信息
| 属性 | 值 |
|---|---|
| 位置 | src/main/resources/templates/ |
| 文件数 | 21（3 个维度 × 7 个分辨率档） |
| 格式 | YAML，版本字段 version: 1.9 |
| 默认档位 | hires（configuration.txt:16 deftemplatesuffix: hires） |
| 模板实现类 | org.dynmap.hdmap.HDMap（模板内 maps: 列表的 class:） |
维度与档位
| 维度 | 文件名前缀 | 对应 MC 维度 |
|---|---|---|
| Normal | normal-*.txt |
主世界 / 多数维度 |
| Nether | nether-*.txt |
下界 |
| The End | the_end-*.txt |
末地 |
每维度 7 个分辨率档：
| 档位 | 每像素方块数 | 说明（取自 configuration.txt:3-15 注释） |
|---|---|---|
vlowres |
2 ppb | 超低分辨率 |
lowres |
4 ppb | 低分辨率 |
hires |
16 ppb | 高分辨率（初始 fullrender 极慢） |
low_boost_hi |
4 ppb + 局部升 16 ppb | 低分辨率 + 选择性提升 |
hi_boost_vhi |
16 ppb + 局部升 32 ppb | 高分辨率 + 提升 |
hi_boost_xhi |
16 ppb + 局部升 64 ppb | 高分辨率 + 提升 |
| （无后缀） | — | 默认模板 |
模板结构
以 templates/normal.txt 为例，templates: 下每个维度名（如 normal:）是一个模板，模板内含 maps: 列表，每项定义一张地图：
| 键 | 含义（normal.txt 实例） |
|---|---|
class |
org.dynmap.hdmap.HDMap |
name |
flat / surface / cave |
title |
网页显示标题 "Flat" / "Surface" / "Cave" |
prefix |
图块文件名前缀 flat / t / ct |
perspective |
引用透视 id，如 iso_S_90_vlowres / iso_SE_60_vlowres |
shader |
引用着色器 id，如 defaultscheme / cave |
lighting |
引用光照 id，如 default |
mapzoomin |
额外放大层数，normal.txt 中为 2 |
模板级键 extrazoomout: 2（normal.txt:12）控制额外缩小层数，每层尺寸翻倍。center:（normal.txt:13-16，整段注释状态）可指定地图中心。
normal.txt:5 的注释提示升级时该文件"MAY need to be replaced"，如需自定义应重命名为 custom-normal-vlowres.txt。
数值
| 数值名 | 值 |
|---|---|
| 模板文件数 | 21 |
| 维度模板数 | 3（normal / nether / the_end） |
| 每维度档位数 | 7 |
normal.txt 中定义的地图数 |
3（flat、surface、cave） |
extrazoomout |
2（normal.txt:12） |
mapzoomin |
2（normal.txt 三张地图均为 2） |
交互
| 触发 | 行为 |
|---|---|
| 世界加载 | 按维度类型套用对应模板的 extrazoomout 与 maps |
/dmap maplist |
列出已生效的地图 |
/dmap mapadd |
追加模板之外的自定义地图（需先 /dynmap pause all） |
/dmap worldreset |
重置回模板默认 |
仓库 README.md 提示默认已有 flat、surface、cave 三张地图，与 normal.txt 一致。