原创 娱乐 QzDunegon——你的下一个地牢又何必是自己配置 1.0

[MD] # QzDungeon —— 高性能实例化副本系统 | 波次刷怪 / 体力 / 组队 / 排队 / 全 GUI 可视化编辑 > 原创插件 | Paper 1.21+（实测 1.21.11） | 软依赖 MythicMobs / Vault / PlaceholderAPI ## 🗡️ 这是什么？ **QzDungeon** 是一款为生存 RPG 服打造的**实例化副本插件**：每一队玩家进入副本时 独立复制一份模板世界，互不干扰。波次刷怪、Boss 战、体力、门票、次数限制、组队、 排队全部内置，并且**从副本配置到 GUI 修改全程可视化 / 热重载**，不需要重启服务器。 已在生存 RPG 服「握草世界」线上环境稳定运行。 ## ✨ 核心特性 ### ⚔️ 副本玩法 - **真·实例化世界**：按队伍复制模板世界，多队同时开本互不影响，用完自动销毁 - **波次刷怪系统**：自定义每一波的怪物、数量、刷怪点位、波次提示，通关条件灵活配置 - **6 种副本分类**：每日 / 主线 / 周常 / 无尽 / 活动 / 自定义，活动副本支持**定时上下架**（到点自动开放/关闭，无需重启） - **复活机制**：每个副本可独立设置无限复活 / 禁止复活 / 限 N 次复活 - **限时挑战**：独立倒计时，通关后停留 30 秒捡完掉落再传送 ### 🛡️ 进度与门槛 - **体力系统**：权限组差异化上限（VIP/SVIP/MVP 各自不同）、离线恢复、进本扣体力，支持免体力白名单 - **挑战次数**：每日 / 每周独立次数与刷新时间（时区可配），防止爆肝刷穿 - **门票系统**：GUI 里手持物品一键设置门票，完整 NBT 存档，背包里的同款物品自动识别 ### 👥 多人体验 - **组队系统**：原版 Dialog 界面组队（1.21 新特性），队长邀请、整队进本，最高 8 人 - **智能排队**：全服实例数 / 副本内总人数双上限，超员自动排队并实时提示排名，绝不压垮服务器 ### 🖼️ 全 GUI 化（本插件最大卖点） - **13 个界面全部开放 YAML 自定义**：槽位、材质、名字、Lore、`item-model` / `custom-model-data` 材质包模型全覆盖，改错也有内置默认值兜底，不会打不开界面 - **游戏内副本编辑器**：`/qzd admin edit <副本>` 直接在 GUI 里编辑波次、刷怪点、怪物，配 `Shift+右键` 点位工具，做一张新副本不碰代码 - **语言文件单列**：全部玩家可见文本独立在 `lang/zh_CN.yml`（300+ 条目），改文案不动功能配置，复制一份改成本地化语言文件即切换语言 - **聊天输入服务**：需要输入的配置项在聊天栏引导输入，不用翻 YAML ### 🚀 性能 & 稳定性 - 世界**异步复制**、逐 tick 限速加载、副本独立视距/模拟距离、出生点区块预加载 - 空实例自动销毁、启动自动清理崩溃残留世界、单波刷怪数量硬上限防手滑刷爆 - 地图结构保护（防爆炸/燃烧/活塞/液体/耕地踩踏）、**CraftEngine / ItemsAdder / Nexo 自定义方块单独保护**、展示实体防拆 - `debug-damage` 模式：一键打印副本内每笔伤害明细，专治「技能伤害在副本里不生效」类问题 ## 📋 环境要求 | 项目 | 要求 | | ---- | ---- | | 服务端 | Paper / Folia 系 1.21+（实测 1.21.11） | | Java | 21+ | | 可选前置 | MythicMobs（自定义怪物）、Vault（体力权限组）、PlaceholderAPI（变量） | ## 🎮 指令 | 指令 | 说明 | | ---- | ---- | | `/qzd` | 打开副本大厅 | | `/qzd list [分类]` | 列出副本 | | `/qzd join <副本id>` | 直接进入副本 | | `/qzd leave` | 离开当前副本 | | `/qzd stamina` | 查看体力 | | `/qzd party` | 组队界面 | | `/qzd admin` | 管理面板（编辑器 / 重载 / 模板保存） | > 别名：`/dungeon`、`/fuben`、`/qzdungeon` ## 🔑 权限 | 权限 | 说明 | 默认 | | ---- | ---- | ---- | | `qzd.use` | 使用副本系统 | 所有玩家 | | `qzd.admin` | 管理权限 | OP | | `qzd.stamina.bypass` | 免体力（需配置开启） | 无 | | `qzd.stamina.max.<数字>` | 体力上限直接设为该数字 | — | | `qzd.stamina.group.<组名>` | 无 Vault 时按组识别上限 | — | ## 📥 下载 加入QQ群：1085042728 ## ❓ 常见问题 **Q：副本地图怎么做？** A：把做好的地图文件夹放进 `plugins/QzDungeon/templates/`，或在后台用 `/qzd admin template save <名字> <世界>` 自动复制；也可以直接生成虚空世界用编辑器搭擂台。 **Q：不用 MythicMobs 行吗？** A：行。原版怪物即可配置波次，装了 MythicMobs 可召唤 MM 怪物。 **Q：会卡服吗？** A：世界异步复制 + 逐 tick 加载限速 + 排队双上限 + 闲置实例自动销毁，视距/模拟距离均可按副本单独下调。 **Q：遇到 BUG 怎么反馈？** A：帖子下回复，附上控制台报错。【反馈群号】 ## 📝 更新日志 **v1.0.0** - 首次发布 [/MD]