Skip to content

概述

hna-clearot 用于清理目标身上的周期效果(DOT/HOT)。

基本语法

yaml
- hna-clearot{参数} @目标选择器

参数列表

参数类型默认值说明
key字符串-按 key 清理(支持 * 前缀匹配)
tag字符串-按标签清理(如 dot/hot
source字符串all来源过滤(caster/trigger/all
all布尔false是否清理所有匹配实例

基本示例

yaml
# 清理目标的"burn-dot"
- hna-clearot{key="burn-dot"} @target

# 清理目标的所有 DOT
- hna-clearot{tag="dot"} @target

# 清理施法者施加的所有周期效果
- hna-clearot{source=caster} @target

# 清理目标的所有周期效果
- hna-clearot{all=true} @target

按 key 清理

yaml
# 清理指定 key
- hna-clearot{key="burn-dot"} @target

# 前缀匹配(清理所有以"fire-"开头的)
- hna-clearot{key="fire-*"} @target

按标签清理

yaml
# 清理所有 DOT
- hna-clearot{tag="dot"} @target

# 清理所有 HOT
- hna-clearot{tag="hot"} @target

按来源清理

yaml
# 清理施法者施加的周期效果
- hna-clearot{source=caster;key="burn-dot"} @target

# 清理触发者施加的周期效果
- hna-clearot{source=trigger} @target

# 清理所有来源的周期效果(默认)
- hna-clearot{source=all} @target

实际应用场景

场景 1:净化技能

yaml
Cleanse:
  Skills:
  # 清理目标的所有 DOT
  - hna-clearot{tag="dot"} @target
  - effect:particles{p=VILLAGER_HAPPY;a=20} @target
  - message{m="&a所有持续伤害已清除!"} @target

场景 2:驱散自己的 DOT

yaml
SelfCleanse:
  Skills:
  # 清理自己身上的所有 DOT
  - hna-clearot{tag="dot"} @Self
  - message{m="&a你清除了身上的持续伤害!"} @Self

场景 3:清理特定 DOT

yaml
RemoveBurn:
  Skills:
  # 只清理灼烧效果
  - hna-clearot{key="burn-dot"} @target
  - message{m="&a灼烧效果已清除!"} @target

场景 4:清理施法者的效果

yaml
RecallEffects:
  Skills:
  # 清理施法者施加的所有周期效果
  - hna-clearot{source=caster;all=true} @PlayersInRadius{r=20}
  - message{m="&e你的周期效果已被召回!"} @Self

场景 5:Boss 重置

yaml
BossReset:
  Skills:
  # 清理所有玩家身上的周期效果
  - hna-clearot{all=true} @PlayersInRadius{r=50}
  - message{m="&cBoss 清除了所有周期效果!"} @PlayersInRadius{r=50}

完整技能示例

yaml
PurifySkill:
  Cooldown: 20
  Skills:
  # 检查目标是否有 DOT
  - hna-hasot{tag="dot"} true
  
  # 清理所有 DOT
  - hna-clearot{tag="dot"} @target
  
  # 特效
  - effect:particles{p=HEART;a=20} @target
  - sound{s=entity.player.levelup} @target
  - message{m="&a净化完成!所有持续伤害已清除。"} @target
  
  # 给予短暂的免疫 Buff
  - hna-buff{key="净化免疫";time=60;level=1} @target

与专用清理的区别

Mechanic清理范围
hna-clearotDOT 和 HOT(通用)
hna-cleardot仅 DOT
hna-clearhot仅 HOT

注意事项

  1. 不指定 keytag 时,需要设置 all=true
  2. key 支持 * 前缀匹配
  3. source=caster 只清理施法者施加的效果
  4. 清理后不会有任何提示,建议配合 message 使用
  5. 需要明确的目标选择器

调试方法

text
/hnattr periodic list
/hnattr periodic inspect <key>
/hnattr periodic debug detail <key>

相关文档

HN 系列插件文档