原创 娱乐 [原创副本] MKDungeon 1.4.2｜星渊·蛛巢·炼狱｜单人/多人｜GUI奖励｜动态复活｜自动生成地图 2.2.0

【副本地图生成性能优化】

1. 地图结构计算改为异步规划，不再把大量几何计算集中在服务器主线程。
2. 方块放置改为逐tick分批执行，避免一次性写入数万至数十万个方块导致TPS突然骤降。
3. 副本区块不再进入副本前一次性全部加载，改为跟随方块生成过程逐步加载并添加区块票。
4. 玩家会看到“副本地图生成中”标题和实时生成百分比。
5. 地图完全生成后，玩家才会自动传送进入副本并开始怪物、任务和波次逻辑。
6. config.yml新增map-build.blocks-per-tick，默认1200。
7. blocks-per-tick数值越低，TPS越平稳，但玩家等待生成的时间越长；建议范围600至2000。
8. 插件关闭或副本生成失败时会取消生成任务、清空队列并释放已加载区块。

【退出副本方式调整】

1. 完全停止向玩家快捷栏发放“退出副本”屏障。
2. 插件不再占用快捷栏第9格，也不再保存、替换或恢复该栏位物品。
3. 修复退出副本后原快捷栏物品可能消失或卡住的问题。
4. 玩家进入副本时，标题和聊天都会提示退出方式。
5. 新增独立命令/leave，仅限正在副本中的玩家使用。
6. 在副本外使用/leave只会提示该命令仅限副本内使用，不会执行其他操作。
7. /mkfb leave不再作为玩家退出方式。
8. 升级后，插件仍会自动清理旧版本遗留的退出屏障，但不会重新生成。

安装方法：关闭服务器，删除旧版插件JAR，只保留MKdungeon-v32.jar后正常启动。不要使用插件管理器热替换。

MKDungeon 2.1.0 大型更新公告

本次版本由论坛旧版 1.4.2 更新至 2.1.0，包含副本内容、GUI组队、奖励管理、炼狱Boss、复活系统、实体安全和大量问题修复。建议所有使用旧版的服务器升级。

一、全GUI副本组队系统

玩家只需要输入 /mkfb，其他组队操作全部在GUI中完成。

新增功能：

• 创建副本队伍。
• 从在线玩家列表邀请好友。
• 玩家通过GUI接受或拒绝邀请。
• 显示队长、队员、在线状态和准备状态。
• 队员可以准备或取消准备。
• 队长可以将队长转让给其他在线成员。
• 队长可以在GUI选择需要挑战的副本。
• 队伍总人数默认达到3人后才能开始。
• 所有成员在线并准备后，由队长点击“开始副本”直接进入。
• 队长可以解散队伍，普通成员可以主动离队。
• 队员掉线后默认保留300秒队伍资格。
• 邀请默认60秒后自动过期。
• 更换副本后会清除准备状态，所有成员需要重新确认。
• 副本开始后保留队伍资料，完成副本后仍可继续使用原队伍。

可配置内容：

• party.minimum-players：队伍最低人数，默认3人。
• party.invite-timeout-seconds：邀请有效时间，默认60秒。
• party.offline-retention-seconds：掉线后队伍资格保留时间，默认300秒。

二、副本GUI重新设计

输入 /mkfb 即可打开副本地图选择界面。

目前副本按照难度排列：

• 星渊副本：普通难度。
• 蛛巢副本：中等难度。
• 炼狱副本：困难难度。

GUI会显示：

• 副本难度和玩法说明。
• 单人和多人奖励。
• 怪物掉落物。
• 掉落概率。
• 炼狱Boss专属掉落。
• 免费复活次数。
• 是否保护装备耐久。
• 队伍人数和准备情况。

多人副本不再依赖玩家输入复杂的组队指令。

三、炼狱最终Boss重制

炼狱第10波新增独立Boss：

炼狱君王·厄焰

Boss不再只是普通怪物群中的高血量怪物，而是一场完整的三阶段Boss战。

第一阶段：

• 近战压制。
• 高额攻击伤害。
• 较强击退能力。

第二阶段：

• Boss生命降低至70%后进入第二阶段。
• 召唤炼狱守卫。
• 周期释放火焰冲击。
• 靠近Boss的玩家会受到伤害、燃烧和击退。

第三阶段：

• Boss生命降低至35%后进入狂暴状态。
• 攻击、速度进一步提高。
• 周期锁定一名玩家发动高伤害斩杀。
• 被锁定玩家会提前收到屏幕警告。
• 在倒计时结束前离开标记区域即可躲避。

其他特性：

• 屏幕顶部显示Boss血条。
• 显示Boss当前阶段。
• Boss基础生命默认30000。
• Boss生命根据参战人数动态增加。
• 击败Boss并清理剩余守卫后才会判定通关。

Boss生命和技能伤害可以在 hard-dungeon.boss 配置区域调整。

四、炼狱Boss专属掉落

管理员可以通过以下路径设置：

/mkfb admin
炼狱多人奖励
炼狱Boss掉落设置

支持功能：

• 从管理员背包直接点击添加物品。
• 可以添加多个Boss掉落物。
• 左键点击物品，在聊天框输入掉落概率。
• 支持0至100之间的小数概率。
• 右键点击物品，设置最低和最高掉落数量。
• 数量范围可以填写1-3等格式。
• 只填写一个数字时使用固定数量。
• Shift点击可以删除对应掉落物。
• 每名参战玩家独立计算掉落。
• 掉落物直接进入玩家背包，不会掉到地面。
• 背包空间不足时会向玩家显示提示。
• Boss掉落、普通怪物掉落和最终通关奖励可以同时获得。
• 设置完成后会实时同步到 /mkfb 副本介绍界面。

五、管理员奖励面板升级

管理员输入 /mkfb admin 可以打开奖励管理面板。

奖励现已分为：

• 星渊单人通关奖励。
• 星渊多人通关奖励。
• 蛛巢单人通关奖励。
• 蛛巢多人通关奖励。
• 炼狱多人通关奖励。
• 蛛巢怪物掉落。
• 炼狱怪物掉落。
• 炼狱Boss专属掉落。

管理员可以直接点击自己背包中的物品添加奖励，不再需要反复关闭菜单并切换主手物品。

其他改进：

• 支持设置多个物品奖励。
• 面板显示当前已设置的奖励数量。
• 点击已设置物品可以单独删除。
• 支持自定义怪物掉落概率。
• 掉落设置实时保存至 admin-rewards.yml。
• 重启服务器后设置不会丢失。
• GUI中显示物品中文名称、数量和概率。
• config中的命令奖励与管理员面板物品奖励可以同时使用。

六、怪物掉落系统

蛛巢和炼狱支持自定义怪物掉落。

掉落规则：

• 每只对应副本怪物死亡时独立判断概率。
• 掉落物直接进入击杀玩家背包。
• 没有有效击杀者时，会选择附近仍在副本中的玩家。
• 不会生成地面掉落物。
• 避免掉落物被服务器扫地插件清除。
• 玩家获得掉落时会在屏幕中间显示物品名称和数量。
• 背包空间不足时会显示专门提示。
• 每种物品可以设置不同概率。
• 支持小数概率，例如12.5%。

七、复活系统

所有副本均支持复活系统。

默认规则：

• 每名玩家每次进入副本拥有3次免费复活。
• 免费次数使用完毕后，可以选择付费复活。
• 付费复活没有次数上限。
• 玩家死亡后会打开复活选择GUI。
• 屏幕显示剩余选择时间。
• 默认倒计时为30秒。
• 超时未支付时自动视为放弃。
• 放弃后玩家会被淘汰并送出副本。

付费价格支持动态上涨：

• 可以设置首次复活价格。
• 可以设置最高价格。
• 可以设置每次上涨倍率。
• 达到最高价格后继续按照最高价格复活。
• 经济扣款通过Vault兼容的经济插件完成。

主要配置：

• revive.free-revives
• revive.decision-seconds
• revive.paid-start-price
• revive.paid-max-price
• revive.paid-price-multiplier

八、蛛巢副本升级

蛛巢单人模式：

• 使用自然矿洞结构。
• 地图由上向下延伸。
• 包含大量分岔口和矿道。
• 洞穴内加入火把等照明。
• 玩家需要深入矿洞寻找荧丝结晶。
• 取得结晶后需要原路返回。
• 返回入口后向矿工阿洛提交才能通关。
• 蜘蛛会持续出现，不能只靠奔跑直接完成任务。
• 进入副本时会显示任务内容。
• 单人和多人奖励分开设置。

蛛巢多人模式：

• 最低3人进入。
• 使用同一套自然矿洞地图。
• 采用10波怪物挑战。
• 怪物生成在玩家附近的安全位置。
• 屏幕显示当前波次、难度和怪物数量。
• 难度高于星渊，但低于炼狱。
• 支持自定义怪物掉落。
• 副本内所有物品和穿戴装备不消耗耐久。

九、星渊与炼狱调整

星渊：

• 支持单人和多人挑战。
• 单人、多人物品奖励分开设置。
• 怪物会正常掉落经验。
• 永久黑夜。
• 可以正常食用食物和药水。
• 支持弓箭攻击。

炼狱：

• 仅支持多人挑战。
• 默认最低3人。
• 最多20人。
• 共10波怪物。
• 后期怪物拥有极高生命和伤害。
• 第10波为炼狱君王Boss战。
• 普通怪物和Boss均支持独立掉落。
• 副本内所有物品和穿戴装备不消耗耐久。
• 永久黑夜。
• 可以正常食用食物和药水。
• 支持弓箭攻击。

十、副本通用保护

所有副本世界均启用以下保护：

• 玩家不能破坏地图方块。
• 玩家不能放置方块。
• 爆炸不会破坏地图。
• 流体、活塞、燃烧等行为不会修改地图。
• 玩家之间不能互相伤害。
• 玩家可以正常攻击副本怪物。
• 禁止使用Essentials或PayToFly提供的飞行。
• 自动关闭玩家飞行状态。
• 副本内不会降低饥饿度。
• 可以正常使用食物、药水和弓箭。
• 玩家宠物和普通非玩家实体不会跟随进入副本。
• 玩家进入副本时会自动离开坐骑。
• 副本怪物不会攻击其他副本怪物或任务NPC。

十一、退出副本功能

进入副本后，玩家快捷栏最后一格会获得“退出副本”屏障。

保护机制：

• 屏障不能移动。
• 不能丢弃。
• 不能交换至副手。
• 不能通过死亡带出。
• 不能被扫地插件清理后永久消失。
• 离开副本后自动删除屏障。
• 自动恢复该快捷栏原来的物品。
• 点击屏障会优先退出副本，不会误判为退出队伍。

十二、实体生命周期重大修复

旧版曾出现副本NPC、怪物或宠物插件实体被带到主世界的问题，部分服务器因此生成了大量MULE实体。

新版已经修复：

• 不再把副本中的未知实体传送到主世界。
• 宠物插件使用的隐藏载体不会被副本错误搬运。
• 副本结束只执行一次，避免重复清理。
• 删除实体前检查实体是否仍然有效。
• 插件关闭时先停止任务，再清理副本。
• 插件关闭期间不会继续创建新的Bukkit任务。
• 副本结束后清理任务NPC、怪物、Boss血条和虚拟血量。
• 星渊、蛛巢和炼狱共用安全的实体清理流程。
• 副本运行期间固定必要区块，防止区块卸载造成怪物误判或重复补刷。
• 阻止普通非玩家实体通过传送进入副本世界。

十三、扫地插件兼容

针对服务器扫地插件清理副本怪物的问题进行了专门处理：

• 副本怪物带有内部登记。
• 插件会检查波次中的怪物状态。
• 区块保持加载，避免把区块卸载误判为怪物被删除。
• 异常消失的怪物会进行安全补刷。
• 不允许玩家通过躲避等待扫地插件清空怪物来跳过战斗。
• 副本掉落直接进入背包，不依赖地面实体。

十四、经验与耐久修复

经验：

• 星渊怪物正常掉落经验。
• 蛛巢怪物正常掉落经验。
• 炼狱怪物正常掉落经验。
• Boss拥有单独经验奖励。
• 每波怪物经验可以在配置中调整。

耐久：

• 蛛巢副本内武器、工具和穿戴装备均不损失耐久。
• 炼狱副本内武器、工具和穿戴装备均不损失耐久。
• 修复部分情况下武器不掉耐久但护甲仍然损失耐久的问题。

十五、命令和权限

玩家命令：

• /mkfb：打开副本和组队GUI。
• /mkfb help：查看帮助。

管理员命令：

• /mkfb admin：打开管理员奖励面板。
• /mkfb reload：重载插件配置。

权限：

• nidungeon.use：允许使用副本系统，默认所有玩家拥有。
• nidungeon.admin：允许使用管理员面板和重载配置，默认仅OP拥有。

旧版部分指令仍保留兼容，但普通玩家只需要使用 /mkfb GUI。

十六、配置与数据文件

主要文件：

• config.yml：副本规则、人数、复活、命令奖励和怪物属性。
• admin-rewards.yml：管理员面板设置的物品奖励、掉落物和概率。

管理员面板物品奖励与config命令奖励相互独立，通关时可以同时发放。

升级旧版后，新增默认配置会自动补充。旧版管理员奖励数据建议升级前备份。

十七、升级方法

从1.4.2升级前，请先关闭服务器并备份：

• plugins/MKDungeon
• mk_dungeon_world
• 服务器主世界
• 旧版插件JAR

升级步骤：

1. 完全关闭服务器。
2. 删除旧版MKDungeon插件JAR。
3. 将新版MKdungeon-v31.jar放入plugins目录。
4. 保留原有config.yml和admin-rewards.yml。
5. 启动服务器，让插件自动补充新增配置。
6. 检查控制台是否显示MKDungeon 2.1.0成功加载。
7. 使用 /mkfb 检查副本和组队GUI。
8. 使用 /mkfb admin 检查旧奖励是否正常读取。

不要使用插件管理器进行热卸载、热加载或热替换，否则可能造成副本任务、世界区块和实体状态残留。

十八、当前版本信息

插件名称：MKDungeon
插件文件：MKdungeon-v31.jar
内部版本：2.1.0
适用核心：Paper及其兼容分支
适用游戏版本：Minecraft 1.21及以上
主要命令：/mkfb