原创 开源 ✦ APLiveshen｜AttributePlus 玩家属性强化 · 强化石 · 可配置 GUI 1.1.1

✦ APLiveshen｜AttributePlus 玩家属性强化 · 强化石 · 可配置 GUI​

把成长留在玩家身上，让每一颗强化石都有价值。

消耗强化石，在 GUI 中提升个人属性等级；属性效果统一交由 AttributePlus 处理。

点击展开...

作者：yzmtcd　｜　当前版本：1.1.1　｜　推荐环境：Paper 1.21.4 / Java 21

---

◆ 插件介绍​

APLiveshen 是一款为 AttributePlus 配套制作的玩家属性强化插件。

玩家领取强化石后，执行 /apliveshen 打开强化界面，选择属性、查看收益与消耗，再确认强化。每项属性分别记录 等级、连续失败次数、保底进度与实际消耗，玩家成长数据跨世界共用。

服主可以自行设计属性名称、AP 映射、成长数值、成功率与成本，也能调整界面布局、语言、提示音和强化石外观，适合需要个人成长路线的 RPG、生存与冒险服务器。

◆ 制作 API、版本与依赖​

AttributePlus 是硬依赖。 本插件按 AttributePlus 3.3.3.3 的 org.serverct.ersha.api.AttributeAPI 接口适配；AP 通过运行时接入，不是随本插件打包的组件。属性计算和实际效果均由 AP 接管。

CraftEngine 是可选依赖。 不安装也能使用普通材质强化石和完整强化流程；需要 CE 外观时，请安装适配自己服务端版本的 CE 与对应资源包。本次没有对某个具体 CE 版本完成真实资源包联测。

Minecraft 版本兼容说明​

理论范围可概括为：1.21.4 及更高的 1.21.x Paper / Purpur，实际推荐仍为 1.21.4。

插件未使用绑定具体服务端版本的 NMS / CraftBukkit 实现，但“基于 1.21.4 API”不代表自动兼容整个 1.21 系列，也不能保证之后的版本一定兼容。上述高版本仅为待验证范围；实际可用范围还受 AttributePlus 和 CraftEngine 自身兼容性限制。

本文中的 MC 版本指 服务端版本。插件面向 Paper 及其兼容分支，不将 Spigot、Folia、模组混合端列为已支持环境。

✦ 核心功能​

• 个人属性成长：每项属性独立升级，默认上限 50 级，支持分别修改上限。
• 概率与保底：可按目标等级设置成功率、强化石数量、保底阈值，也可为单项属性覆盖规则。
• 失败不掉级：失败会消耗本次强化石，但不会降低等级；达到配置的连续失败次数后，下一次强化必定成功。
• 清晰的强化界面：展示当前等级、当前与下级 AP 加成、成功率、保底进度、所需与持有强化石，带确认页与分页。
• 界面与提示音：打开、翻页、确认、结果和消息提示均有可配置音效，可调整音量、音调或关闭。
• 全服通告：支持总开关、各属性独立开关和通告等级门槛。
• 管理指令：分别调整玩家的 插件内等级 和 本插件贡献的 AP 数值，支持设置、增加、减少。
• 物品身份校验：强化石由本插件发放与识别，单纯改名的普通物品不能冒充。
• 多语言与热加载：附中文、英文语言 YAML，支持自定义语言；配置检查不通过时保留原有配置快照。

保底示例： 如果配置为连续失败 5 次触发保底，前 5 次均失败后，第 6 次必成。成功后清空该属性的失败次数；保底阈值设为 0 可关闭保底。

点击展开...

◆ 默认八项属性​

默认基础值为 0，每项最高 50 级。以下数值均可修改，也可以增删属性、调整显示名称与 AP 映射。

表中是本插件额外贡献给 AP 的数值，不是玩家最终面板总值。 几率类遵循 AP 的百分数单位；移速数值 10 不应直接理解为 10% 或 10 倍速度，其效果取决于 AP 公式。暴击、吸血与冰冻的实际效果还受 AP 中配套倍率、强度和抗性影响，可结合自己服务器的装备体系调整。

◆ 配置自由度​

配置位于 plugins/APLiveshen/。可编辑 YAML 的字段说明集中放在文件顶部，提供中英双语写法与用途说明。

游戏内文字支持 传统 & 颜色码、&#RRGGBB 和 MiniMessage，可使用加粗、符号与多行排版。附带的语言配置已使用装饰符号点缀，服主可以继续按服务器风格调整。

CraftEngine 外观怎么接？​

在 items.yml 的 stone.ce-id 填入自己的 CE 物品 ID，例如 my_pack:upgrade_stone。

CE 提供模型、贴图与 Tooltip；APLiveshen 管理强化石身份、发放和消耗，并用语言 YAML 覆盖名称及 Lore。 没有 CE 时默认使用 PAPER，也可配置其他基础材质。

强化石应通过 APLiveshen 的 give 指令 发放。仅通过 CE 创建同外观物品、缺少本插件身份标记的物品，不能直接替代强化石。

◆ 常用指令​

主命令与权限前缀均为 apliveshen。 管理指令可以在控制台执行，控制台省略开头 /；涉及玩家的管理操作要求 目标在线。

等级与 AP 数值是两套管理入口：

• admin level 使用非负整数，结果必须在 0～属性上限 内；保留 AP 手动修正、保底与实际消耗记录，不扣石、不退款。
• admin attribute 支持非负小数，调整的是 本插件的 AP 贡献值；保留等级、保底与实际消耗，后续强化仍保留手动修正。
• 管理指令中使用表内的 配置 ID，不是翻译后的显示名称。通过指令免费增加的等级，不会产生可退款的消耗记录。

权限节点​

◆ 安装与使用​

1. 准备 Java 21 + Paper 1.21.4，安装 AttributePlus 3.3.3.3。
2. 将 APLiveshen-1.1.1.jar 放入服务器 plugins/，同一目录只保留一个版本的本插件 JAR。
3. 正常启动服务器，生成 plugins/APLiveshen/ 配置；按需修改，再执行 /apliveshen reload。
4. 后台执行 apliveshen give 玩家名 16，玩家执行 /apliveshen 即可开始强化。
5. 需要自定义外观时，再配置 CraftEngine + 资源包 + stone.ce-id。

默认 YAML 存储无需额外数据库服务。需要数据库时可选 SQLite 或 MySQL，JAR 内已包含相应 JDBC 驱动。插件提供带预览与确认的存储迁移指令；具体流程见附件使用说明，存储连接变更需要按说明迁移、重启。

旧版升级提醒​

升级前正常停服并备份插件目录及数据库。替换 JAR 不会覆盖已有属性配置，请对照完整包中的 config-examples/ 合并新八项属性和顶部字段说明。

保留原有玩家数据与待补发账本。历史 health、movement_speed、armor ID 继续使用；旧攻击属性记录不会自动变成暴击等级，也不应通过复用旧 ID 来改成另一种属性。

◆ 1.1.1 版本内容​

• 默认属性调整为 生命力、暴击几率、移速加成、护甲值、闪避几率、吸血几率、经验加成、冰冻几率，同步调整成长数值、配置与中英语言。
• 提供指定在线玩家、指定属性的 等级设置 / 增加 / 减少 指令，与已有 AP 数值管理指令分别使用。
• 将可编辑 YAML 的 双语字段说明集中至文件顶部，补充配置用法。
• 优化文字层级、重点加粗、符号装饰与交互提示，保留可配置界面和音效。
• 核对 AttributePlus 3.3.3.3 的默认八项属性映射，并补充验证与升级说明。

◆ 验证情况与附件​

本版自动化验证：76 项测试通过，0 失败、0 错误。 已在 Purpur 1.21.4 + AttributePlus 3.3.3.3 环境核验默认八项属性注册与 AP 来源数值、控制台管理指令及 GUI 相关交互。

原生 Paper 未另启实例联测；高于 1.21.4 的 MC 版本未逐版测试。CraftEngine 的真实资源包渲染和真实 MySQL 服务尚未完成联测，具体已测内容与边界见 TEST-REPORT.md。

本帖附件说明：

• APLiveshen-1.1.1.jar：安装用插件文件。
• APLiveshen-1.1.1-complete.zip：完整交付包，包含 JAR、Maven 源码与测试、默认配置样例、使用说明、快速开始、测试报告和第三方声明。

源码作者：yzmtcd。 AttributePlus 与 CraftEngine 为独立插件，需按需自行安装；相关名称仅用于说明依赖关系。