Potion Box

# xH_PB 药水匣插件

一个为 Minecraft 服务器设计的药水存储与管理插件，支持将药水存入虚拟仓库并根据存储数量获得永久药水效果。

## 功能特性

- **药水存储系统**：将多余的药水存入虚拟仓库，节省背包空间
- **永久效果系统**：根据存储的药水数量自动获得对应等级的永久药水效果
- **GUI 界面管理**：直观的图形界面，支持点击存取药水
- **批量操作**：支持 Shift+点击批量存取药水
- **高度可配置**：效果等级阈值、最大存储数量等均可自定义
- **数据持久化**：玩家数据自动保存，重启服务器不丢失

## 支持的药水类型

- 迅捷 (Speed)
- 力量 (Strength)
- 生命恢复 (Regeneration)
- 抗火 (Fire Resistance)
- 夜视 (Night Vision)
- 水下呼吸 (Water Breathing)
- 跳跃提升 (Jump Boost)
- 抗性提升 (Resistance)

## 效果等级系统

| 等级 | 所需药水数量 | 效果等级 |
|------|-------------|---------|
| I    | 5 瓶        | 效果 I  |
| II   | 15 瓶       | 效果 II |
| III  | 30 瓶       | 效果 III|

*阈值可在配置文件中自定义*

## 安装方法

1. 下载 `xh_pb-0.0.1.jar` 文件
2. 将 JAR 文件放入服务器的 `plugins` 文件夹
3. 重启服务器或加载插件
4. 编辑 `plugins/xH_PB/config.yml` 进行自定义配置（可选）

## 使用方法

### 打开药水匣

/xhpotionbox

或使用简写：

/xhpb

### 存入药水
1. 打开药水匣 GUI
2. 将背包中的药水点击放入 GUI 下方格子
3. 药水会自动存入对应类型的仓库

### 取出药水
1. 打开药水匣 GUI
2. 点击上方格子中的药水图标
3. 左键点击取出一瓶，Shift+点击取出一组（16瓶）

### 查看效果
存入足够数量的药水后，永久效果会自动生效。可以在游戏界面的效果栏查看当前效果。

## 配置文件

```yaml
# 药水匣GUI设置
potionbox:
  title: "&a药水匣"
  size: 54
  shift-click-amount: 16
  max-storage-amount: 9999

# 允许的药水类型
allowed-potions:
  - SPEED
  - STRENGTH
  - REGENERATION
  - FIRE_RESISTANCE
  - NIGHT_VISION
  - WATER_BREATHING
  - JUMP_BOOST
  - RESISTANCE

# 效果等级阈值设置
effect-levels:
  SPEED:
    level-1: 5
    level-2: 15
    level-3: 30
  # ... 其他药水类型

权限节点

权限	说明
xhpb.use	使用药水匣命令
xhpb.admin	管理员权限（重载配置等）

命令列表

命令	说明
/xhpotionbox	打开药水匣 GUI
/xhpotionbox reload	重载配置文件（需要管理员权限）

技术信息

• 开发平台: Paper/Spigot 1.21+
• Java 版本: Java 21
• 开发方式: 使用 AI 辅助开发

版权信息

版权所有 (c) 2026 liyughj 保留所有权利。

本插件使用 AI 辅助开发。

本插件可免费使用和分享，但未经许可不得：

• 反编译
• 声称是自己开发

作者不对使用本插件造成的任何问题负责。

联系方式

• GitHub: https://github.com/liyughj

更新日志

v0.0.1

• 初始版本发布
• 实现药水存储系统
• 实现永久效果系统
• 添加 GUI 界面
• 支持批量存取操作