XiceRPG 副本插件

返回插件列表

XiceRPG 用于管理 RPG 模板世界、魔塔临时副本、自定义怪物和魔法装备交互，是服务器副本玩法的基础层。

功能概述

插件通过 /module 管理模板世界。模板世界使用虚空生成器，不生成地形、结构或自然生物，适合手动搭建副本场景；创建 UI 可配置边界距离、重生点、副本展示名和“挣脱诅咒”死亡次数。

玩家手持魔塔密钥右键可以打开魔塔副本页面。选择模板后，插件会复制模板世界，生成玩家专属临时副本实例，经过准备、复制、加载和区块预热后倒计时传送。玩家离开、下线、强制退出或在副本内使用密钥返回时，临时世界会卸载并删除。

副本启动仪用于在模板世界中配置试炼：可设置启动位置、怪物波次、波次休整、通关奖励和准入条件。临时副本内启动后，插件按波次刷新怪物，通过 XiceHUD 托管的 BossBar 展示当前进度，并在通关后发放奖励和记录完成状态。

插件当前接入朽败的卫兵、脓包虫和测试木桩等自定义怪物。自定义怪物使用原版实体承载逻辑，外观由展示实体和资源包模型渲染，并带有悬浮血条、特殊死亡/掉落/经验处理和副本内伤害结算规则。

魔法粉末、魔法砧和魔法砂轮构成当前的魔法装备交互：魔法砧用于给装备写入插件自定义附魔，魔法砂轮用于移除自定义附魔并回收材料。获得魔法粉末后还会解锁附魔金苹果配方，使用 8 个金苹果围绕 1 个魔法粉末，产出 8 个附魔金苹果。实际附魔效果由 XiceMorePotionEffects 承载。

部署方式

插件基于 Paper API 运行，当前项目按 Paper 1.21.11 和 Java 21 构建。它依赖 XiceCustomItem 注册魔法粉末、魔法砧、魔法砂轮、魔塔密钥和副本启动仪，依赖 XiceHUD 托管副本波次 BossBar；安装 XiceMorePotionEffects 时会启用魔塔祝福和附魔效果联动。

构建产物安装为 /opt/xicemc/runtime/plugins/XiceRPG.jar。运行时配置文件位于 /opt/xicemc/runtime/plugins/XiceRPG/config.yml，模板数据、魔法砧/砂轮位置和附魔列表分别保存到插件运行时目录下的 modules.yml、magic-anvils.yml、magic-grindstones.yml 和 magic-anvil-enchants.yml。

运行时世界目录使用 xicerpg_module_、xicerpg_snapshot_ 和 xicerpg_instance_ 前缀区分模板、快照和临时实例。插件只删除已登记且匹配前缀的世界目录，避免误删普通世界。