个人技术开发随记
测试入口

已在白名单的玩家使用自己的邀请码;未加入白名单的玩家使用进服拒绝提示中的临时邀请码。

Custom Potion Effects

XiceMorePotionEffects 更多药水效果插件

XiceMorePotionEffects 用于承载服务器自定义状态效果。当前版本重点实现“跃迁抑制”,让传送类能力可以被短时间冷却约束。

功能概述

插件提供三类自定义状态效果:warp_suppression 跃迁抑制会阻止玩家再次传送;strong_ban 强效封禁会让牛奶无法清除自定义负面效果;swordsman_memory 剑士的记忆会限制远程攻击并提高近战伤害,用于 RPG 副本祝福。

自定义效果不是原版药水效果,插件会自行记录到期时间。在线玩家身上存在自定义效果时,插件会通过 XiceHUD 显示侧边栏,按配置格式展示效果名称和剩余秒数;效果结束、玩家离线或插件关闭时会清理侧边栏内容。

插件还实现了自定义附魔:凋亡之刃、苦痛之刃、自生、饱腹活力、延伸之手和沉稳。它们通过物品持久化标记和 lore 展示,不注册为原版附魔;同一件物品当前只允许携带一种插件自定义附魔,避免效果叠加失控。

插件提供 /morepotioneffects 主命令,别名为 /mpe/xicemorepotioneffects。管理员可使用 giveclearcheckenchantreload 管理自定义效果与附魔,时长参数支持纯秒数以及 smh 后缀。

部署方式

插件基于 Paper API 运行,当前项目按 Paper 1.21.11 和 Java 21 构建。它依赖 XiceHUD 提供侧边栏显示服务。构建产物安装为 /opt/xicemc/runtime/plugins/XiceMorePotionEffects.jar

运行时配置文件位于 /opt/xicemc/runtime/plugins/XiceMorePotionEffects/config.yml。配置中包含 access 权限分配、侧边栏标题与行格式,以及命令提示文案。当前 giveenchant 动作可通过配置授权给指定玩家,完整管理权限仍由 xicemorepotioneffects.admin 控制。

XiceClaim 和 XiceRPG 会以软依赖方式检测该插件。两者同时安装时,领地图腾传送、魔塔祝福和副本状态可以调用 XiceMorePotionEffects;缺少该插件时,对应额外效果会跳过,不影响主体插件加载。