🔲 全局菜单
所有菜单都存储在 /menus/ 文件夹下。
类型
这里有三种菜单：
- 普通菜单：与其他菜单插件的相同，你可以通过它们打开其他商店。
- 商店菜单：商店菜单会在其内展示指定物品。每个菜单都有一个
menu选项来设置对应的商店菜单。商店菜单拥有所有普通菜单的功能。多个商店可以共享同一个商店菜单，可以做到打开时排版相同而出售物品不同的效果。 - 增量购买菜单：能够选择你所购买或出售的数量。这类菜单有着更多设置，你可以前往“增量购买菜单”章节了解更多。增量购买菜单只可以在商店界面选定物品后打开，而不可以直接开启。
配置
title：菜单界面的标题。对于商店菜单，可填入{shop-name}以显示其在配置中设置的商店名称。size：菜单大小。仅支持填入如下数字：9、18、27、36、45、54。layout：按钮排版，参数类型为列表。更多信息见下。dynamic-layout：如果你在layout选项中使用了诸如变量这样的动态值，则需要启用该选项。对性能有一定影响。buttons：按钮配置，按钮 ID 会用在layout选项中，决定按钮显示的位置。conditions：只有达到指定条件的玩家才可以打开该菜单。需要在此使用“条件格式”。open-actions：打开菜单时执行的动作。需要在此使用“动作格式”。close-actions：关闭菜单时执行的动作。需要在此使用“动作格式”。请注意，如果你已经打开一个菜单，此时再通过任何方式打开本插件内的其他菜单也会触发此菜单的关闭动作。custom-command: 普通菜单的自定义命令选项，若需要为商店设置打开的自定义命令，请将其添加在商店配置中。
示例：
YAML
title: '商店'
size: 54
bedrock:
enabled: true
content: '&f欢迎来到商店.'
custom-command:
name: 'mineral'
description: '自定义描述'
conditions: []
open-actions:
1:
type: sound
sound: 'ui.button.click'
close-actions:
1:
type: sound
sound: 'ui.button.click'
dynamic-layout: false
layout:
- '000000000'
- '000000000'
- '0000A0000'
- '000000000'
- '000000000'
- '000000000'
buttons:
A:
display-item:
material: BREAD
name: '&d食物'
lore:
- '&7点击打开食物商店!'
actions:
1:
type: shop_menu
menu: 'example'每个按钮都设置了如下内容：
display-item：按钮显示的物品。需要在此使用“展示物品格式”。actions：点击后执行的动作。需要在此使用“动作格式”。fail-actions：未达到条件时点击按钮执行的动作。需要在此使用“动作格式”。conditions：点击该按钮所需满足的条件。若玩家没有达到条件，则会触发fail-actions下的动作。需要在此使用“条件格式”。
排版选项
插件中的菜单与商店功能相互独立，它们的配置也分别存储在 menus 与 shops 文件夹中。
- 若要知晓更多有关菜单功能的信息，请阅读“菜单”章节。
- 若要知晓更多有关商店功能的信息，请阅读“商店”章节。
- 若要知晓其他文件夹功能的相关信息，请阅读“配置文件”章节。
如下为一份商店的简单配置：
YAML
settings:
menu: 'example-shop-menu'
buy-more: true
shop-name: '方块商店'
hide-message: false
items:
A:
# ...
B:
# ...
C:
# ...在这里你可以找到 settings.menu 选项，它是连接商店与菜单的通道，至关重要。在本示例中，我们将其设置为 example-shop-menu。
你可以在 menus 文件夹中找到菜单文件，名称为 example=shop-menu.yml。
YAML
title: '{shop-name}'
size: 54
layout:
- '000000000'
- '0ABCDEFG0'
- '0HIJKLMN0'
- '0OPQRSTU0'
- '000000000'
- 'a0003000b'
buttons:
# ...在这些选项中，layout 选项至关重要，它决定了你的商品或按钮的展示位置。你会发现它是由 6x9 个字符组成的，每个字符都表示 Minecraft 箱子界面中的一个格子。对应位置的字符表示这个位置上显示的物品或按钮 ID。
在这个示例中：
- 因为没有 ID 为
0的商品或按钮，这些格子中不会显示任何物品。 - 如果使用这个菜单的商店有 ID 为
A、B、C、D等的商品，那么它们会逐个显示在对应的位置。 - 按钮同理。我往了和你说，你不仅可以在菜单配置文件中设置自定义按钮，商店配置文件中也可以。
- 如果你修改了
size选项的值，不要忘记将layout选项中额外的行删去。例如，如果你将 size 选项的值改为了 36，那么 layout 选项中对应的字符应该为 4x9。
你也可以用多个字符表示格子。但你需要用 ``` 符号包裹它们，这样插件才可以识别。例如：
YAML
layout:
- '000000000'
- '0`b1``b2``b3``b4``b5``b6``b7`0'
- '0HIJKLMN0'
- '0OPQRSTU0'
- '000000000'
- 'a0003000b'配上如下的商品或者按钮配置：
YAML
items: # 或者 buttons:
b1: # 商品 ID
price-mode: CLASSIC_ALL
product-mode: CLASSIC_ALL
products:
#...
sell-prices:
#...
b2:
#...
b3:
#...
b4:
#...
b5:
#...
b6:
#...
b7:
#...动态排版
你也可以在 layout 选项中使用 PlaceholderAPI 或内建变量，但在此之前你需要启用 dynamic-layout 选项。示例：
YAML
dynamic-layout: true
layout:
- '000000000'
# 在这里在这里使用随机变量！
- '0`{random_daily;;1}``{random_daily;;2}``b3``b4``b5``b6``b7`0'
- '0HIJKLMN0'
- '0OPQRSTU0'
- '000000000'
- 'a0003000b'
SnowCutieOwO