🎬 动作格式

动作格式包含一些选项。

信息

在动作格式示例中的 actions 只代表新版本的动作格式。若需要查看某个功能或设置名称，请转到对应页面，如 buy-actions。

全局选项

生效次数

这个动作只会在玩家购买/出售指定次数的物品时触发。

• start-apply：操作触发的起始次数。可选。默认为 0。
• end-apply：操作触发的终止次数。可选。默认为无限大。
• apply：操作生效的对应次数。格式：[1,2,3,4]可选。默认使用 start-apply 的值。

    actions:
      1:
        apply: [1,2,3,4,5]
        start-apply: 1
        end-apply: 5

一次全售/多次单售

当多个物品被出售时，添加这个选项可以表示只触发首个物品的动作。在设计播放音效等行为时非常有用，如果不添加这个选项，则所有物品出售时都会播放一次音效。

    actions:
      1:
        sell-all-once: true # 全部出售菜单
        multi-once: true # 增量购买菜单

单次打开

只对菜单的 open-actions 生效。若启用后，只有玩家在首次打开该菜单才会触发此动作。因此，若该菜单由其他菜单打开，则不会触发此操作。

    actions:
      1:
        open-once: true

点击类型

这个动作只在玩家使用对应方式点击按钮时触发。对 open-actions、菜单配置内的 close-action 以及物品设置中的 buy-actions 和 sell-actions 无效。

    actions:
      1:
        click-type: LEFT

支持变量

• {world}
• {amount}
• {player_x}
• {player_y}
• {player_z}
• {player_pitch}
• {player_yaw}
• {player}
• {item} - 物品 ID
• {item-name} - 物品的展示名称
• {shop} - 商店 ID
• {shop-name} - 商店的展示名称
• {shop-menu} - 商店的菜单 ID

声音

向玩家发送声音。

    actions:
      1:
        type: sound
        sound: 'ui.button.click'
        volume: 1
        pitch: 1

消息

向玩家发送消息，支持彩色代码。

    actions:
      1:
        type: message
        message: 'Hello!'

公告

向所有玩家发送消息，支持彩色代码。

    actions:
      1:
        type: announcement
        message: 'Hello!'

效果

给予玩家药水效果。

    actions:
      1:
        type: effect
        potion: BLINDNESS
        duration: 60
        level: 1
        ambient: true # 可选
        particles: true # 可选
        icon: true # 可选

传送

将玩家传送至指定位置。

    actions:
      1:
        type: teleport
        world: LobbyWorld
        x: 100
        y: 30
        z: 300
        pitch: 90 # 可选
        yaw: 0 # 可选

玩家身份执行命令

以玩家身份执行命令。

    actions:
      1:
        type: player_command
        command: 'tell Hello!'

管理员身份执行命令

以管理员身份执行命令。

    actions:
      1:
        type: op_command
        command: 'tell Hello!'

控制台身份执行命令

以控制台身份执行命令。

    actions:
      1:
        type: console_command
        command: 'op {player}'

生成原版实体

生成原版的实体。

    actions:
      1:
        type: entity_spawn
        entity: ZOMBIE
        world: LOBBY # 可选
        x: 100.0 # 可选
        y: 2.0 # 可选
        z: -100.0 # 可选

生成 MythicMobs 实体

生成 MythicMobs 插件的实体。需要安装对应插件。

    actions:
      1:
        type: mythicmobs_spawn
        entity: Super_Skeleton
        level: 1 # 可选
        world: LOBBY # 可选
        x: 100.0 # 可选
        y: 2.0 # 可选
        z: -100.0 # 可选

打开普通菜单

打开指定的普通菜单。

    actions:
      1:
        type: open_menu
        menu: main

打开商店菜单

    actions:
      1:
        type: shop_menu
        shop: farming

购买物品

    actions:
      1:
        type: buy
        shop: food
        item: A
        amount: 5 # 可选

出售物品

    actions:
      1:
        type: sell
        shop: food
        item: A
        amount: 5 # 可选
        sell-all: true # 可选

关闭

关闭当前界面。

    actions:
      1:
        type: close

延迟

使得对应动作延迟 X 刻执行。

    actions:
      1:
        type: delay
        time: 50
        wait-for-player: true
        actions:
          1:
            type: entity_spawn
            entity: ZOMBIE

几率

设置动作触发的几率，最高为 100。50 表示有 50% 几率执行。

    actions:
      1:
        type: chance
        rate: 50
        actions:
          1:
            type: entity_spawn
            entity: ZOMBIE

任选

随机挑选其中 X 条动作并执行。

    actions:
      1:
        type: any
        amount: 2
        actions:
          1:
            type: entity_spawn
            entity: ZOMBIE
          2:
            type: entity_spawn
            entity: SKELETON
          3:
            type: entity_spawn
            entity: WITHER

条件

只有达到条件的玩家才可触发对应动作。

    actions:
      1:
        type: conditional
        conditions:
          1: 
            type: world
            world: lobby
        actions:
          1:
            type: entity_spawn
            entity: ZOMBIE

连接

需要启用 config.yml 中的 bungeecord-sync.enabled 选项，并正确配置 BungeeCord 的设置。更多信息请参阅“多服同步”章节。

    actions:
      1:
        type: connect
        server: 'lobby'