指令与权限

主指令 /clouddungeon，别名 /cd、/dungeon。所有子指令都有 Tab 补全。 <> 必填，[] 可省略。

玩家指令

指令	说明
/cd	打开副本大厅；在副本里输入则打开副本内菜单
/cd help	指令说明（有管理员权限时多一行管理员指令提示）
/cd list	副本列表、进行中场数，以及地图是否已保存
/cd info <副本>	打开副本详情菜单
/cd join <副本> [模式]	开始挑战（只有队长能开始）。别名 start、play
/cd leave	离开当前副本（也可以用 /leave，见下方）
/cd party	打开队伍菜单
/cd party create	建立只有自己的队伍
/cd party invite [玩家]	邀请玩家；不写玩家名则打开邀请菜单
/cd party accept / deny	接受 / 拒绝邀请
/cd party leave	离开队伍（队长离开时自动转给下一位）
/cd party disband	解散队伍（队长）
/cd party kick <玩家>	请出队员（队长）
/cd party transfer <玩家>	转让队长，别名 leader
/cd party chat [信息]	不带信息 = 切换队伍聊天模式；带信息 = 发一条队伍信息
/cd party recruit [副本] [备注]	开关公开招募（出现在招募板上）
/cd party join <队长>	向正在招募的队伍申请加入，别名 request
/cd party approve <玩家> / reject <玩家>	同意 / 拒绝加入申请（队长）
/cd pc <信息>	发一条队伍信息
/cd ready / /cd decline	准备确认：准备 / 这次不去（decline 会取消这次出发）
/cd recruit	打开招募板
/cd queue <副本> [模式]	快速配对排队；/cd queue leave 退出排队。别名 match
/cd top [副本]	排行榜；不写副本则打开我的记录
/cd records	我的记录，别名 stats
/cd revive	在副本里使用复活道具（副本设置了 lives.item-revive 时）
/cd stamina	查看自己的体力（config.yml 开启了 stamina 时）

组队、准备与配对的完整流程见 组队、准备与快速配对。

/leave 快捷指令

/leave 是离开副本的快捷指令，名称由 config.yml 的 leave-command 决定：第一个是指令名，后面是别名，写 [] 则不注册。 不在副本里但正在快速配对排队时，/leave 会退出排队。

和其他插件的 /leave 撞名时，本插件的版本仍然可以用 /clouddungeon:leave；控制台启动时会提示撞名。 leave-command 里的指令（以及 /cd leave）在副本里一定可以用，不管 rules.commands 是白名单、黑名单还是只能离开，不用另外写进 list。

管理员指令

管理员指令都在 /cd admin（简写 /cd a）下面，需要 clouddungeon.admin。

建立与编辑

指令	说明
/cd admin create <ID> [显示名称]	用模板建立新副本文件夹并直接进入编辑模式。ID 只能用英文、数字、_、-，最长 32 字
/cd admin edit <副本> [reset]	进入编辑模式；reset = 清空编辑区，换回已保存的地图
/cd admin save [stay]	保存地图（自动计算范围）并离开；stay = 存完留在编辑模式
/cd admin exit	不保存方块离开（点位一直都是即时保存的）。别名 cancel、quit
/cd admin menu	打开编辑菜单
/cd admin tools	重新拿一套编辑工具
/cd admin input <文字>	回答编辑模式的聊天提问（聊天栏里的可点击选项就是用这个）
/cd admin point list	列出这个副本的所有点位
/cd admin point tp <名称>	传送到点位
/cd admin point remove <名称>	删除这个名称的所有点位，别名 del
/cd admin point add <种类> <名称>	在脚下新增点位，种类：spawn mob point interact npc chest（区域和障碍要用工具框选）
/cd admin import selection	把 WorldEdit 选区（任何世界）复制进编辑区
/cd admin import world <世界> [半径]	把某个世界出生点周围（默认半径 150）整块复制进编辑区
/cd admin delete <副本> confirm	删除副本：文件夹移到 dungeons/.trash/（进行中或有人在编辑时不能删）

测试与检查

指令	说明
/cd admin test <副本> [模式]	测试开一场：不检查人数、条件、冷却与次数，不扣入场券，不计次数与排行，通关时不发任何奖励
/cd admin validate [副本]	检查设置：找不到的点位、怪物、脚本组、地图没保存……不写副本则检查全部
/cd admin info <副本>	怪物组总览（每组的怪、数量、出怪点数量、怪物是否存在）、触发组 / 任务组 / 脚本组、地图大小与点位数
/cd admin list	同 /cd list
/cd admin reload	重新读取全部设置（进行中的副本继续用旧设置跑完），并列出所有警告
/cd admin status	进行中场数、格子状态（空 / 预热 / 使用中 / 贴图中 / 清理中）、上次贴图耗时、地图引擎、数据库、MythicMobs、经济

控制台也能开副本：/cd join <副本> <玩家> [模式]、/cd admin test <副本> <玩家> [模式]，以这位玩家（队长）的身份开始，适合接 NPC 或菜单插件。

进行中的副本

指令	说明
/cd admin instance list	列出进行中的副本：编号、阶段、目标、用时、成员、格子。别名 inst、i
/cd admin instance info <编号>	怪物组状态、每位成员的击杀 / 死亡 / 生命、副本变量
/cd admin instance tp <编号>	传送到这场的当前存档点
/cd admin instance stop <编号>	强制结束，退还入场券与次数
/cd admin instance clear <编号> / fail <编号>	直接判定通关 / 失败
/cd admin instance group <编号> <怪物组>	叫出某个怪物组
/cd admin instance var <编号> [名称 值]	查看 / 修改副本变量
/cd admin kick <玩家>	把玩家移出副本

玩家数据与其他

指令	说明
/cd admin ticket list	列出 tickets.yml 里的入场券
/cd admin ticket give <券> <玩家> [数量]	发放入场券
/cd admin reset <玩家> [副本]	清除玩家的次数与冷却（不写副本 = 全部）
/cd admin prewarm	查看预热状态
/cd admin prewarm <副本> [数量]	立刻多预热几份这个副本的地图
/cd stamina <玩家> [set|add|take] <数量>	查看 / 修改玩家体力（管理员；注意不在 admin 底下）

旧版的写法（/cd test、/cd reload、/cd validate、/cd edit 这类直接写在 /cd 后面的管理员指令）仍然可以用，说明里只列 /cd admin。

示例：

/cd admin create frost_hall &b霜烬古殿
/cd admin test frost_hall hard
/cd admin ticket give frost_key Steve 3
/cd admin instance stop 12

权限

权限	默认	说明
clouddungeon.use	所有人	玩家基本权限：使用 /cd（以及 /leave 快捷指令）都要有这个权限。有 clouddungeon.admin 的人一律可以用
clouddungeon.admin	OP	全部 /cd admin 指令；看得到 hidden: true 的副本；可以进入副本世界、登录时不会被送出副本世界
clouddungeon.bypass	无人	在副本世界里不受任何副本限制（指令限制、方块、珍珠……），测试用。OP 默认也没有，需要单独给
clouddungeon.command.<指令>	无人	在副本里可以用这个指令，不管 rules.commands 是什么模式。例如 clouddungeon.command.spawn = 副本里可以用 /spawn

每个副本还可以在 config.yml 的 requirements.permission 设置挑战权限，队伍里每个人都要有才能开始，见 副本设置。