Seal Plugins

外观

SealAttributes 1.0.12 候选已知边界 ​

  • 运行时要求 Java 21；不支持 Folia，也没有设置 folia-supported: true。
  • 正式平台范围为 Paper 1.21～1.21.11、Purpur 1.21～1.21.11、Leaf 1.21.4～1.21.11。P10 实测的是各平台 floor、1.21.4 和 2026-08-05 选定的 1.21.11 构建；范围内其他中间构建没有逐个实测。
  • Leaf 1.21.4 是本项目完整功能与性能基线，但 Leaf 官方已把该 Minecraft 分支标为停止维护；生产服 是否继续使用由服主决定。
  • 只接管实体之间的战斗伤害；摔落、溺水、虚空、饥饿等环境伤害继续使用服务端原版规则。
  • 默认是纯 RPG 权威战斗，不自动混算其他战斗插件、原版附魔或药水伤害。需要共存时必须由第三方通过 公开 Combat Gate/Plan/Extension 契约显式接入。
  • 暴击与闪避默认保持逐次独立随机；可选 PRD 只减少连续失败，不是保底次数或持久化抽卡系统。PRD 概率 分辨率为 0.01 个百分点，低于 0.1% 的正概率退回精确独立随机；状态受 maximum-tracked-subjects 约束，容量满时新主体安全退回独立随机，并在重载、会话释放或重启时清空。
  • 物品来源一次只启用 STRUCTURED 或 LORE 一种读取模式；第三方 API 注入始终独立。Lore 是不可信 兼容输入，不适合作为高价值物品的唯一身份或真实性依据。Lore 全局 number/percent 各最多 8 种格式， 加上可选简称和旧版高级规则后展开总数最多 128 种，仍按纯文本精确匹配而不是开放正则或脚本。自动 显示名规则只覆盖 22 项内置属性；扩展属性需要用完整 ID 在 sources.yml 中显式配置旧 Lore 模板。
  • STRUCTURED 的 MythicMobs 扁平 PDC 简写只接受 22 个内置属性的 DOUBLE 值；第三方自定义属性仍由物品插件 写入规范 JSON。扁平 PDC 与规范 JSON 不能在同一物品混用。
  • SQLite 和 MySQL 都可保存健康检查点、当前资源与永久来源，但 1.0.12 不提供跨服在线会话权威、消息总线或 Velocity 数据同步；多个服不得把同一在线玩家同时当作写入权威。
  • 当前资源只为在线 READY 玩家恢复，不计算离线恢复；异常崩服最多回退一个资源检查点周期。上限增加不会 赠送当前值，上限降低会夹取；死亡只冻结消费/恢复循环，普通重生保留剩余值。V1 不提供资源预留事务、自动 退款、转账、管理员 set 命令或强制 ActionBar/BossBar。
  • PlaceholderAPI、DecentHolograms 与 MythicMobs 是软依赖；缺失时对应能力关闭，不影响主插件启用。 MythicMobs 联动以 5.12.1 公共 API 编译，只承诺 5.x API 线；它在怪物生成时导入最大生命，不追踪已经 生成怪物后续发生的 MythicMobs 配置热重载。生命联动已在 Leaf 1.21.4 + MythicMobs 5.13.0 独立副本实测；本次 P10 全平台矩阵未安装 MythicMobs，部署方仍需按实际 MythicMobs 构建验收。
  • 默认生命采用 Bukkit/Paper 原生最大生命属性。几十万或百万生命需要服主同时放宽服务端自身的属性 上限；SealAttributes 不另设一个虚假的业务生命上限。
  • P9 性能结论只覆盖报告中的 M4/16 GB、100 玩家、400 受管怪物和固定请求量，不代表任意规模。
  • /sa doctor 的聚合 p95/p99 是固定桶累计上界，不是完整 tracing；配置重载会创建新 RuntimeState，聚合 指标随之重新计数。来源被拒 provider 明细最多保留 64 个标签，其余只累计 overflow，避免无界标签内存。
  • 自动化客户端使用离线模式验证协议和生命周期；生产在线模式、代理转发、UUID 转发与权限体系必须按 实际网络拓扑另行验收。
  • /sa combat trace 只保存每个参与者最近一次战斗的有界内存记录，不是审计日志，不写入数据库，重启后 清空。它显示结算时的关键属性快照与最终结果，不承诺还原第三方扩展内部没有公开的中间计算过程。
  • plugins/SealAttributes/extensions/ 只加载可信启动扩展，不是安全沙箱。扩展最多 64 个，不支持热加载、 热卸载或扩展之间互相依赖；停用、替换或升级扩展必须先正常停止服务器。扩展入口只用于注册定义、公式和 属性行为，不提供 Bukkit 插件生命周期或运行期玩家来源发布入口。