# BlueMap-Towny
> *[BlueMap](https://github.com/BlueMap-Minecraft/BlueMap) 插件，用于在您的精美地图上显示您的 [Towny](https://github.com/TownyAdvanced/Towny) 城镇*
配置、占位符和主要功能深受 Dynmap-Towny 的启发。
支持领地中的空洞以及主要城镇之外的领地。
不支持外部插件钩入占位符。
## 安装
将插件 jar 文件放入您的插件文件夹中，并确保已安装 Towny 和 BlueMap。
该插件不附带任何默认图标。 我建议您使用
[Dynmap 的标记图标](https://github.com/webbukkit/dynmap/tree/v3.0/DynmapCore/src/main/resources/markers)
## 配置
```yml
# BlueMap-Towny 配置
# https://github.com/Chicken/BlueMap-Towny#config
# 检查标记更新的秒数
update-interval: 30
# 通过 /n set mapcolor 设置
dynamic-nation-colors: true
# 通过 /t set mapcolor 设置
dynamic-town-colors: true
# 城镇弹出窗口的 HTML，占位符记录在 README 中
popup: '%name% (%nation%)
市长 %mayor%
居民 %residents%
银行 %bank%'
# 战争弹出窗口的 HTML (仅限 SiegeWar)，占位符记录在 README 中
popup-siege: '围攻: %attacker% vs %defender%
城镇 %name%
类型 %siege_type%
战争宝箱 %war_chest%
攻城进度 %sessions_completed%/%sessions_total%
围攻状态 %siege_status%
围攻余额 %siege_balance%
旗帜控制 %banner_control%
战斗点数 %battle_points_attacker% / %battle_points_defender%
剩余战斗时间 %battle_time_left%'
# 如果想要领地中的空洞显示为完全声明，即使只有外围被声明。
# 这意味着地图会说谎关于该区域的实际声明状态!!!
lie-about-holes: false
# 对于拥有大量城镇的服务器，从地图上过滤掉较小的城镇，-1 表示禁用过滤器
min-town-blocks: -1
min-residents: -1
style:
# 放置区域标记的 Y 级别，图标位于生成位置
y-level: 62
# 使用城镇主家的 Y 级别，回退到 Y 级别
use-home-y: false
# 城镇边界设置
border-color: '#FF0000'
border-opacity: 0.8
border-width: 3
# 城镇填充设置
fill-color: '#FF0000'
fill-opacity: 0.35
# 图标路径在网页上或链接
# 城镇主家
home-icon-enabled: false
home-icon: assets/house.png
home-icon-anchor-x: 8
home-icon-anchor-y: 8
# 国家首都
capital-icon-enabled: false
capital-icon: assets/king.png
capital-icon-anchor-x: 8
capital-icon-anchor-y: 8
# 战争期间的图标
war-icon-enabled: false
war-icon: assets/war.png
war-icon-anchor-x: 8
war-icon-anchor-y: 8
# 废弃城镇的图标
ruined-icon-enabled: false
ruined-icon: assets/ruined.png
ruined-icon-anchor-x: 8
ruined-icon-anchor-y: 8
# 哨塔的图标
outpost-icon-enabled: false
outpost-icon: assets/tower.png
outpost-icon-anchor-x: 8
outpost-icon-anchor-y: 8
```
### 弹出窗口占位符
| 占位符 | 内容 |
|--------------------------|------------------------------------------------------------------------|
| `%name%` | 城镇名称 |
| `%mayor%` | 城镇市长 |
| `%residents%` | 城镇居民 |
| `%assistants%` | 城镇助手 |
| `%residentdisplaynames%` | 城镇居民，但显示名称 |
| `%residentcount%` | 城镇居民人数 |
| `%founded%` | 城镇创建日期 |
| `%board%` | 城镇公告板文本 |
| `%trusted%` | 城镇可信居民 |
| `%tax%` | 城镇税收 |
| `%bank%` | 城镇银行余额 |
| `%nation%` | 城镇所属国家 |
| `%nationstatus%` | 首都/国家成员... |
| `%public%` | 城镇公开状态 |
| `%peaceful%` | 城镇是否和平 |
| `%flags%` | 城镇旗帜（PVP、怪物...） |
| `%war%` | 是否有活跃战争（适用于 EventWar/FlagWar） |
| `%town_culture%` | 城镇文化，请参阅 https://github.com/TownyAdvanced/TownyCultures |
| `%town_resources%` | 城镇资源，请参阅 https://github.com/TownyAdvanced/TownyResources |
### [SiegeWar](https://github.com/TownyAdvanced/SiegeWar) 占位符
| 占位符 | 内容 |
|----------------------------|---------------------------------------------|
| `%attacker%` | 战争中攻击城镇/国家 |
| `%defender%` | 战争中防守城镇/国家 |
| `%siege_type%` | 围攻类型（征服、叛乱等） |
| `%sessions_completed%` | 已完成的战斗环节 |
| `%session_total%` | 总的战斗环节数量 |
| `%war_chest%` | 战争宝箱 (如果 Towny 启用了经济) |
| `%banner_control%` | 控制旗帜的人们 |
| `%siege_status%` | 围攻状态 |
| `%siege_balance%` | 围攻余额 |
| `%battle_points_attacker%` | 攻击方战斗点数 |
| `%battle_points_defender%` | 防守方战斗点数 |
| `%battle_time_left%` | 剩余战斗时间 |
