Getting Started

快速开始

安装

1. 确保服务端为 Paper 1.21+
2. 安装 PacketEvents 2.x（必须在 WarriorView 之前加载）
3. 将 WarriorView 放入 plugins/ 目录
4. 启动服务器，插件将自动生成默认配置文件

可选依赖（按需安装）：

• LuckPerms — 安装后可为不同权限组的玩家显示不同指示器样式（variants 功能）
• PlaceholderAPI — 安装后可在 text-format、char-replace 替换值、number-format 后缀中嵌入全局占位符

配置文件结构

plugins/WarriorView/
├── config.yml                          # 全局配置（调度器/指示器/调试）
├── message.yml                         # 消息模板
├── number-format.yml                   # 数字量化缩写规则
├── char-replace.yml                    # 字符替换规则
├── indicator/                          # 指示器配置目录
│   ├── damage-indicator.yml            #   伤害指示器
│   └── regain-indicator.yml            #   生命恢复指示器
├── animations/                         # 动画定义目录
│   ├── default.yml                     #   默认动画
│   └── presets/                        #   预设库（优先加载）
│       └── common.yml                  #     通用预设
└── event-mapping/                      # 事件映射脚本目录
    ├── damage-indicator.yml            #   伤害事件 → 指示器
    └── regain-indicator.yml            #   恢复事件 → 指示器

工作原理

1. 事件映射脚本捕获 Bukkit 事件（如 EntityDamageByEntityEvent）
2. 脚本中声明条件判断和动作调用，最终调用 showIndicator 触发显示
3. 指示器决定数字外观（颜色、格式、位置算法）
4. 动画控制数字的运动轨迹和消失方式
5. 所有配置均支持热重载：/wv reload