[MD]
## 2. 新版本更新点
### 2.1 全息图
- 可在采集点上方显示节点名称与倒计时
- 支持自定义多行排版
- 支持自定义状态文案
- 支持独立开关
配置节点：
```yaml
ui:
hologram:
enabled: true
show-point-nodes: true
show-global-cooldowns: true
refresh-interval-ticks: 20
offset-y: 1.55
line-spacing: 0.26
status-text:
ready: "&a可采集"
cooldown: "&c刷新中"
lines:
- "&6%node_name%"
- "&7状态: %status_text%"
- "&7倒计时: &f%remaining_time%"
```
占位符：
- `%node_id%`
- `%node_name%`
- `%status_text%`
- `%remaining_seconds%`
- `%remaining_time%`
- `%respawn_seconds%`
- `%world%`
- `%x%`
- `%y%`
- `%z%`
行为说明：
- `POINT` 节点会常驻全息图
- `GLOBAL` 节点为了避免给全图同材质方块生成实体，默认只在进入冷却后维护倒计时全息图
### 2.2 节点显示名
节点新增：
```yaml
display-name: "&6铁矿石"
```
该名称会用于：
- 全息图
- BossBar
- ActionBar
- PAPI 变量
- `/wzg node info`
### 2.3 PlaceholderAPI
标识符：
```text
%warzgather_*%
```
目标方块：
- `%warzgather_target_has_node%`
- `%warzgather_target_id%`
- `%warzgather_target_name%`
- `%warzgather_target_status%`
- `%warzgather_target_available%`
- `%warzgather_target_remaining_seconds%`
- `%warzgather_target_remaining_time%`
- `%warzgather_target_respawn_seconds%`
- `%warzgather_target_method%`
当前采集会话：
- `%warzgather_session_active%`
- `%warzgather_session_node_id%`
- `%warzgather_session_node_name%`
- `%warzgather_session_progress_percent%`
- `%warzgather_session_remaining_seconds%`
- `%warzgather_session_remaining_time%`
说明：
- `target` 变量基于玩家当前准星方块
- 检测距离由 `placeholderapi.target-distance` 控制
- `session` 变量在玩家正在采集时返回实时数据
## 3. 节点配置
### 3.1 GLOBAL 节点
```yaml
ore_iron:
type: GLOBAL
display-name: "&f铁矿石"
block: IRON_ORE
method: BREAK
gather-time: 40
respawn: 600
tools:
IRON_PICKAXE:
damage: 2
speed: 1.0
DIAMOND_PICKAXE:
damage: 1
speed: 1.5
rewards:
- type: ITEM
value: IRON_INGOT:1
chance: 100.0
```
### 3.2 POINT 节点模板
```yaml
relic_crystal:
type: POINT
display-name: "&b遗迹水晶"
method: RIGHT_CLICK
gather-time: 100
respawn: 900
rewards:
- type: COMMAND
value: "broadcast %player% 发现了遗迹水晶"
chance: 100.0
```
创建命令：
```text
/wzg node create relic_crystal
```
## 4. 指令
- `/wzg node create <ID>`: 将目标方块绑定到一个 `POINT` 模板
- `/wzg node remove`: 移除当前目标方块上的定点节点
- `/wzg node info`: 查看当前目标方块的节点信息
- `/wzg reload`: 重载配置、节点缓存、全息图
## 5. 奖励类型
- `ITEM`
- `MONEY`
- `EXP`
- `COMMAND`
`COMMAND` 奖励会以控制台身份执行，支持 `%player%` 占位符。
## 6. 兼容与依赖
- Minecraft API: `1.13+`
- 支持: `Spigot / Paper / Folia`
- 可选依赖: `Vault`, `PlaceholderAPI`
## 7. 维护说明
本次还顺手修复了几个原有问题：
- `POINT` 模板之前不会从 `nodes.yml` 正常加载
- 插件重载时会重复叠加全局节点缓存
- 服务端重启后，持久化的定点节点不会按模板正确恢复
[/MD]
