Skip to content

概述

hna-clearbuff 用于清除目标身上的所有 Buff。

基本语法

yaml
- hna-clearbuff @目标选择器

参数列表

无参数。

基本示例

yaml
# 清除目标的所有 Buff
- hna-clearbuff @target

# 清除自己的所有 Buff
- hna-clearbuff @Self

实际应用场景

场景 1:Boss 重置技能

yaml
BossReset:
  Skills:
  - hna-clearbuff @Self
  - message{m="&cBoss 重置了所有状态!"} @PlayersInRadius{r=30}

场景 2:死亡惩罚

yaml
DeathPenalty:
  Skills:
  - hna-clearbuff @trigger
  - message{m="&c你的所有增益效果已消失!"} @trigger

场景 3:竞技场开始前清理

yaml
ArenaStart:
  Skills:
  - hna-clearbuff @PlayersInRadius{r=50}
  - message{m="&e竞技场开始,所有状态已清除!"} @PlayersInRadius{r=50}

场景 4:特殊机制触发

yaml
PurgeAll:
  Skills:
  # 清除所有玩家的 Buff
  - hna-clearbuff @PlayersInRadius{r=100}
  - effect:particles{p=EXPLOSION_LARGE;a=50} @Self
  - message{m="&c所有增益效果被清除!"} @PlayersInRadius{r=100}

完整技能示例

yaml
BossPhaseTransition:
  Skills:
  # Boss 阶段转换
  - message{m="&c&lBoss 进入第二阶段!"} @PlayersInRadius{r=50}
  
  # 清除 Boss 自身所有 Buff
  - hna-clearbuff @Self
  
  # 清除所有玩家的 Buff
  - hna-clearbuff @PlayersInRadius{r=50}
  
  # 给 Boss 施加新的 Buff
  - hna-buff{key="狂暴";time=600;level=2} @Self
  
  # 特效
  - effect:particles{p=EXPLOSION_HUGE;a=100} @Self

注意事项

  1. 会清除目标身上的所有 Buff,包括增益和减益
  2. 无法选择性清除,如需选择性清除请使用 hna-removebuff
  3. 需要明确的目标选择器
  4. 清除后不会有任何提示,建议配合 message 使用

与 hna-removebuff 的区别

特性hna-clearbuffhna-removebuff
清除范围所有 Buff指定 Buff
参数需要 key
使用场景重置状态净化/驱散

调试方法

text
/hnattr buffs
/hnattr source

相关文档

HN 系列插件文档