- 版权类型
- 原创
- 插件中文名称
- AimDamage
- 插件英文名称
- AimDamage
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- Purpur
- 语言支持
- 中文（简体）
- 前置组件
- bedwars1058+https://www.spigotmc.org/resources/bedwars1058-opensource.97320/
- 适配版本（Java）
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
- 1.11
- 1.10
- 1.9
- 1.8
# 
AimDamage
**基于 BedWars1058 的起床战争瞄准伤害插件 | RayTrace 射线检测 + 攻击冷却机制**
---
前言
本插件为 KKCraft 自用的起床战争特殊玩法插件，现 KKCraft 已永久关闭。
发布此插件，希望能帮助一些有需要的人，为社区做贡献。后续将发布更多 KKCraft 相关的插件以及源码。
本人将不再开服，非插件问题请勿联系。
⚙ 工作流程
左键触发 — 玩家手持剑类武器左键点击（空气或方块）时触发瞄准攻击
射线检测 — 从玩家眼部发射射线，步进 0.5 格，最远 150 格，遇实心方块自动中断（防穿墙）
目标校验 — 命中实体后校验：必须为玩家、非队友、非观众，自动排除 NPC（村民/烈焰人）
伤害计算 — 根据手持剑的材质计算伤害值，非武器物品不造成伤害
击退效果 — 基于攻击者到目标的水平方向施加击退（0.45 水平 + 0.36 垂直）
攻击冷却 — 攻击后进入 14 tick（0.7 秒）冷却，防止连续攻击
⚔ 武器伤害表
🛡 安全机制
防穿墙攻击 — 射线遇到实心方块立即中断，无法隔墙打人
队友保护 — 自动识别 BedWars1058 队伍信息，不会误伤队友
观众免疫 — 旁观者模式和观众不会被攻击，也无法发起攻击
NPC 排除 — 自动跳过村民、烈焰人等游戏内 NPC 实体
内存安全 — 玩家退出 / 死亡 / 重生 / 游戏结束时自动清理冷却数据，防止内存泄漏
热重载支持 — 插件禁用时取消所有 Scheduler 任务并清空静态集合
性能优化
向量复用 — 射线步进复用向量对象，避免重复 clone 产生 GC 压力
O(1) 冷却查询 — 冷却集合使用 HashSet，查询性能为常数级
前置条件快速返回 — 事件监听优先判断前置条件并返回，减少不必要的计算开销
精准冷却清理 — 游戏结束时仅清理对应竞技场内玩家的冷却，不影响其他竞技场
技术参数
依赖
安装方式
🛡 安全检测
插件无后门无病毒，VirusTotal 安全审核结果：
交流反馈
插件交流群：908213883
有问题群内反馈，将会很快得到回复解决问题。
AimDamage **基于 BedWars1058 的起床战争瞄准伤害插件 | RayTrace 射线检测 + 攻击冷却机制**
---
前言本插件为 KKCraft 自用的起床战争特殊玩法插件，现 KKCraft 已永久关闭。
发布此插件，希望能帮助一些有需要的人，为社区做贡献。后续将发布更多 KKCraft 相关的插件以及源码。
本人将不再开服，非插件问题请勿联系。
⚙ 工作流程
左键触发 — 玩家手持剑类武器左键点击（空气或方块）时触发瞄准攻击
射线检测 — 从玩家眼部发射射线，步进 0.5 格，最远 150 格，遇实心方块自动中断（防穿墙）
目标校验 — 命中实体后校验：必须为玩家、非队友、非观众，自动排除 NPC（村民/烈焰人）
伤害计算 — 根据手持剑的材质计算伤害值，非武器物品不造成伤害
击退效果 — 基于攻击者到目标的水平方向施加击退（0.45 水平 + 0.36 垂直）
攻击冷却 — 攻击后进入 14 tick（0.7 秒）冷却，防止连续攻击
⚔ 武器伤害表
| 武器 | 伤害值 |
| 🗡 木剑 | 5 |
| 🗡 石剑 | 6 |
| 🗡 铁剑 | 7 |
| 🗡 钻石剑 | 8 |
| 其他物品 | 0（不触发） |
🛡 安全机制
防穿墙攻击 — 射线遇到实心方块立即中断，无法隔墙打人
队友保护 — 自动识别 BedWars1058 队伍信息，不会误伤队友
观众免疫 — 旁观者模式和观众不会被攻击，也无法发起攻击
NPC 排除 — 自动跳过村民、烈焰人等游戏内 NPC 实体
内存安全 — 玩家退出 / 死亡 / 重生 / 游戏结束时自动清理冷却数据，防止内存泄漏
热重载支持 — 插件禁用时取消所有 Scheduler 任务并清空静态集合
性能优化向量复用 — 射线步进复用向量对象，避免重复 clone 产生 GC 压力
O(1) 冷却查询 — 冷却集合使用 HashSet，查询性能为常数级
前置条件快速返回 — 事件监听优先判断前置条件并返回，减少不必要的计算开销
精准冷却清理 — 游戏结束时仅清理对应竞技场内玩家的冷却，不影响其他竞技场
技术参数
代码：
射线最大距离：150 格（步进 0.5 × 300 次迭代）
实体碰撞箱检测范围：0.8 × 0.8 × 0.8
攻击冷却时间：14 tick（约 0.7 秒）
击退参数：水平 0.45 / 垂直 0.36
支持的点击类型：LEFT_CLICK_AIR / LEFT_CLICK_BLOCK- BedWars1058（必须，提供竞技场、队伍 API）
- Spigot 1.8.8+（基于 1.8.8 开发，向上兼容）
安装方式- 确保服务器已安装 BedWars1058 插件
- 将 AimDamage.jar 放入服务器 plugins 目录
- 重启服务器即可，无需额外配置
🛡 安全检测
插件无后门无病毒，VirusTotal 安全审核结果：
交流反馈插件交流群：908213883
有问题群内反馈，将会很快得到回复解决问题。
