🪁物品

在开始配置插件的 itemstack 之前,请确保你使用了适合你游戏版本的材料。每个按钮必须附带一个 itemstack(某些特定情况下除外)。

item:
  material: <物品材质>
  amount: <数量>
  data: <材质数据, 仅适用于 1.8 到 1.12 版本>
  durability: <耐久值>
  url: <玩家皮肤的 base64>
  name: <显示名称>
  lore: <文本列表>
  potion: <药水效果类型>
  level: <药水等级>
  splash: <药水飞溅 true 或 false>
  extended: <药水扩展 true 或 false>
  glow: <添加发光效果>
  modelID: <自定义模型 ID>
  enchants: <附魔列表>
  flags: <物品属性列表>
  firework: <烟花元数据>
  banner: <旗帜颜色>
  patterns: <旗帜图案>
  color: <皮革护甲颜色>

材质

material: <物品材质>

物品的材质。你可以使用占位符来显示材质。

支持的材料值:

  • Material - 示例:material: STONE

  • 占位符 值 - 示例:material: %your_placeholder_material%

  • 免费 - zHead 推荐 (zhd:<id>) 示例:material: zhd:<id>

  • 付费 - HeadDatabase (hdb:<id>) 示例:material: hdb:<id>

  • 付费 - Oraxen (oraxen:<item name>) 示例:material: oraxen:<item name>

  • 付费 - ItemAdder (itemsadder:<item name>) 示例:material: itemsadder:<item name>

  • 免费 - SlimeFun (slimefun:<item name>) 示例:material: slimefun:<item name>

  • 免费 - Nova (nova:<item/block name>) 示例:material: nova:<item/block name>

  • Base64 (base64:<item in base64>) 使用命令 /zm save <item name> base64 获取此值

  • PlayerHead (playerHead: <player name>) 显示玩家的头部。示例:playerHead: "%player%" 显示打开菜单的玩家的头部


数量

amount: <amount>

物品堆叠的数量。你可以使用占位符来动态设置数量。


数据

data: <data, 仅适用于 1.8 到 1.12 版本>

物品的材质数据,仅适用于 1.8 到 1.12 版本。默认值为 0。


耐久值

durability: <耐久值>

物品的耐久值,默认值为 0。


URL

url: <玩家皮肤的 base64>

允许你显示一个 base64 编码的头部。你可以在网站 minecraft-head.com 上找到头部的值。

你需要获取 "Value" 字段中的内容(在 "Other" 类别下)。

示例

url: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNjM3YjhhMzk4MzdiYzNkNThmMDljOGM2ZTUzOTYyZDMzZjlmYTBiNjUzOThhNzc5MzUzYWRlMWUxNDcxM2VmZiJ9fX0="

名称

name: <显示名称>

物品上显示的名称。你可以使用 PlaceholderAPI 来动态设置名称。

如果你的服务器有 Kyori Adventure,你可以使用 mini message 格式


说明

lore:
  - <line1>
  - <line2>
  - <line3>
  - ...

允许你显示物品的说明。你可以使用 PlaceholderAPI 来动态设置说明。


药水

  potion: <药水效果类型>
  level: <药水等级, 1 或 2> # 默认 1
  splash: <药水飞溅 true 或 false>
  extended: <药水扩展 true 或 false>

允许你创建药水。详细的药水效果类型请参见 这里

警告:药水不能同时扩展并且有等级 2。

# 对于 1.8 到 1.12 的药水,你需要这样配置:
material: POTION
durability: 16454

发光

glow: <true 或 false>

允许物品发光。添加随机附魔和 HIDE_ENCHANT 物品标志。


模型 ID

modelID: <custom model id>

允许你在物品上设置自定义模型 ID。


附魔

enchants:
  - <enchantment name>,<enchantment level>

允许你添加附魔。你需要指定附魔名称和附魔等级,格式为:ENCHANT,ENCHANT_LEVEL

可用附魔列表:https://hub.spigotmc.org/javadocs/spigot/org/bukkit/enchantments/Enchantment.html


物品属性

flags:
  - <flag 1>
  - <flag 2>
  - ...

属性列表:https://hub.spigotmc.org/javadocs/spigot/org/bukkit/inventory/ItemFlag.html


颜色

type: LEATHER_CHESTPLATE
color: 40,150,40 # RGB 颜色

# 示例带 ARGB
color: 1,40,150,40 # ARGB 颜色,Alpha, RED, GREEN, BLUE

为皮革护甲设置 RGB 颜色。格式为:

<Red>,<Green>,<Blue>

例如,要设置颜色为 255 红色、100 绿色和 50 蓝色,你可以使用:

255,100,50

color: <red>,<green>,<blue>

你还可以在颜色中添加 alpha 值以获得 ARGB(Alpha, Red, Green, Blue)。格式为:

<Alpha>,<Red>,<Green>,<Blue>

例如,要设置颜色为 128 alpha(半透明)、255 红色、100 绿色和 50 蓝色,你可以使用:

128,255,100,50

color: <alpha>,<red>,<green>,

烟花、旗帜和药水的颜色格式也使用 ARGB 格式:

<Alpha>,<Red>,<Green>,<Blue>

例如:

  • 烟花:设置颜色为 255 alpha(完全不

透明)、200 红色、150 绿色和 100 蓝色,你可以使用:255,200,150,100

  • 旗帜:设置颜色为 255 alpha、100 红色、200 绿色和 50 蓝色,你可以使用:255,100,200,50

  • 药水:设置颜色为 128 alpha(半透明)、255 红色、50 绿色和 50 蓝色,你可以使用:128,255,50,50

有关更多详细信息,请参见 Color 的 Javadocs 这里


烟花

type: FIREWORK
firework:
  star: true
  flicker: true
  trail: true
  type: BALL_LARGE
  colors:
    - 250,10,10 # RGB 和 ARGB
  fadeColors:
    - 250,10,250 # RGB 和 ARGB

烟花类型:https://hub.spigotmc.org/javadocs/spigot/org/bukkit/FireworkEffect.Type.html


旗帜

type: BANNER
banner: PINK # 旗帜颜色
patterns: # 旗帜图案:<颜色>:<图案>
  - RED:SQUARE_BOTTOM_LEFT
  - GREEN:STRIPE_LEFT

允许你创建一个旗帜。图案列表:https://hub.spigotmc.org/javadocs/spigot/org/bukkit/block/banner/PatternType.html

翻译名称

允许将物品的名称翻译成多种语言

items:
  example:
    item:
      material: GRASS_BLOCK
      name: "&a这是一个非常漂亮的草方块"
      lore:
        - "" 
        - "&e我的第一个 zMenu 按钮"
        - "&7恭喜你,你将发现"
        - "&7zMenu 的所有可能性。"

      # 将物品名称翻译成多种语言
      # 你必须定义所用的语言和国家
      # 原版 Minecraft 客户端将使用小写的语言/国家对,用下划线分隔,但自定义资源包可能使用任何格式。
      translatedName:
        - locale: "fr_fr" # 定义为法语
          name: "&aC’est un très beau bloc d’herbe !"
        - locale: "es_es" # 定义为西班牙语
          name: "&a¡Es un hermoso bloque de hierba!"

翻译说明

允许将物品的说明翻译成多种语言

items:
  example:
    item:
      material: GRASS_BLOCK
      name: "&a这是一个非常漂亮的草方块"
      lore:
        - "" 
        - "&e我的第一个 zMenu 按钮"
        - "&7恭喜你,你将发现"
        - "&7zMenu 的所有可能性。"

      # 将物品说明翻译成多种语言
      # 你必须定义所用的语言和国家
      # 原版 Minecraft 客户端将使用小写的语言/国家对,用下划线分隔,但自定义资源包可能使用任何格式。
      translatedLore:
        - locale: "fr_fr" # 定义为法语
          lore:
            - "" # 空行以在名称和说明之间添加空格
            - "&e我的第一个 zMenu 按钮"
            - "&7恭喜你,你将发现"
            - "&7zMenu 的所有可能性。"
        - locale: "es_es" # 定义为西班牙语
          lore:
            - "" # 空行以在名称和说明之间添加空格
            - "&e我的第一个 zMenu 按钮"
            - "&7恭喜你,现在你将发现"
            - "&7zMenu 的所有可能性。"

Last updated