- 版权类型
- 原创
- 插件中文名称
- 深渊兽潮
- 插件英文名称
- AbyssMobSurge
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- 语言支持
- 中文(简体)
- 前置组件
- MythicMobs
- 适配版本(Java)
- 1.21
- 1.20
[MD]
## 插件描述
### 核心功能
**传送门系统**
- 主传送门:玩家进入副本的入口,支持粒子特效和悬浮字显示
- 兽潮门:怪物生成点,可配置多个生成位置
- 传送门链接:主门和兽潮门的关联管理
- 可视化创建和管理界面
**副本系统**
- 完整的副本生命周期管理(准备、进行中、完成、失败)
- 4个难度等级:简单、普通、困难、地狱
- 难度影响怪物数量和Boss强度
- 副本时间限制和倒计时
- 副本状态实时显示
**怪物波次系统**
- 可配置的波次数量和怪物类型
- 支持原版怪物和MythicMobs自定义怪物
- 每波怪物数量可独立设置
- 波次间隔时间控制
- 怪物生成位置随机化
**Boss战斗系统**
- Boss血量条显示(BossBar)
- Boss击杀奖励
**队伍系统**
- 创建和解散队伍
- 邀请和踢出成员
- 队长权限管理
- 队伍聊天频道
- 队伍成员列表显示
**奖励系统**
- 5个品质等级:普通、优秀、稀有、史诗、传说
- 概率计算系统
- 奖励池配置
- 奖励预览GUI
- 奖励即时发放
**排行榜系统**
- 击杀数量统计
- 伤害贡献度计算
- 实时排名更新
- 排行榜GUI显示
- 历史记录保存
### 技术特点
- **架构设计**: 模块化设计,管理器、监听器、GUI分层清晰
- **线程安全**: 使用ConcurrentHashMap等线程安全集合
- **空值检查**: 关键位置添加空值检查,防止NPE
- **性能优化**: 异步处理、缓存机制、资源及时释放
- **代码质量**: 完整注释、规范命名、严格错误处理
- **兼容性**: 支持MythicMobs 5.0+,可选依赖设计
- **可维护性**: 清晰的代码结构,易于扩展和修改
### 命令系统
**主命令**
| 命令 | 功能 | 权限 | 示例 |
|------|------|------|------|
| `/abyss` | 打开主菜单 | `abyssmobsurge.use` | 打开GUI主界面 |
| `/abyss help` | 查看帮助 | `abyssmobsurge.use` | 显示所有命令 |
**传送门管理命令**
| 命令 | 功能 | 权限 | 示例 |
|------|------|------|------|
| `/selectportal <1\|2\|info\|clear>` | 选择传送门区域 | `abyssmobsurge.select` | 设置传送门范围 |
| `/createabyssportal <名称> <世界> <X> <Y> <Z> <模式> <波数>` | 创建传送门 | `abyssmobsurge.create` | 创建新传送门 |
| `/abyss manage` | 管理传送门 | `abyssmobsurge.admin` | 打开管理GUI |
| `/abyss delete <ID>` | 删除传送门 | `abyssmobsurge.admin` | 删除指定传送门 |
| `/abyss link <主门ID> <兽潮门ID>` | 链接传送门 | `abyssmobsurge.admin` | 关联主门和兽潮门 |
| `/abyss unlink <主门ID>` | 解除链接 | `abyssmobsurge.admin` | 解除传送门关联 |
| `/abyss list` | 列出所有传送门 | `abyssmobsurge.admin` | 显示传送门列表 |
**副本管理命令**
| 命令 | 功能 | 权限 | 示例 |
|------|------|------|------|
| `/abyss start <传送门ID>` | 开启副本 | `abyssmobsurge.admin` | 手动开启副本 |
| `/abyss stop <传送门ID>` | 停止副本 | `abyssmobsurge.admin` | 强制停止副本 |
| `/abyss status <传送门ID>` | 查看副本状态 | `abyssmobsurge.admin` | 显示副本信息 |
| `/abyss difficulty <传送门ID> <难度>` | 设置难度 | `abyssmobsurge.admin` | 设置副本难度 |
**怪物波次命令**
| 命令 | 功能 | 权限 | 示例 |
|------|------|------|------|
| `/abyss wave <传送门ID>` | 配置波次 | `abyssmobsurge.admin` | 打开波次配置GUI |
| `/abyss nextwave <传送门ID>` | 强制下一波 | `abyssmobsurge.admin` | 跳过当前波次 |
| `/abyss clearwave <传送门ID>` | 清除当前波 | `abyssmobsurge.admin` | 清除所有怪物 |
**奖励管理命令**
| 命令 | 功能 | 权限 | 示例 |
|------|------|------|------|
| `/portalreward <传送门ID>` | 配置奖励 | `abyssmobsurge.reward` | 打开奖励配置GUI |
| `/abyss givereward <玩家> <传送门ID>` | 发放奖励 | `abyssmobsurge.admin` | 手动发放奖励 |
**钥匙管理命令**
| 命令 | 功能 | 权限 | 示例 |
|------|------|------|------|
| `/portalkey <传送门ID>` | 创建传送门钥匙 | `abyssmobsurge.key` | 生成钥匙物品 |
**队伍管理命令**
| 命令 | 功能 | 权限 | 示例 |
|------|------|------|------|
| `/abyss team create` | 创建队伍 | `abyssmobsurge.use` | 创建新队伍 |
| `/abyss team disband` | 解散队伍 | `abyssmobsurge.use` | 解散自己的队伍 |
| `/abyss team invite <玩家>` | 邀请玩家 | `abyssmobsurge.use` | 邀请加入队伍 |
| `/abyss team kick <玩家>` | 踢出玩家 | `abyssmobsurge.use` | 踢出队伍成员 |
| `/abyss team leave` | 离开队伍 | `abyssmobsurge.use` | 离开当前队伍 |
| `/abyss team list` | 查看队伍 | `abyssmobsurge.use` | 显示队伍成员 |
**排行榜命令**
| 命令 | 功能 | 权限 | 示例 |
|------|------|------|------|
| `/abyss leaderboard` | 查看排行榜 | `abyssmobsurge.use` | 显示击杀排行 |
| `/abyss stats` | 查看个人统计 | `abyssmobsurge.use` | 显示个人数据 |
| `/abyss top` | 查看前10名 | `abyssmobsurge.use` | 显示排行前10 |
**系统命令**
| 命令 | 功能 | 权限 | 示例 |
|------|------|------|------|
| `/abyss reload` | 重载配置 | `abyssmobsurge.admin` | 重载所有配置 |
| `/abyss debug <on\|off>` | 调试模式 | `abyssmobsurge.admin` | 开启/关闭调试 |
| `/abyss version` | 查看版本 | `abyssmobsurge.use` | 显示插件版本 |
**命令使用示例**
```bash
# 玩家使用
/abyss # 打开主菜单
/abyss team create # 创建队伍
/abyss team invite Steve # 邀请Steve加入队伍
/abyss leaderboard # 查看排行榜
/abyss stats # 查看我的统计
# 管理员使用 - 创建传送门流程
/selectportal 1 # 站在第一个角落设置位置1
/selectportal 2 # 站在对角位置设置位置2
/createabyssportal 地狱深渊 world_nether 100 64 200 KEY_CONTROL 10
/portalkey <传送门ID> # 创建钥匙
/portalreward <传送门ID> # 配置奖励
# 管理员使用 - 副本控制
/abyss manage # 管理传送门(打开GUI)
/abyss difficulty <ID> HARD # 设置困难难度
/abyss start <ID> # 手动开启副本
/abyss reload # 重载配置
**权限节点**
# 玩家权限
abyssmobsurge.use # 基础使用权限
abyssmobsurge.portal.enter # 进入传送门
abyssmobsurge.team.create # 创建队伍
abyssmobsurge.team.invite # 邀请队员
abyssmobsurge.leaderboard # 查看排行榜
# 管理员权限
abyssmobsurge.admin # 管理员权限(所有功能)
abyssmobsurge.select # 选择传送门区域
abyssmobsurge.create # 创建传送门
abyssmobsurge.portal.delete # 删除传送门
abyssmobsurge.portal.manage # 管理传送门
abyssmobsurge.instance.control # 控制副本
abyssmobsurge.reward # 配置奖励
abyssmobsurge.key # 创建钥匙
abyssmobsurge.reload # 重载配置
abyssmobsurge.debug # 调试模式
# 通配符权限
abyssmobsurge.* # 所有权限
### 管理功能
**GUI管理界面**
- 传送门创建和编辑
- 怪物波次配置
- 奖励池管理
- 难度设置
- 实时状态监控
**配置系统**
- YAML配置文件
- 热重载支持
- 配置验证
- 默认配置生成
### 适用场景
- **RPG服务器**: 提供完整的副本挑战系统
- **生存服务器**: 增加PVE内容,丰富游戏玩法
- **小游戏服务器**: 作为团队挑战玩法
- **经济服务器**: 通过副本奖励调节经济
- **社区服务器**: 促进玩家协作和互动
QQ群:1064383393
[/MD]