Damage Indicator Plugin - 伤害显示插件

Spectral Damage 是一款 Minecraft Spigot 插件，它允许你以动态全息图的形式，展示玩家对生物或其他玩家造成的伤害。该插件高度优化，使用异步任务且仅依赖数据包，无需任何外部依赖。

💡核心特性

• 客户端异步伤害显示全息图。
• 支持检测并显示多种伤害类型，包括：
• 普通攻击
• 暴击
• 火焰伤害
• 摔落伤害
• 药水伤害
• 弓箭伤害
• 生命恢复
• 生命增益
• 中毒伤害
• 可配置每种伤害的显示文本。
• 可选择让伤害指示器对其他玩家可见。
• 全息图拥有可配置的下落动画。
• 支持 RGB 和渐变色代码。
• 提供 API 供开发者使用。

🎮命令与权限

• /spectraldamage reload
• 重新加载插件配置文件。
• 所需权限：spectraldamage.reload
• /spectraldamage toggle
• 为执行命令的玩家开启或关闭伤害显示。
• 所需权限：spectraldamage.toggle
• /spectraldamage enable <player>
• 为指定玩家启用伤害显示。
• 所需权限：spectraldamage.admin
• /spectraldamage disable <player>
• 为指定玩家禁用伤害显示。
• 所需权限：spectraldamage.admin

🔧配置详解 (版本 2.7.1)

配置文件为 YAML 格式，以下为关键配置项说明。

基础设置

• update_checker: true
• 启动时检查更新并通知管理员。
• showToDamagerOnly: true
• 若为 true，全息图仅对造成伤害的玩家可见。若为 false，则对所有人可见。关闭此选项也会使自然伤害（中毒、火焰、摔落）对其他人可见。
• enable_by_default: true
• 默认对所有玩家启用插件。
• restrict_by_permission: false
• 若为 true，则只有拥有 spectraldamage.show 权限的玩家才能看到伤害指示器。

全息图显示

• offset_x: 1.35
• 全息图在 X 轴上的最大随机偏移（不可为负）。
• offset_y: 0.8
• 全息图在 Y 轴上的最大随机偏移（可为负）。
• offset_z: 1.35
• 全息图在 Z 轴上的最大随机偏移（不可为负）。
• falling_animation: true
• 是否启用全息图下落动画。
• initial_speed: 1.15
• 全息图向上加速的初始速度。
• acceleration: 4.0
• 全息图被吸引向地面的加速度。
• damage_decimal: 1
• 伤害数值显示的小数位数。
• living_time: 23
• 全息图存留时间（单位：游戏刻，20刻=1秒）。此时间已根据默认速度和加速度优化，确保全息图落地后消失。

伤害格式

所有格式字符串中，%damage% 将被替换为实际伤害值。支持使用 &<HEX>、&<LEGACY> 颜色代码以及 <#FF6600>文本</#9DFF8A> 的渐变格式。

• damage_format: "&c- &4%damage% &cHP"
• 普通伤害显示格式。
• minimum_damage: 0
• 显示全息图所需的最小伤害值。设为 0 则禁用此限制。
• critical_damage: true 与 critical_damage_format
• 是否启用及暴击伤害的显示格式。
• fire_damage: false 与 fire_damage_format
• 是否启用及火焰伤害的显示格式。
• poison_damage: false 与 poison_damage_format
• 是否启用及中毒伤害的显示格式。
• potion_damage: false 与 potion_damage_format
• 是否启用及药水（仅瞬间伤害）伤害的显示格式。
• projectile_damage: false 与 projectile_damage_format
• 是否启用及投射物伤害的显示格式。
• fall_damage: false 与 fall_damage_format
• 是否启用及摔落伤害的显示格式。
• health_regen: false 与 health_regen_format
• 是否启用及生命恢复的显示格式。
• health_gain: false 与 health_gain_format
• 是否启用及生命增益的显示格式。

目标过滤

• player_damage_indicator: true
• 是否对玩家目标显示伤害指示器。
• entities_damage_indicator: true
• 是否对非玩家实体显示伤害指示器。

消息文本

所有消息均可通过配置自定义前缀及内容，例如

• message_prefix: "&c&lSpectralDamage &8-"
• message_config_reloaded: "Config file reloaded successfully!"

❓注意事项与支持

• 此插件为开源协作项目，由 TwiDev 维护。
• 项目持续改进中，会根据社区反馈发布更新或新功能。
• 如果你有任何建议或发现问题，请在讨论帖或 GitHub Issues 中提交。
• 如果你喜欢这个插件，请为其评分和评论。

项目地址与问题反馈：

• 源码与问题追踪：https://github.com/TwiDev/SpectralDamage