- 版权类型
- 原创
- 插件中文名称
- 自动攻击
- 插件英文名称
- KillingAura
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- Purpur
- 语言支持
- 中文（简体）
- 前置组件
- 可选依赖：LuckPerms
- 适配版本（Java）
- 最新版本
- 26.x
- 1.21
KillingAura | 高性能分片限流自动攻击插件
KillingAura 不是简单的“定时攻击”脚本，而是一套围绕性能预算、目标保护和权限时长管理重新组织的自动攻击方案。插件将攻击扫描、玩家会话、每日时长、数据库持久化和权限组同步拆分为独立模块，在保留 `/ka toggle` 简单使用方式的同时，尽量降低高在线人数和高实体密度场景下的额外开销。
核心技术亮点
1. 分片扫描与预算限流
攻击循环只处理到期玩家，并同时受到每 tick 玩家扫描数、单次候选实体数、每 tick 攻击目标数和微秒级软预算限制。超出当前 tick 预算的工作会自动顺延，避免一次性遍历全服玩家或无限检查实体。
2. 主线程安全，数据异步持久化
实体查找、视线检测和实际攻击严格遵循 Paper/Bukkit 主线程 API；玩家时长和开关状态的数据库读写、批量保存及失败重试则交由独立数据库线程处理，减少磁盘或网络 I/O 对游戏线程的影响。
3.完整的目标保护机制
内置视线与夹角检查、方块遮挡检查、传送冷却、实体生成保护，以及 NPC、宠物和可配置生物白名单过滤。默认关闭 PVP，默认忽略常见 NPC 与宠物元数据，降低误伤风险。
4. LuckPerms 权限组驱动
可以按 LuckPerms 权限组分别设置攻击范围和每日可用时长。玩家同时属于多个已配置组时，插件按 `priority` 选择最高优先级组；未安装 LuckPerms 时自动使用 `default` 组，不影响插件启动。
5. SQLite / MySQL 双存储
默认使用本地 SQLite，无需额外搭建数据库；群组服或多服共享数据时可切换 MySQL。玩家每日基础时长、额外时长和最后重置日期均会持久化，批量写入采用单线程队列与事务提交，并带有失败重试和关闭时收尾保存。
核心功能
- 自动攻击开关：玩家可通过 `/ka toggle` 开启或关闭自动攻击，开关状态可保存到 `data.yml`。
- 每日时长限制：支持 `1h30m20s`、`30m`、`0` 和 `-1`（无限）等格式；时长用尽后自动关闭攻击。
- 权限组配置：按 LuckPerms 组设置优先级、扫描范围和每日基础时长。
- 管理员补时：管理员可以为在线玩家增加额外自动攻击时间。
- 目标过滤：可分别控制是否攻击玩家、生物，配置 NPC 元数据 key，并设置永久生物白名单。
- 宠物保护：支持驯服生物、主人信息及 MCPets、MyPet 等常见宠物标记识别。
- NPC 保护：内置 Citizens、Shopkeeper 等常见标记，并支持自定义元数据 key。
- 数据库持久化：支持 SQLite 和 MySQL，自动创建 `player_time` 数据表。
- 异步批量保存：定时保存、失败重试、插件关闭时最终保存，减少数据丢失风险。
- 性能调试：管理员可查看近阶段的玩家扫描、候选校验、攻击次数和预算顺延统计。
插件命令
主命令：`/killingaura`，别名：`/ka`
/ka toggle 开启或关闭自己的自动攻击
/ka reload 重载配置；数据库连接配置需重启后生效
/ka addtime <玩家> <时间> 给在线玩家增加额外自动攻击时间
/ka save 立即异步保存全部数据
/ka clearpetcache 清空宠物与实体识别缓存
/ka debug 开关性能调试统计
权限节点
killingaura.use 使用自动攻击，默认 OP
killingaura.reload 重载配置，默认 OP
killingaura.admin 保存数据、增加时长、维护缓存及调试，默认 OP
KillingAura 不是简单的“定时攻击”脚本，而是一套围绕性能预算、目标保护和权限时长管理重新组织的自动攻击方案。插件将攻击扫描、玩家会话、每日时长、数据库持久化和权限组同步拆分为独立模块，在保留 `/ka toggle` 简单使用方式的同时，尽量降低高在线人数和高实体密度场景下的额外开销。
核心技术亮点
1. 分片扫描与预算限流
攻击循环只处理到期玩家，并同时受到每 tick 玩家扫描数、单次候选实体数、每 tick 攻击目标数和微秒级软预算限制。超出当前 tick 预算的工作会自动顺延，避免一次性遍历全服玩家或无限检查实体。
2. 主线程安全，数据异步持久化
实体查找、视线检测和实际攻击严格遵循 Paper/Bukkit 主线程 API；玩家时长和开关状态的数据库读写、批量保存及失败重试则交由独立数据库线程处理，减少磁盘或网络 I/O 对游戏线程的影响。
3.完整的目标保护机制
内置视线与夹角检查、方块遮挡检查、传送冷却、实体生成保护，以及 NPC、宠物和可配置生物白名单过滤。默认关闭 PVP，默认忽略常见 NPC 与宠物元数据，降低误伤风险。
4. LuckPerms 权限组驱动
可以按 LuckPerms 权限组分别设置攻击范围和每日可用时长。玩家同时属于多个已配置组时，插件按 `priority` 选择最高优先级组；未安装 LuckPerms 时自动使用 `default` 组，不影响插件启动。
5. SQLite / MySQL 双存储
默认使用本地 SQLite，无需额外搭建数据库；群组服或多服共享数据时可切换 MySQL。玩家每日基础时长、额外时长和最后重置日期均会持久化，批量写入采用单线程队列与事务提交，并带有失败重试和关闭时收尾保存。
核心功能
- 自动攻击开关：玩家可通过 `/ka toggle` 开启或关闭自动攻击，开关状态可保存到 `data.yml`。
- 每日时长限制：支持 `1h30m20s`、`30m`、`0` 和 `-1`（无限）等格式；时长用尽后自动关闭攻击。
- 权限组配置：按 LuckPerms 组设置优先级、扫描范围和每日基础时长。
- 管理员补时：管理员可以为在线玩家增加额外自动攻击时间。
- 目标过滤：可分别控制是否攻击玩家、生物，配置 NPC 元数据 key，并设置永久生物白名单。
- 宠物保护：支持驯服生物、主人信息及 MCPets、MyPet 等常见宠物标记识别。
- NPC 保护：内置 Citizens、Shopkeeper 等常见标记，并支持自定义元数据 key。
- 数据库持久化：支持 SQLite 和 MySQL，自动创建 `player_time` 数据表。
- 异步批量保存：定时保存、失败重试、插件关闭时最终保存，减少数据丢失风险。
- 性能调试：管理员可查看近阶段的玩家扫描、候选校验、攻击次数和预算顺延统计。
插件命令
主命令：`/killingaura`，别名：`/ka`
/ka toggle 开启或关闭自己的自动攻击
/ka reload 重载配置；数据库连接配置需重启后生效
/ka addtime <玩家> <时间> 给在线玩家增加额外自动攻击时间
/ka save 立即异步保存全部数据
/ka clearpetcache 清空宠物与实体识别缓存
/ka debug 开关性能调试统计
权限节点
killingaura.use 使用自动攻击，默认 OP
killingaura.reload 重载配置，默认 OP
killingaura.admin 保存数据、增加时长、维护缓存及调试，默认 OP
