原创 工具 GTDamage - 重新定义你的伤害显示 | 属性插件兼容 | 显示样式 | 怪物血条 | 新增隐藏伤害粒子 | 让你的服务器伤害显示更加多样化 [1.12-1.21+] 2.0.112

[MD] --- ### 🧰 核心 API：GTDamageAPI 入口类：`gt.plugin.gtdamage.api.GTDamageAPI`（Kotlin object / Java 静态类） #### 🎯 全息字显示 | 方法 | 用途 | 📋 说明 | | --- | --- | --- | | `showDamageHologram(entity, damage, type)` | 单行伤害 | 自动按 `type == "critical"` 判断暴击 | | `showDamageHologram(entity, damage, type, isCritical)` | 单行伤害（自定义暴击） | 暴击标记完全可控 | | `showMultipleDamageHolograms(entity, list)` | 多行伤害（Kotlin） | `List<Pair<Double, String>>` | | `showMultipleDamageHolograms(entity, vararg)` | 多行伤害（Java） | 变长参数 | | `showHealHologram(entity, amount)` | 治疗数字 | 等同于 `showDamageHologram(.., "heal", false)` | **Kotlin 调用示例：** ```kotlin import gt.plugin.gtdamage.api.GTDamageAPI // 单行 GTDamageAPI.showDamageHologram(victim, 128.0, "critical") // 多行（技能连击场景） GTDamageAPI.showMultipleDamageHolograms(victim, listOf( 100.0 to "critical", 50.0 to "fire", 30.0 to "lightning" )) // 治疗 GTDamageAPI.showHealHologram(player, 45.0) ``` **Java 调用示例：** ```java import gt.plugin.gtdamage.api.GTDamageAPI; import org.bukkit.entity.LivingEntity; GTDamageAPI.showDamageHologram((LivingEntity) victim, 128.0, "critical"); // 多行 GTDamageAPI.showMultipleDamageHolograms( (LivingEntity) victim, new Object[]{100.0, "critical"}, new Object[]{50.0, "fire"} ); ``` **Groovy 脚本示例（Denizen / sx-loc 等）：** ```groovy // 单行 GTDamageAPI.showDamageHologram(victim, 256.0, "skill") // 多行（带变量） def damages = [ [200.0, "critical"], [80.0, "fire"], [30.0, "ice"] ] GTDamageAPI.showMultipleDamageHolograms(victim, damages) ``` --- #### ⚙️ 配置获取 | 方法 | 返回 | 📋 说明 | | --- | --- | --- | | `getTypeWeight(type)` | `Int` | 读取 `crane-attribute.type-weights.xxx`，默认 1 | | `getTypeConfig(type)` | `DamageTypeConfig?` | 颜色 / 前缀 / 后缀 / 倍率 | | `getDisplayTypeByAttribute(attrName)` | `String` | 属性名 → 显示类型，未找到返回 `"physical"` | ```kotlin val cfg = GTDamageAPI.getTypeConfig("critical") if (cfg != null) { println("暴击颜色: ${cfg.color}") println("暴击前缀: ${cfg.prefix}") println("暴击倍率: ${cfg.scale}") } ``` --- #### 🔌 CraneAttribute 集成 | 方法 | 返回 | 📋 说明 | | --- | --- | --- | | `isCraneAttributeAvailable()` | `Boolean` | CA 是否已安装并启用 | | `getCraneAttributeAdapter()` | `Any?` | 适配器名（"CraneAttribute" / null） | --- #### 👁️ 玩家可见性控制 | 方法 | 用途 | | --- | --- | | `hideDamageForPlayer(player)` | 隐藏该玩家**自己受到的**伤害 | | `showDamageForPlayer(player)` | 恢复显示 | | `isDamageHiddenForPlayer(player)` | 查询是否隐藏 | | `hideOtherDamageForObserver(player)` | 隐藏该玩家**看到的他人**伤害 | | `showOtherDamageForObserver(player)` | 恢复显示 | > 💡 **提示：** 这俩方法会立即生效，且**不写入配置**。重启失效——需要持久化请自己处理（重连时再调一次即可）。 --- [/MD]

[MD] --- ### ❓ Q1：开了 ArcartX 之后数字不显示？ 检查三点： ✅ 配置文件 `display.arcartx: true` ✅ 服务器已装 ArcartX 插件 ✅ 玩家已装 ArcartX 客户端 > 🐛 开 `debug` 看控制台 provider 选择日志。 --- ### ❓ Q2：PaiUI 飘字出不来？ PaiUI 必须在 `DamageDisplay.yml` 中启用飘字功能，GTDamage 才能通过反射调用。否则会**静默回退**到原生发包。 --- ### ❓ Q3：全息字和原版数字会重复？ GTDamage 通过 `EntityDamageByEntityEvent` 的 **MONITOR** 优先级触发。 关闭其他伤害显示插件的同类功能即可。 --- [/MD]