离渊系列插件Wiki

配置说明 ​

主配置文件为 plugins/LyAutoAttack/config.yml。修改后使用 /laa reload 重载；如果涉及前置插件加载顺序、服务端版本或客户端通道问题，建议重启服务器。

状态文本 ​

yaml
# 杀戮状态开关文本
autoattack-enable-placeholer: "§a已启动"
autoattack-disable-placeholer: "§7未启动"

这两个文本会影响 %laa_status% 和 %laa_lock% 的显示，也会影响使用这些变量做条件判断时的比较内容。配置键名中的 placeholer 按默认文件保留，不要自行改成其他拼写。

攻击与伤害 ​

配置项默认值说明
attack-mode4伤害模式，默认配置中保留 1 到 4 四种模式说明
plugin-switch-nodamageticktrue开启杀戮后接管受击冷却，避免自动攻击和手动攻击叠加造成异常高频伤害
force-attacktrue无视目标受击冷却强制攻击
send-swap-handtrue发送原版挥手动作，不需要客户端模组
debug-show-target-entity-typefalse开启后 OP 在命中时会收到目标实体类型提示，便于配置过滤列表
yaml
attack-mode: 4
plugin-switch-nodamagetick: true
force-attack: true
send-swap-hand: true
debug-show-target-entity-type: false

plugin-switch-nodamagetick 开启后，玩家处于自动攻击状态时，普通攻击包和多余伤害会被拦截，只保留插件本次攻击需要的伤害路径。若服务器存在特殊技能插件，建议先保持默认值测试。

实体过滤 ​

yaml
filter-entities:
  - "COW"
  - "PLAYER"

列表内填写 Bukkit 实体类型名。被列入的实体不会成为自动攻击目标。插件还会过滤盔甲架和部分坐骑实体。

开启 debug-show-target-entity-type 后，让 OP 玩家测试命中一次即可看到实体类型名，再将不希望攻击的类型写入 filter-entities。

默认参数 ​

默认参数用于没有匹配到任何分组的玩家。

配置项默认值说明
default-range3.5索敌范围，最终值会限制在 0 到 64
default-speed5攻击间隔，单位 tick，20 tick 为 1 秒，最终最低为 1
default-max1最大攻击目标数，near 模式下变量显示固定为 1
default-knockback0开启杀戮后给予玩家的抗击退值
default-modenear默认攻击模式，支持 near 与 all
yaml
default-range: 3.5
default-speed: 5
default-max: 1
default-knockback: 0
default-mode: "near"

攻击模式 ​

模式效果
near每次触发时攻击范围内最近的一个可攻击目标
all每次触发时攻击范围内多个目标，数量受 max 限制

开关提示与命令 ​

yaml
default-start-message:
  - "你开始了官方杀戮"
default-start-commands:
  - "[console]tell {player} 你开启了官方杀戮"
default-stop-message:
  - "你停止了官方杀戮"
default-stop-commands:
  - "[console]tell {player} 你停止了官方杀戮"

命令前缀支持：

前缀执行身份
[console]控制台执行
[op]临时 OP 身份执行玩家命令
[player]玩家自身执行

{player} 会替换为玩家名。

属性加成 ​

yaml
attribute-addition:
  enable: false
  range: "%ap_attack:min%"
  max: "%ap_attack:min%"
  speed: "%ap_attack:min%"
  knockback: "%ap_attack:min%"

启用后，插件会读取 PlaceholderAPI 变量并解析为数字。无法解析时该项按 0 处理，并在控制台输出提示。

项目计算方式
range基础范围增加 基础范围 * 变量值%
max基础数量直接加上变量整数值
speed基础间隔按 基础间隔 / (1 + 变量值%) 换算，值越高攻击越快
knockback基础抗击退直接加上变量整数值

提示

这里的变量必须最终解析为纯数字。带颜色、单位、百分号文本或空值都会导致解析失败。

抗击退 ​

yaml
strengthen-knockbak-mode: false
persistent-knockback: false
配置项说明
strengthen-knockbak-mode增强抗击退，开启后会直接取消玩家速度变化；可能影响部分技能位移效果
persistent-knockback持久抗击退，开启后玩家进服就按分组获得抗击退，不再只依赖杀戮开启状态

若服务器有翻滚、冲刺、击飞等技能，先谨慎测试 strengthen-knockbak-mode。

自动开启 ​

插件可在跨世界、进服、重生后延迟检查条件，并自动开启杀戮。

yaml
join-auto-autoattack-enable: false
join-auto-attack-delay: 20
join-auto-autoattack-condition:
  - "papi:{%player_level% >= 0}"
  - "permission:{vip.1}"
  - "nopermission:{vip.1}"

同类配置还有：

场景开关延迟条件列表
跨世界changeworld-auto-autoattack-enablechangeworld-auto-attack-delaychangeworld-auto-autoattack-condition
进服join-auto-autoattack-enablejoin-auto-attack-delayjoin-auto-autoattack-condition
重生respawn-auto-autoattack-enablerespawn-auto-attack-delayrespawn-auto-autoattack-condition

条件格式 ​

条件用于自动开启，也用于分组匹配。一个条件列表内的条件需要全部通过。

| 格式 | 说明 | | ----------------------------------- | ------------------------------------------------------------------------- | --- | --- | | papi:{%player_level% >= 10} | PlaceholderAPI 表达式判断，支持 >、>=、<、<=、==、!=、&&、| | | | permission:{vip.1} | 玩家拥有指定权限 | | nopermission:{vip.1} | 玩家没有指定权限 | | name:{Origin#MainHand@&a测试武器} | 指定槽位物品名完全匹配 |

已确认的物品名匹配来源：

来源写法
DragonCoreDragonCore#槽位名
GermPluginGermPlugin#槽位名
LyInventoryReloadLyInventoryReload#背包id#类型
YeeJewelryYeeJewelry#背包id#槽位id
原版背包Minecraft#槽位id
原版装备 / 手持Origin#MainHand、Origin#OffHand、Origin#Helmet、Origin#ChestPlate、Origin#Legging、Origin#Boots

物品名使用显示名完全匹配，& 会转换为颜色符号。

分组配置 ​

group 会从上往下匹配，命中第一个满足条件的分组。没有命中任何分组时，使用 default-* 默认参数。

yaml
group:
  "vip1":
    condition:
      - "permission:{vip.1}"
    range: 5
    max: 2
    speed: 20
    knockback: 0
    mode: "all"
    animation-sequence: []
    start-message:
      - "你开始了官方杀戮"
    start-commands:
      - "[console]tell {player} 你开启了官方杀戮"
    stop-message:
      - "你停止了官方杀戮"
    stop-commands:
      - "[console]tell {player} 你停止了官方杀戮"

建议把条件更严格、更高优先级的分组放在前面，例如高级 VIP、特殊装备职业、活动临时分组。

光环效果 ​

光环效果需要玩家客户端安装配套 LyAutoAttackMod 才能显示。服务端会在开启、关闭、命中时通过插件消息通道发送状态。

yaml
default-arua-effect:
  off-color: "#00BFFF"
  on-color: "#FF4040"
  line-width: 6.0
  offset-y: 0.2
  alpha: 255
  hit-hold-ms: 500
  fade-back-ms: 500
配置项说明
off-color平时颜色
on-color命中后的高亮颜色
line-width光环虚线线宽
offset-y光环距离玩家脚底的高度
alpha透明度，建议 0 到 255
hit-hold-ms命中颜色保持时间，单位毫秒
fade-back-ms渐变回平时颜色的时间，单位毫秒

分组内也可以配置 arua-effect 覆盖默认光环效果。键名 arua 按默认配置保留。

动作序列 ​

yaml
default-animation-sequence:
  - "动作1"
  - "delay:2000"
  - "动作2"

动作序列在自动攻击命中后触发，会按列表顺序循环播放。delay:毫秒 用于跳过本次动作并设置下一次动作允许播放的时间。

当服务器安装 GermPlugin 时，会发送萌芽动作；否则如果安装 DragonCore，会发送龙核动作。列表留空或删除则不播放动作。