- 版权类型
- 原创
- 插件中文名称
- 副本菜单
- 插件英文名称
- CyDungeonM
- 支持的核心（服务端）
- Paper
- 语言支持
- 中文（简体）
- 前置组件
- QueDP http://m3.pulidc.com:9999/guide/getting-started.html
MythicMobs https://modrinth.com/plugin/mythicmobs
- 适配版本（Java）
- 1.21
🗺 CyDungeonM
副本菜单 · 让玩家自己组队进本
QueDP 附属 / 队伍管理 / 排行榜 / 商店 / 波次控制
你是不是也遇到过
- 副本全靠指令，玩家记不住 ID，天天在群里问
- 组队要手动拉人，队长踢人还得打指令
- 副本排行榜只能看后台，玩家没有竞争感
- 打本打到一半有人传送跑了，整队卡住
服主 说：
CyDungeonM 就是把 QueDP 的副本包成一套菜单。
核心功能
- 副本菜单：图形化列表，显示副本图标、人数、冷却和状态
- 进本确认：点副本 → 确认界面 → 全队进入，防误点
- 队伍系统：创建、邀请、申请、审批、踢人、转让、解散、公开招募
- 队伍上限：人数由本插件控制，不跟 QueDP 冲突
- 排行榜：GUI 排行榜 + 聊天列表，支持清除成绩和删除记录
- 副本商店：打本获得的货币直接换物品，商店内容可配置
- 波次控制：查看当前波次，管理员可跳过
- 副本内指令锁：挑战期间禁掉 tp / home / warp 等传送指令
- 菜单自动刷新：冷却倒计时、队伍变化实时更新
三个常见场景
日常副本
玩家
/cdm menu 选本 → 组队 → 确认进本，全程不用记指令。
竞速排行
按通关时间排行，
/cdm top 直接看榜，前几名有成就感。
防跳车
dungeon-command-lock 开启后，副本内用不了传送，减少中途跑路。
运行环境
- 服务端：Paper 1.21.11
- Java：21 及以上
- 硬依赖：QueDP（必须安装，否则插件不启动）
- 软依赖：Vault / PlayerPoints / PlaceholderAPI / CraftEngine（可选）
注意：这是 QueDP 的附属插件，不能单独使用。
安装
- 先安装 QueDP 并确认副本能正常开
- 把
CyDungeonM-1.2.7.jar放进plugins/ - 重启服务器，生成
config.yml、messages.yml、shops.yml、menu/ - 按需修改菜单和商店，执行
/cdm reload
命令
/cdm menu—— 打开副本菜单/cdm enter <副本ID>—— 直接进入副本/cdm leave—— 离开当前副本/cdm confirm—— 确认进入副本/cdm top—— 打开排行榜界面/cdm top list [副本ID] [页码]—— 聊天查看排行榜/cdm top clear <玩家> [副本ID]—— 清除玩家成绩/cdm top remove <名次> [副本ID]—— 删除指定记录/cdm shop [商店]—— 打开副本商店/cdm party—— 打开队伍界面/cdm party create [队名]—— 创建队伍/cdm party invite <玩家>—— 邀请玩家/cdm party leave—— 离开队伍/cdm help—— 帮助
权限
cydungeonm.use—— 打开菜单 / 排行榜 / 商店，默认所有玩家cydungeonm.party—— 使用队伍功能，默认所有玩家cydungeonm.admin—— 管理权限（reload / info / instance / wave / kick），默认 OP
配置示例
YAML：
party:
max-size: 10 # 队伍人数上限
invite-timeout: 60 # 邀请超时（秒）
apply-timeout: 60 # 入队申请超时（秒）
menu:
refresh-ticks: 20 # 菜单刷新间隔，20 = 1 秒
dungeons:
fail-on-player-leave: true # 队员中途离开 → 整队失败
blacklist:
- example # 不在菜单显示的副本
dungeon-command-lock:
enabled: true
mode: blacklist # whitelist / blacklist
allow-admin: true
blacklist:
- tp
- home
- warp
- back
leaderboard:
page-size: 28
cache-seconds: 60
shop:
close-after-buy: false
logs:
enabled: true
retention-days: 7
常见问题
Q：启动报错说缺少 QueDP？
这是硬依赖，必须先装 QueDP 并让它的副本能正常运行。
Q：副本菜单是空的？
检查 QueDP 里是否已创建副本，再看
dungeons.blacklist 有没有被排除。Q：队伍人数上限在哪改？
改
party.max-size。注意 QueDP 那边的队伍上限要设得更大，作为天花板。Q：副本里用不了 /tp？
正常，
dungeon-command-lock 默认拦截传送类指令。管理员可以用 allow-admin 放行。Q：排行榜没数据？
需要有玩家实际通关记录；
cache-seconds 是缓存时间，改成 0 可以每次实时读取。Q：商店在哪配置？
shops.yml 里配置商品和价格，改完 /cdm reload。
文档
license.mc33.top/docs/cydungeonm
如果这个插件帮到了你，欢迎评分和反馈。
