虚空挖矿活动系统

📝 插件介绍
虚空挖矿活动系统是一款为Minecraft服务器设计的定时活动插件，为玩家提供了一种全新的挖矿体验。插件创建了特殊的"虚空矿机"，玩家需要合作激活这些矿机以生成各种矿物。同时，玩家还需要防御虚空掠夺者的入侵，保护自己辛苦挖掘的矿物资源。这款插件为服务器增添了丰富的互动内容和团队合作机会。

✨ 主要功能
- 🕒 定时活动：每日固定时间自动开启，持续指定时长
- ⚙️ 虚空矿机：特殊的矿物生成装置，需要玩家合作激活
- 🔋 能量系统：矿机拥有有限能量，随时间消耗，最终耗尽
- 🪨 矿物生成：激活的矿机会定期生成各种矿物，包括稀有矿物
- 👾 虚空掠夺者：会定期出现并尝试偷取玩家的矿物
- 🌟 粒子效果：矿机工作时会显示特殊粒子效果
- 📊 数据统计：支持PlaceholderAPI，提供丰富的数据变量
- 🔄 自动重置：活动开始时可选择重置能量耗尽的矿机

🔑 命令列表
| 命令 | 描述 | 权限 |
|------|------|------|
| `/xkkj 获取` | 获取一个虚空矿机物品 | huodongvoidmining.admin |
| `/xkkj 启动` | 手动启动虚空挖矿活动 | huodongvoidmining.admin |
| `/xkkj 停止` | 手动停止虚空挖矿活动 | huodongvoidmining.admin |
| `/xkkj 状态` | 查看当前活动状态和矿机信息 | huodongvoidmining.admin |
| `/xkkj 重载` | 重新加载插件配置 | huodongvoidmining.admin |
| `/xkkj 变量` | 查看所有可用的PlaceholderAPI变量 | huodongvoidmining.admin |

🔑 权限节点
| 权限 | 描述 | 默认 |
|------|------|------|
| `huodongvoidmining.admin` | 允许使用所有管理命令 | op |

📋 PlaceholderAPI 占位符
插件提供了丰富的PlaceholderAPI变量，可以在任何支持PAPI的插件中使用：

活动状态相关变量:
- `%voidmining_activity_running%` - 活动是否正在运行（返回"是"或"否"）
- `%voidmining_activity_time_remaining%` - 活动剩余时间（格式：x小时y分钟）
- `%voidmining_activity_time_next%` - 下次活动开始时间（格式：yyyy-MM-dd HH:mm）

矿机相关变量:
- `%voidmining_machines_count%` - 矿机总数量
- `%voidmining_machines_active_count%` - 激活的矿机数量
- `%voidmining_machines_working_count%` - 正在工作的矿机数量
- `%voidmining_machine_initial_energy%` - 矿机初始能量
- `%voidmining_machine_energy_consumption%` - 矿机每秒能量消耗
- `%voidmining_machine_ore_generation%` - 矿机每秒矿物生成

玩家附近矿机变量:
- `%voidmining_nearest_machine_distance%` - 最近矿机距离
- `%voidmining_nearest_machine_energy%` - 最近矿机能量
- `%voidmining_nearest_machine_energy_percent%` - 最近矿机能量百分比
- `%voidmining_nearest_machine_active%` - 最近矿机是否激活
- `%voidmining_nearest_machine_working%` - 最近矿机是否正在工作
- `%voidmining_nearest_machine_depleted%` - 最近矿机是否能量耗尽

🔧 活动流程

活动开启
1. 每日14:00自动开启活动(可在配置中修改)
2. 活动持续120分钟(可配置)
3. 全服发送消息提示活动开始
4. 所有矿机被激活，能量耗尽的矿机可选择重置

矿机工作
1. 玩家需要在矿机10格范围内保持至少3名玩家(可配置)
2. 满足条件的矿机会开始工作，显示粒子效果
3. 工作中的矿机每秒消耗10点能量(可配置)
4. 矿机每秒生成10个矿物(可配置)，散落在周围3格范围内
5. 生成的矿物会短暂发光，10秒后消失(可配置)

虚空掠夺者
1. 活动期间每60秒(可配置)会生成10个虚空掠夺者
2. 掠夺者会尝试偷取玩家附近的矿物
3. 玩家需要击退掠夺者保护矿物

活动结束
1. 活动时间结束或手动停止时，所有矿机停止工作
2. 能量耗尽的矿机会保持耗尽状态，直到下次活动开始时重置

📝 配置文件
插件提供了详细的配置选项，主要包括：

活动设置
- 开始时间和持续时间
- 是否重置能量耗尽的矿机
- 重置矿机的能量阈值

矿机设置
- 初始能量值
- 能量消耗速率
- 矿物生成速率
- 激活所需的玩家数量
- 粒子效果参数
- 矿物散落范围和发光时间

虚空掠夺者设置
- 生成间隔和数量
- 生成范围和偷取范围
- 偷取速率

矿物列表及权重
- 可自定义生成的矿物类型
- 调整各类矿物的生成权重

🔄 依赖插件
- 必需: Paper 1.20.1
- 可选: PlaceholderAPI (用于显示数据占位符)

💻 技术信息
- 支持版本: 1.20.1+
- API版本: 1.20
- 使用Java 17开发

🛠️ 使用方法
1. 管理员使用 `/xkkj 获取` 获取矿机物品
2. 在适当位置放置矿机
3. 等待每日活动自动开始，或使用 `/xkkj 启动` 手动开始
4. 组织玩家在矿机周围合作激活矿机
5. 收集生成的矿物并防御虚空掠夺者的入侵
6. 活动结束后，矿机会自动停止工作

---
感谢您选择虚空挖矿活动系统插件！如有任何问题或建议，请随时联系我们。