MSRDungeons
MSRDungeons 是一个适用于 Paper/Purpur 的服务端插件,提供可重置的波次制地牢功能,并集成 MythicMobs、队伍参与规则、奖励机制、冷却时间以及结构图(schematic)还原等功能。
专为 Minecraft 1.21.x 构建。
功能特性
- 地牢生命周期状态:
IDLE(空闲)、WAITING(等待中)、ACTIVE(进行中)、COMPLETED(已完成)、FAILED(失败)、RESETTING(重置中)、COOLDOWN(冷却中)
- 手动启动/停止/重置地牢的命令
- 运行开始前的入场窗口期(计时结束后锁定参与者)
- 基于配置的波次系统(包括将 Boss 作为普通 MythicMob 波次生成)
- 通过 UUID 追踪 MythicMob 生成情况
- 队伍规则:
- 仅参与者可以攻击地牢中的怪物
- 参与者离开活跃区域会导致本次运行失败
- 运行期间断线视为死亡
- 难度行为:
EASY(简单):玩家死亡后被移除,其他人继续HARDCORE(硬核):一人死亡导致全队失败
- 每个地牢的时间限制(
timeLimitSeconds) - 成功后的奖励:
- 命令奖励,支持
%player%占位符 - 存储在
players.yml中的代币奖励
- 命令奖励,支持
- 完整重置流程:
- 将参与者传送至安全位置
- 移除剩余受追踪的怪物
- 还原结构图
- 清除运行时状态
- 应用冷却时间
运行时区域行为
在地牢区域内:
- 当地牢正在运行时(
WAITING或ACTIVE):- 玩家获得正常的生存交互权限(建造/使用/互动)
- 当地牢未运行时:
- 建造和交互被阻止
- PvP 允许进行
依赖项
必需
- MythicMobs(怪物生成)
- WorldGuard(区域检查)
用于结构图还原必需
- WorldEdit 或 FAWE
安装步骤
- 在您的 Paper/Purpur 服务器上安装依赖项。
- 将
MSRDungeons-<version>.jar放入plugins/目录。 - 启动服务器一次。
- 进行配置:
plugins/MSRDungeons/config.ymlplugins/MSRDungeons/schematics/<your_file>.schem
- 重载插件:
/msrdungeons reload
命令
/msrdungeons reload/msrdungeons start <id>/msrdungeons stop <id>/msrdungeons reset <id>/msrdungeons cooldown <id>/msrdungeons info <id>/msrdungeons tokens [player]
别名:
/msrd/msrdungeon
权限节点
msrdungeons.admin.reloadmsrdungeons.admin.startmsrdungeons.admin.stopmsrdungeons.admin.resetmsrdungeons.admin.cooldownmsrdungeons.admin.infomsrdungeons.tokens
配置示例
dungeons:
crypt_01:
displayName: "Forgotten Crypt"
tier: EASY
region: "crypt_01_region"
schematic: "crypt_01.schem"
entryWindowSeconds: 45
timeLimitSeconds: 600
cooldownSeconds: 3600
minPlayers: 1
maxPlayers: 5
allowBlockBreak: true
allowBlockPlace: true
startLocation:
world: "world"
x: 100
y: 64
z: 100
safeLocation:
world: "world"
x: 120
y: 64
z: 120
spawnPoints:
spawn_1:
world: "world"
x: 105
y: 64
z: 105
spawn_2:
world: "world"
x: 110
y: 64
z: 110
boss_spawn:
world: "world"
x: 115
y: 64
z: 115
rewards:
tokens: 20
commands:
- "eco give %player% 100"
- "give %player% diamond 2"
tokenRewards:
defaultPerKill: 0
byMob:
CryptZombie: 1
CryptSkeleton: 2
CryptLord: 10
waves:
1:
delaySeconds: 3
mobs:
- mythicMob: "CryptZombie"
amount: 8
spawnPoints: ["spawn_1", "spawn_2"]
2:
delaySeconds: 5
mobs:
- mythicMob: "CryptSkeleton"
amount: 6
spawnPoints: ["spawn_1", "spawn_2"]
3:
delaySeconds: 10
mobs:
- mythicMob: "CryptLord"
amount: 1
spawnPoint: "boss_spawn"
注意:
- 支持并推荐使用
spawnPoints(列表)。 - 旧的单个
spawnPoint仍然支持。
配置参考
根节点
dungeons: 地牢 ID 的映射表。- 示例 ID:
crypt_01 - 此 ID 在命令中使用(例如
/msrdungeons start crypt_01)
- 示例 ID:
地牢基础设置
-
displayName
在插件消息中显示的名称。 -
tier
可选值之一:EASYHARDCORE
-
region
用于地牢边界检查的 WorldGuard 区域 ID。 -
schematic
位于plugins/MSRDungeons/schematics/内的文件名。- 示例:
crypt_01.schem
- 示例:
-
entryWindowSeconds
参与者被锁定且运行开始前经过的时间。 -
timeLimitSeconds
总运行时间限制。0= 禁用>0= 如果时间耗尽且敌人仍存活,则判定运行失败
-
cooldownSeconds
每次完成/失败后,单个地牢的冷却时间。 -
minPlayers/maxPlayers
运行开始时的参与者数量上下限。 -
allowBlockBreak/allowBlockPlace
来自早期逻辑的旧式开关。当前的运行时模式由地牢状态控制:- 运行中(
WAITING/ACTIVE):类原版交互 - 未运行:保护模式
- 运行中(
位置
-
startLocation
当运行进入ACTIVE状态时,队伍将被传送至此位置。 -
safeLocation
完成/失败/重置后的传送目的地。 -
spawnPoints
波次怪物生成使用的命名坐标点。
奖励
-
rewards.tokens
每位获胜者获得的固定完成代币奖励。 -
rewards.commands
为每位获胜者执行的控制台命令。- 支持
%player%占位符。
- 支持
击杀代币奖励
-
tokenRewards.defaultPerKill
对于未在byMob中列出的任何地牢怪物击杀的默认代币奖励。 -
tokenRewards.byMob.<MythicMobId>
击杀特定 MythicMob 的代币奖励。
完成时的奖励计算公式:
totalTokensForPlayer = rewards.tokens + sum(tokenRewards for player's kills)
波次
每个波次键为数字(1, 2, 3, ...)。
-
delaySeconds
生成该波次之前的延迟时间。 -
mobs条目:mythicMob: MythicMobs 内部 IDamount: 生成数量spawnPoints: 命名生成点列表(推荐)spawnPoint: 单个点(遗留备用方案)
生成分布:
- 如果
spawnPoints包含多个值,怪物将按轮询方式分配。
配置模式
1) 休闲公共地下城
tier: EASYentryWindowSeconds: 45-90timeLimitSeconds: 900+minPlayers: 1,maxPlayers: 6-10- 中等波次,包含大量弱怪
2) 小队挑战
tier: EASYentryWindowSeconds: 20-40timeLimitSeconds: 480-720minPlayers: 3,maxPlayers: 5- 混合波次,第 2 波及之后出现更强的精英怪
3) 硬核副本
tier: HARDCOREentryWindowSeconds: 15-30timeLimitSeconds: 300-480minPlayers: 4,maxPlayers: 6- 怪物数量较少,但具有高伤害/高生存能力
基于状态的行为
地下城运行中 (WAITING/ACTIVE)
- 参与者在进入窗口期内被收集
- 在激活开始时,参与者会被传送至
startLocation - 强制执行地下城怪物战斗规则
- 若有存活参与者离开活动区域 = 立即失败
- 成功通关后,聊天栏显示每位玩家的击杀统计和击杀代币总数
地下城未运行 (IDLE/COOLDOWN)
- 禁止在地下城区域内建造/交互
- 允许在地下城区域内进行 PvP
常见错误配置
-
错误的 MythicMob ID
症状:波次未能生成,运行失败。
修复:检查plugins/MythicMobs/Mobs/*.yml中的 ID。 -
错误的区域名称
症状:未检测到参与者,运行流程中断。
修复:确保region与 WorldGuard 区域 ID 完全匹配。 -
缺少结构文件
症状:启动时因结构还原错误而失败。
修复:将文件放入plugins/MSRDungeons/schematics/。 -
生成点名称拼写错误
症状:部分波次未生成。
修复:确保每个波次的spawnPoints值均存在于spawnPoints:映射中。
管理员须知
- 在执行
/msrdungeons start <id>时,会在打开进入窗口之前执行结构还原。 - 如果参与者在地下城活动期间离开活动区域,运行将立即失败。
- 如果时间限制到期时仍有敌人存活,运行将失败。
兼容性
- Paper 1.21.x
- Purpur 1.21.x
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
自定义你的Minecraft头像!
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧