# VitalVials 插件
VitalVials 是一个独特的 Minecraft 插件，允许玩家使用他们的生命值购买和管理游戏效果。通过完全可定制的配置，服务器所有者可以在风险和回报之间取得平衡，玩家必须仔细权衡强大的效果与自身生命力的成本。
## 特色功能
- **基于生命值的经济系统**: 玩家用最大生命值/生命点来换取强大的效果
- **完全可配置**: 可以定制效果、成本和机制的各个方面
- **动态计分板**: 实时跟踪已激活的效果和剩余持续时间
- **玩家专属设置**: 每个玩家可以自定义自己的计分板
- **冷却系统**: 通过可配置的冷却时间防止效果滥用
- **退款系统**: 可以退还效果（每个效果可配置）
## 安装
1. 从 [releases 页面](https://github.com/b4n9z/VitalVials/releases) 下载 VitalVials 的最新版本。
2. 将 `VitalVials.jar` 文件放入服务器的 `plugins/` 目录中。
3. 重启服务器。
4. 在 `plugins/VitalVials/config.yml` 和 `plugins/VitalVials/effects.yml` 和 `plugins/VitalVials/activation.yml` 中配置插件以符合您的喜好。
5. 使用 `/vv reload` 命令应用更改，无需重启。
## 指令
### 主指令
- `/vv` 或 `/vitalvials` - VitalVials 的主指令
### 子指令
- `/vv reload` - 重新加载插件配置
- `/vv shop` - 打开效果商店
- `/vv buyEffect ` - 直接购买效果
- `/vv viewStatus` - 查看您当前的激活效果
- `/vv scoreboard ` - 切换或自定义您的计分板
- `/vv refundEffect ` - 退还效果
- `/vv removeData ` - 移除玩家数据
## 权限
| 权限 | 描述 | 默认 |
|-------------------|------------------------------------|---------|
| `vv.admin` | 对所有命令拥有完全访问权限 | op |
| `vv.reload` | 允许重新加载插件 | op |
| `vv.shop` | 访问效果商店 | op |
| `vv.buyEffect` | 允许购买效果 | op |
| `vv.viewstatus` | 查看自身效果状态 | op |
| `vv.scoreboard` | 访问计分板自定义 | op |
| `vv.refundEffect` | 退还已购买的效果 | op |
| `vv.removedata` | 移除玩家数据 | op |
## 配置
VitalVials 通过 `config.yml`、`effects.yml` 和 `activation.yml` 文件进行高度配置。以下是主要部分：
### 主配置
### 效果配置
每个效果都可以配置以下选项：
- `enabled`: 启用/禁用效果
- `name`: 在商店中显示的效果名称
- `effect`: 要给予的效果名称（默认），如果您不确定，请不要更改
- `lore`: 商店中的效果描述
- `maxLevel`: 效果的最大等级/放大器
- `particles`: 获得效果时是否显示粒子效果
- `saveEffectData`: 是否将效果数据保存到玩家数据中
- `priceType`: 购买效果时价格类型（使用玩家最大生命值 MAX_HEALTH 或使用玩家生命值 HEALTH）
- `refundPercentage`: 购买效果后可退还的 HP 百分比（以等级 1 效果计算）（-1 表示禁用退款）
- `autoActivate`: 购买后是否自动激活效果，如果为 false，则需要在 activation 配置中设置
(`[<等级 1>, <等级 2>, 等]`）数组部分：
- `durationPerUpgrade`: 每个升级的持续时间（以秒为单位），-1 表示无限
- `cooldownPerUpgrade`: 每个升级的冷却时间（以秒为单位）
- `costPerUpgrade`: 升级后激活效果的生命值成本（生命点）
### 激活配置
您可以配置每个物品的激活效果，方法是编辑 `activation.yml` 文件。
## 效果定制
效果在插件文件夹的 `effects.yml` 中定义。 例如：
## 计分板
可以使用 `/vv scoreboard` 命令切换计分板，并使用以下选项自定义：
- 切换可见性
- 更改效果显示顺序
## 支持
如果需要支持，请在 [GitHub 上打开一个 issues](https://github.com/b4n9z/VitalVials/issues)。
## 许可
此项目采用 MIT 许可证 - 详情请参阅 [LICENSE](https://github.com/b4n9z/VitalsVials/blob/main/LICENSE) 文件。
---
Crafted by b4n9z