MSRdungeons

插件

· 作者 Van1boy

MSRDungeons 是一个适用于 Paper/Purpur 的插件,提供**可重置的波次型地下城**功能,支持 MythicMobs 集成、队伍参与规则、奖励机制、冷却时间以及结构还原。

0 本站下载 0 关注 更新于 5 个月前

最新 1.0.1 · 1.21.11 · Paper / Purpur

一键开服(送7天)

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 允许进行

依赖项

必需

用于结构图还原必需

安装步骤

  1. 在您的 Paper/Purpur 服务器上安装依赖项。
  2. 将 MSRDungeons-<version>.jar 放入 plugins/ 目录。
  3. 启动服务器一次。
  4. 进行配置:
    • plugins/MSRDungeons/config.yml
    • plugins/MSRDungeons/schematics/<your_file>.schem
  5. 重载插件:
    • /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.reload
  • msrdungeons.admin.start
  • msrdungeons.admin.stop
  • msrdungeons.admin.reset
  • msrdungeons.admin.cooldown
  • msrdungeons.admin.info
  • msrdungeons.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)

地牢基础设置

  • displayName
    在插件消息中显示的名称。

  • tier
    可选值之一:

    • EASY
    • HARDCORE
  • 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 内部 ID
    • amount: 生成数量
    • spawnPoints: 命名生成点列表(推荐)
    • spawnPoint: 单个点(遗留备用方案)

生成分布:

  • 如果 spawnPoints 包含多个值,怪物将按轮询方式分配。

配置模式

1) 休闲公共地下城

  • tier: EASY
  • entryWindowSeconds: 45-90
  • timeLimitSeconds: 900+
  • minPlayers: 1, maxPlayers: 6-10
  • 中等波次,包含大量弱怪

2) 小队挑战

  • tier: EASY
  • entryWindowSeconds: 20-40
  • timeLimitSeconds: 480-720
  • minPlayers: 3, maxPlayers: 5
  • 混合波次,第 2 波及之后出现更强的精英怪

3) 硬核副本

  • tier: HARDCORE
  • entryWindowSeconds: 15-30
  • timeLimitSeconds: 300-480
  • minPlayers: 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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源