💪 动作

动作系统提供了由插件提供的预设效果。但是，您也可以使用API添加自己的动作。此系统可应用于触发动作的任何地方，例如当您成功捕捉到鱼时，比赛结束并发放奖励时，或者出售鱼时。

动作由三部分组成

type: 动作类型
value: 动作的参数
chance: 可选（0~1 默认: 1）

如果值是整数或双精度值，则可以使用表达式，例如

exp_action:
  type: exp
  value: '{level} * 3'

动作库

message（向玩家发送消息）

messages_action:
  type: message
  value:
    - '<#FF4500>[1st] 恭喜！您获得了一等奖！'

random-message（从列表中随机发送消息）

message:
  type: random-message
  value:
    - '消息1'
    - '消息2'
    - '消息3'

broadcast（向在线玩家发送消息）

broadcast_action:
  type: broadcast
  value:
    - '<#D4F2E7>◤─────────────────────────◥'
    - ''
    - '             <gray>[<#87CEFA>🎣<gray>]  <gradient:#F0F8FF:#87CEFA:#F0F8FF>钓鱼比赛'
    - ''
    - '      <#E1FFFF>目标:'
    - '         <#B0C4DE>尽可能多地捕捉鱼'
    - '           <#B0C4DE>开始钓鱼以参加比赛！'
    - ''
    - '<#D4F2E7>◣─────────────────────────◢'

command（执行控制台命令）

command_action:
  type: command
  value:
    - 'money give {player} 200'

player-command （以玩家身份执行命令）

command_action:
  type: player-command
  value:
    - 'say hello'

random-command（从列表中随机执行控制台命令）

command_action:
  type: random-command
  value:
    - 'money give {player} 200'
    - 'money give {player} 100'
    - 'money give {player} 50'

close-inv（关闭玩家当前打开的物品栏）

close_action:
   type: close-inv

actionbar

actionbar_action:
  type: actionbar
  value: '您好'

random-actionbar

actionbar_action:
  type: random-actionbar
  value: 
    - 'Hi'
    - '你好'
    - 'Hola'

mending（给予玩家应用于修复的经验值）

mending_action:
  type: mending
  value: 1

exp（直接给玩家经验值以升级）

exp_action:
  type: exp
  value: 1

chain（作为一组执行动作）

chain_action:
  type: exp
  value: 
    action_1: ...
    action_2: ...
  chance: 0.5

delay（延迟 x 个tick）

delay_action:
  type: delay
  value: 
    delay: 20
    async: false
    actions:
      action_1: ...
      action_2: ...

timer

timer_action:
  type: timer
  value: 
    delay: 3
    async: false
    duration: 20
    period: 2
    actions:
      action_1: ...
      action_2: ...

title

title_action:
  type: title
  value:
    title: '<green>GG!</green>'
    subtitle: '您捕捉到了一条 {nick}'
    fade-in: 20
    stay: 30
    fade-out: 10

random-title

title_action:
  type: random-title
  value:
    titles:
      - '<green>GG!</green>'
      - '<green>干得好！</green>'
    subtitles:
      - '您捕捉到了一个 {loot}'
      - '哇！好的捕获！'
      - '哦，{loot}，我们来了！'
      - '让我们看看是什么！'
    fade-in: 20
    stay: 30
    fade-out: 10

sound

sound_action:
  type: sound
  value:
    key: 'minecraft:block.amethyst_block.place'
    source: 'player'
    volume: 1
    pitch: 1

potion-effect

potion_action:
  type: potion-effect
  value:
    type: 'blindness'
    duration: 20
    amplifier: 0

plugin-exp（来自其他插件的经验，例如工作/技能插件）

plugin_exp_action:
  type: plugin-exp
  value:
    plugin: mcMMO
    exp: 20
    target: FISHING

conditional（仅当玩家满足条件时才触发动作）

conditional_action:
  type: conditional 
  value:
    conditions:
       ...
    actions:
       ...

priority（执行满足条件的第一个动作组。）

priority_action:
  type: priority
  value:
    priority_1:
      conditions:
         ...
      actions:
         ...
    priority_2:
      conditions:
         ...
      actions:
         ...
    others:
      actions:
         ...   

fake-item（显示一段时间的虚假物品） 注意："opposite-yaw" 和 "yaw" 不能同时使用

fake_item_action:
  type: fake-item
  value:
    duration: 25     <- ticks
    position: other  <- other/player
    item: water_effect
    use-item-display: true # 是否使用文本展示实体（1.19.4+）
    y: 0             <- y 偏移
    x: 0             <- x 偏移
    z: 0             <- z 偏移 
    yaw: 0
    opposite-yaw: true
    range: 0        # 如果 range = 0，只有一个玩家能看到全息图

hologram（显示一段时间的全息图）

hologram_action:
  type: hologram
  value:
    duration: 20     <- ticks
    text: '{player} 捕捉到了一个 {loot}！'
    position: player <- other/player
    use-text-display: true # 是否使用文本展示实体（1.19.4+）
    rgba: 0,0,0,0
    range: 16       # 如果 range = 0，只有一个玩家能看到全息图
    y: 2             <- y 偏移
    x: 0             <- x 偏移
    z: 0             <- z 偏移 

fish-finder

finder_action:
  type: fish-finder
  value: false（false: 水 / true: 熔岩）

message-nearby

message_action:
  type: message-nearby
  value: 
    message: 
      - '您好 {near}。此消息由 {player} 发送'
    range: 32

command-nearby

command_action:
  type: command-nearby
  value: 
    command: 
      - 'give {near} apple'
    range: 32

actionbar-nearby

actionbar_action:
  type: actionbar-nearby
  value: 
    actionbar: '这是一个动作栏'
    range: 32

title-nearby

title_action:
  type: title-nearby
  value: 
    title: '<green>标题</green>'
    subtitle: '副标题'
    fade-in: 20
    stay: 30
    fade-out: 10
    range: 32

food

https://zh.minecraft.wiki/w/%E9%A5%A5%E9%A5%BF

food_action:
  type: food
  value: 2

saturation

https://zh.minecraft.wiki/w/%E9%A5%A5%E9%A5%BF

saturation_action:
  type: saturation
  value: 1.5

item-amount

item_amount_action:
  type: item-amount
  value:
    # main / off
    hand: main
    amount: -1

durability

durability_action:
  type: durability
  value:
    # hand / off_hand / feet / head / chest /legs
    slot: hand
    amount: -1

give-item

item_action:
  type: give-item
  value:
    item: CustomFishing:rod:star_rod
    amount: 1

give-money

money_action:
  type: give-money
  value: 100.12

take-money

money_action:
  type: take-money
  value: 50.54

level

money_action:
  type: level
  value: -10

context-arg

argument_action:
  type: context-arg
  value:
    test: custom
    another: another

drop-random-items (根据当前条件随机掉落物品)

drop_random_loots_action:
  type: drop-random-loots
  value:
    amount: 10
    extra-attempts: 5 # 如果战利品不是物品，插件应该尝试多少次？
    to-inventory: false