虚空裂缝活动系统

📝 插件介绍
虚空裂缝活动系统是一款为Minecraft服务器打造的高级PVE活动插件，为玩家提供了一种紧张刺激的团队合作体验。在活动中，虚空裂缝会在世界中打开，源源不断地涌出各种怪物。玩家需要合作击杀这些怪物来关闭裂缝，保卫世界安全。插件设计了完整的活动流程、裂缝管理系统和奖励机制，为服务器增添了一项高度可定制的大型活动。

✨ 主要功能
- 🕒 定时活动：每日固定时间自动开启，持续指定时长
- 🌋 裂缝系统：可视化设置多个裂缝位置，状态实时显示
- 👾 怪物生成：从裂缝中源源不断涌出怪物，数量随时间增加
- 🔄 扩张机制：裂缝定期扩张，增加怪物数量和难度
- 🏆 击杀计数：记录玩家击杀怪物数量，达到目标后关闭裂缝
- 💰 奖励系统：关闭裂缝后全服玩家获得奖励，奖励随裂缝数量增加
- 📊 数据统计：支持PlaceholderAPI，提供丰富的数据变量
- 🧠 智能刷怪：根据环境自动选择适合的怪物类型和位置

🔑 命令列表
| 命令 | 描述 | 权限 |
|------|------|------|
| `/voidrift start` | 手动开启活动 | voidrift.admin |
| `/voidrift stop` | 手动关闭活动 | voidrift.admin |
| `/voidrift info` | 查看活动信息和状态 | voidrift.use |
| `/voidrift spawn [数量]` | 手动生成指定数量的怪物 | voidrift.admin |
| `/voidrift reload` | 重新加载配置文件 | voidrift.admin |
| `/liefeng set <序号> <半径> [传送门ID]` | 设置怪物刷新点 | voidrift.admin |
| `/liefeng help` | 显示帮助信息 | voidrift.admin |

> 主命令 `/voidrift` 可以使用简写 `/vr`

🔑 权限节点
| 权限 | 描述 | 默认 |
|------|------|------|
| `voidrift.admin` | 允许使用所有管理命令 | op |
| `voidrift.use` | 允许查看活动信息 | true |

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

裂缝状态变量:
- `%voidrift_portal_<id>%` - 显示指定ID的裂缝状态
- `%voidrift_active%` - 显示活动是否正在进行中
- `%voidrift_total_portals%` - 显示总裂缝数量
- `%voidrift_closed_portals%` - 显示已关闭的裂缝数量
- `%voidrift_active_portals%` - 显示活跃的裂缝数量

怪物和击杀变量:
- `%voidrift_monster_health%` - 显示当前怪物血量倍率
- `%voidrift_kills%` - 显示当前总击杀数
- `%voidrift_player_kills%` - 显示玩家个人击杀数
- `%voidrift_required_kills%` - 显示关闭一个裂缝所需的击杀数

奖励相关变量:
- `%voidrift_next_points_reward%` - 显示下一个裂缝关闭的点券奖励
- `%voidrift_next_money_reward%` - 显示下一个裂缝关闭的金币奖励
- `%voidrift_player_total_points%` - 显示玩家已获得的总点券奖励
- `%voidrift_player_total_money%` - 显示玩家已获得的总金币奖励

🔧 活动流程

活动准备
1. 管理员使用下界合金剑点击两个上下点的方块来选择传送门范围
2. 使用 `/liefeng set <序号> <半径>` 设置怪物刷新点
3. 可设置多个传送门和刷新点，形成多区域活动

活动开启
1. 每日12:00自动检查开启条件(可在配置中修改)
2. 需要活动世界内有至少8名玩家(可配置)
3. 玩家数量不足时，系统每10分钟检查一次，直到满足条件
4. 活动开始时，传送门范围内的黑色混凝土变为红色，代表裂缝激活

怪物生成
1. 每个刷新点初始生成10个怪物(可配置)
2. 每5分钟裂缝扩张一次，每个刷新点增加5个怪物(可配置)
3. 怪物会在指定半径范围内随机生成
4. 系统会智能判断室内/室外环境，选择合适的怪物类型

裂缝关闭
1. 玩家击杀怪物，全局统计击杀数量
2. 累计击杀100只怪物(可配置)后，随机关闭一个裂缝
3. 关闭的裂缝对应的红色混凝土变为绿色
4. 关闭裂缝后，与其关联的刷新点停止生成怪物

活动结束
1. 活动持续2小时后自动结束(可配置)
2. 或者所有裂缝都被关闭后结束
3. 活动结束时，所有传送门变回黑色混凝土
4. 全服公告活动结束，显示参与玩家和关闭裂缝数量

奖励发放
1. 每关闭一个裂缝，立即向全服所有在线玩家发放奖励
2. 基础奖励为100点券和1000金币(可配置)
3. 每关闭一个裂缝，奖励增加10%(可配置)
4. 可配置自定义奖励命令列表

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

活动设置
- 活动世界、开始时间和持续时间
- 最低玩家数量和检查间隔
- 裂缝扩张间隔和怪物增加数量
- 关闭裂缝所需的击杀数量

怪物设置
- 基础血量倍率和增长机制
- 强化怪物的额外血量倍率
- 活动结束时是否清理世界生物

方块和工具设置
- 未激活、激活和关闭状态的方块类型
- 传送门选择工具类型

奖励设置
- 基础点券和金币奖励
- 奖励增长倍率
- 自定义奖励命令列表

消息和占位符设置
- 各类提示消息和广播内容
- 占位符显示文本格式

🔄 依赖插件
- 可选: Vault (经济系统)
- 可选: PlayerPoints (点券系统)
- 可选: PlaceholderAPI (显示数据占位符)

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

🛠️ 特殊功能

室内刷怪系统
- 自动检测环境类型(室内/室外)
- 根据环境选择合适的怪物种类
- 智能Y坐标查找算法，不再依赖世界最高方块位置

怪物血量动态调整
- 基础血量倍率可配置
- 每关闭一个裂缝，怪物血量增加一定百分比
- 强化怪物有额外的血量倍率

传送门与刷怪点关联系统
- 每个刷怪点可以关联到特定的传送门
- 当传送门关闭时，与其关联的所有刷怪点将被禁用

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