MythicMobs、PlaceholderAPI 与 DecentHolograms

三者都是 softdepend。缺失时对应功能关闭，除非全息配置显式设为 required。

MythicMobs 5.x

适配代码已经合并进主运行 JAR，不要再安装 adapters 子模块。编译 API 为 5.12.1，只承诺 5.x 公共 API 线；生产要用实际 MythicMobs 构建重新验收。

怪物最大生命

MythicMobs 怪物生成时，适配器把 Mythic Health 与实体基础 Profile 的差额发布为：

mythicmobs:mob_health

这样 Health: 100000 不会被默认实体 100 覆盖。它不追踪已经生成的怪物在 MythicMobs 配置热重载后的 Health 变化；需要重新生成或由业务插件重新发布。

Mythic 物品

在物品配置的 SealAttributes 区写扁平值：

RPGSword:
  Id: DIAMOND_SWORD
  Display: "<red>RPG 长剑</red>"
  SealAttributes:
    physical_attack: 25.0
    total-percent:
      max_health: 20.0

预期生成的新物品含规范扁平 PDC；已有有效 SealAttributes PDC 时适配器跳过，不覆盖。MythicMobs reload 只影响之后创建的物品。最多 64 项/16 KiB；TOTAL_PERCENT 只用于 AMOUNT。

sealdamage / seal_damage

Skills:
  - sealdamage{type=spell;base=30;scale=1.2;trueScale=0;crit=true;evade=false;defense=true;block=false;lifesteal=true;reflect=true} @target

参数有长/短名：base/b、scale/s、trueScale/ts，以及 crit、evade、defense、block、lifesteal、reflect capability 覆盖。

• physical 默认启用标准能力；
• spell 默认暴击、防御、吸血、反伤，不启用闪避/格挡；
• true 默认不启用这些能力。

不要在同一技能同时调用 Mythic 原生 damage 与 sealdamage，否则可能结算两次。该 mechanic 只允许同步执行。

sealheal / seal_heal

Skills:
  - sealheal{amount=80} @self

amount/a 必须大于 0，走 SealAttributes 主动治疗倍率与上限夹取。不要再叠加原生 heal。

PlaceholderAPI

identifier 为 sealattributes。可用参数：

%sealattributes_ready%
%sealattributes_snapshot_revision%
%sealattributes_runtime_revision%
%sealattributes_display_revision%
%sealattributes_current_health_raw%
%sealattributes_current_health_formatted%
%sealattributes_max_health_raw%
%sealattributes_max_health_formatted%
%sealattributes_effective_max_health_raw%
%sealattributes_effective_max_health_formatted%
%sealattributes_attribute_physical_attack_raw%
%sealattributes_attribute_physical_attack_formatted%
%sealattributes_attribute_physical_attack_name%
%sealattributes_resource_douluo:soul_power_current_raw%
%sealattributes_resource_douluo:soul_power_max_formatted%
%sealattributes_resource_douluo:soul_power_percent%
%sealattributes_resource_douluo:soul_power_name%

内置属性可省略命名空间；扩展属性/资源使用完整 ID。max_health 是 RPG 值，effective_max_health 是平台实际投影值。主体未 READY、定义不存在或资源不可用时会返回明确的不可用结果，不应用 0 猜值写业务逻辑。

DecentHolograms

hologram.enabled: true 且依赖可用时显示伤害。required: false 时缺失只记录降级；true 时启动或重载拒绝。viewers 可选 ATTACKER、TARGET、PARTICIPANTS、NEARBY，注意 NEARBY 可能向旁观者暴露战斗数值。

hologram.capacity.maximum-active、每 tick 创建数和 nearby.maximum-viewers 都是保护上限；被限流的显示不影响真实伤害。全息不是审计或反作弊数据源。

共存检查表

1. 明确唯一伤害权威，不让两个插件同时取消/重放同一事件；
2. Mythic 技能选择 Seal mechanic 或原生 mechanic，不能都用；
3. 明确唯一装备来源，SealItems 接管时关闭内置读取器；
4. 用实际版本启动、生成新怪/新物品、战斗、重载、重登和停服；
5. 用 /sa combat trace、sources、item inspect 证明数据经过哪条链。