📝 物品格式™

信息

Mojang 非常喜欢修改物品（物品类型）、附魔、药水以及其他内容的 ID（及命名空间）。例如，他们在 1.21 将“横扫之刃（sweeping）”附魔改为了“sweeping_edge”。所以，在更新服务器版本之前，你需要仔细检查新版本是否对物品进行了什么修改，否则这会导致你的配置文件无法正常读取。

对接物品

对接插件

可用的值： EcoItems、EcoArmor、MMOItems、ItemsAdder、Oraxen、MythicMobs、eco、NeigeItems、ExecutableItems、Nexo。

YAML

hook-plugin: MMOItems

对接物品

对于 EcoItems、Oraxen 以及 MythicMobs，请直接填入 物品 ID。

对于 ItemsAdder 和 eco，请填入 命名空间:物品 ID。

eco 的命名空间为插件名称，如 talismans。物品 ID 遵照如下规则：
- Talisman：只需输入对应护身符名称。
- EcoArmor：
  - 盔甲：set_<套装 ID>_<部位 ID>
  - 高级盔甲：set_<套转 ID>_<部位 ID>_advanced
  - 升级宝石：shard_<升级宝石 ID>
- Reforges：stone_<重铸 ID>

对于 EcoArmor，请填入 盔甲套装 ID;;部位名称。部位名称可为BOOTS（靴子）、CHESTPLATE（胸甲）、ELYTRA（鞘翅）、HELMET（头盔）、LEGGINGS（护腿）。

对于 MMOItems，格式为 物品类型 ID;;物品 ID。

YAML

hook-item: AXE;;TEST_AXE

对于 CraftEngine，格式为 命名空间;;物品 ID。

信息

等等！ 如果你只是想要从自定义物品插件获取物品，hook-plugin 与 hook-item 选项对你来说已经足够了。如果你的自定义物品插件不受支持，请使用如下的命令。下面的内容适用于原版物品。如果你在这里设置，我们将会替换其上已有的属性，导致最终结果和物品插件中的物品不完全相同。

材料

若你想要使用插件保存的物品，只需将如下选项设置为保存物品的 ID，如 material: superior_sword。

若值为空或无效，则会变为石头。

请勿在添加 hook-plugin 选项时再使用该设置，强行使用没有任何效果！

YAML

material: APPLE

数量

支持使用 PlaceholderAPI 或表达式。例如 %player_health% * 5

YAML

amount: 5

最低价/最高价 - 仅支持价格/物品

用于动态定价。

YAML

min-amount: 1
max-amount: 15

物品属性组件（仅 1.21.5+，需要 Paper 系服务端）

通过 Paper 的 DataComponent API 而非 Spigot 的 ItemMeta API，达到轻松修改物品的目的。除此之外，所有 1.21.5+ 的物品属性都只会在 component 设置部分中生效，如 weapon。更多信息见此。

YAML

component:
  name: '<blue>村好剑'
  lore:
    - '<gray>这真是太棒了!'
  custom-model-data:
    float: # 自定义模型数据类型
      - '1'
  max-stack: 6
  food:
    can-always-eat: true
    nutrition: 5
    saturation: 5
  tool:
    damage-per-block: 5
    mining-speed: 1.3
    destroy-blocks-in-creative: true
    rules:
      # 方块名称, 挖掘速度, 是否掉落
      - 'stone, 1.4, true'
  song: otherside
  hide-tooltip:
    - 'lore'
  enchants:
    mending: 1
  glow: true
  attributes:
    max_health: 
      name: 'GENERIC_MAX_HEALTH' # 属性 ID
      amount: 5
      operation: ADD_NUMBER
      slot: MAINHAND

自定义名称/显示名称

根据配置文件，这里有两种格式，一种是 1.9 之前使用的旧版颜色，或者稍后版本中使用的文本组件。前者使用我们创建的颜色格式，后者则使用 MiniMessages 格式，更多内容可在这里详细阅读。 MiniMessage 格式需要服务端为 Paper 及其下游分支才可使用。

YAML

name: '&f精良的剑'

物品名称（1.20.5+）

物品名称是 1.20.5 新增的一种属性，与展示名称不同，物品名称不可以在铁砧中修改。

YAML

item-name: '&b稀有的剑'

描述

你可以使用 \n 表示换行。

最大堆叠（1.20.5+）

YAML

max-stack: 99

食物（1.20.5+）

格式：药水类型 ID, 持续时间, 倍率, 粒子效果淡色, 粒子效果显隐, 图标, 几率。

对于 粒子效果淡色、粒子效果显隐、图标，这些是布尔值标签，而 几率 则是 0 到 1 之间的数字。

对于 convert，它是消耗完药水后返回给玩家的物品格式（需 1.21+，可选）

YAML

food:
  eat-seconds: 0.25 # 已于 1.21.2 移除
  can-always-eat: true 
  nutrition: 5
  saturation: 0.5
  convert: # 已于 1.21.2 移除
    material: BREAD
  effects: # 已于 1.21.2 移除
    - 'SPEED, 100, 1, true, true, false, 0.5'

工具（1.21+）

YAML

tool:
  mining-speed: 1
  damage-per-block: 1
  rules:
    # 方块, 速度, 挖掘后是否掉落
    - 'stone, coal_ore, 1, true'
    # 可将方块替换为方块标签.

唱片机可播放（1.21+）

YAML

song: CAT
show-song: false

免疫火焰（1.20.5+）

YAML

fire-resistant: true

隐藏工具提示框（1.20.5+）

YAML

hide-tool-tip: true

无法破坏

YAML

unbreakable: true

稀有度（1.20.5+）

YAML

rarity: COMMON

标志

YAML

flags:
  - HIDE_ENCHANTS
  - HIDE_ATTRIBUTES
  - HIDE_UNBREAKABLE
  - HIDE_DESTROYS
  - HIDE_PLACED_ON
  - HIDE_ADDITIONAL_TOOLTIP
  - HIDE_DYE
  - HIDE_ARMOR_TRIM

附魔

配置部分的格式为：附魔 ID: 附魔等级

对于附魔书：你可能需要使用 stored-enchants 而非本选项。

对于自定义附魔：部分附魔插件未在游戏内注册其附魔，该功能可能无效。

你应当使用 Minecraft 原版的附魔 ID 而非 Spigot 在 1.20.5 之后提供的

YAML

enchants:
  MENDING: 1

发光（1.20.5+）

YAML

glow: true

自定义模型数据

YAML

custom-model-data: 15

属性

需要注意的是 1.20.5 修改了属性格式，如果你的物品是在 1.20.5 之前生成的，你需要将配置文件手动改为新格式。

配置部分的格式为属性 ID，且包含多个子选项。

YAML

attributes:
  GENERIC_ATTACK_DAMAGE: 
    name: generic.attack_damage 
    amount: 12
    operation: ADD_NUMBER # 可为 ADD_NUMBER, ADD_SCALAR, MULTIPLY_SCALAR_1
    slot: HAND

可损坏

代表物品是否有耐久值，或是能否磨损。

单次损坏值

YAML

damage: 5

最大损坏值（1.20.5+）

与最大耐久相似。

YAML

max-damage: 1500

附魔存储

这可以为物品指定其中存储的附魔，能够与其他工具在铁砧上结合。Material.ENCHANTED_BOOK 是存储附魔的示例。

存储附魔

与附魔相似。

YAML

stored-enchants:
  MENDING: 1

旗帜

图案

配置部分的格式为：图案 ID: 图案颜色。

YAML

patterns:
  BASE: WHITE

药水

代表可拥有自定义效果的药水或物品。

基本效果（1.20.5+）

YAML

base-effect: 'WATER'

基本效果（1.20.5 前）

格式：药水类型 ID, 是否延长, 是否升级

效果/自定义效果

格式：药水类型 ID, 持续时间, 倍率, 粒子效果淡色, 粒子效果显隐, 图标。

对于 粒子效果淡色、粒子效果显隐、图标，这些是布尔值标签。

YAML

effects:
  - 'SPEED, 100, 1, true, true, false'

颜色

颜色有两种格式：

R, G, B
一行数字（如 0xff0000）

YAML

color: '5'

盔甲

代表任何实体可装备的盔甲。

纹饰（1.20.5+）

配置文本格式拥有两个子选项。

YAML

trim:
  material: IRON
  pattern: TIDE

皮革盔甲

颜色

颜色有两种格式：

R, G, B
一行数字（如 0xff0000）

YAML

color: '5'

美西螈桶（1.17+）

颜色

可用值：LUCY、WILD、GOLD、CYAN、BLUE

YAML

color: LUCY

热带鱼桶（1.14+）

颜色

可用值：WHITE、ORANGE、MAGENTA、LIGHT_BLUE、YELLOW、LIME、PINK、GRAY、LIGHT_GRAY、CYAN、PURPLE、BLUE、BROWN、GREEN、RED、BLACK

YAML

color: WHITE

图案颜色

与上述的颜色相似。

YAML

pattern-color: WHITE

图案

可用值：KOB、SUNSTREAK、SNOOPER、DASHER、BRINELY、SPOTTY、FLOPPER、STRIPEY、GLITTER、BLOCKFISH、BETTY、CLAYFISH

头颅

支持两种格式：

Base64：如下所示，仅支持 1.16+
玩家名称：需要正版，支持所有版本。

YAML

skull: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvN2YzZmVkMTZmZDU1MTkwOWZhNWUyOWNkZDY5N2VlMzQ2ZTYzMzkwYjM4M2E0MzAwYTY2MmE4MGI2NGQ5ZWIxNyJ9fX0=

烟花

飞行时间

YAML

power: 1

效果

该部分配置下有多个子选项。

对于 type，可填入的值有：BALL、BALL_LARGE、STAR、BURST、CREEPER。

YAML

firework:
  1: 
    flicker: true
    trial: true
    colors:
      base:
        - 5
      fade:
        - 666666
    type: BALL

烟火之星

烟花效果

对于 type，可填入的值有：BALL、BALL_LARGE、STAR、BURST、CREEPER。

YAML

firework:
  flicker: true
  trial: true
  colors:
    base:
      - 5
    fade:
      - 666666
  type: BALL

迷之炖菜

效果

效果格式：药水类型 ID, 持续时间, 倍率, 粒子效果淡色, 粒子效果显隐, 图标。

YAML

effects:
  - 'SPEED, 100, 1, true, true, false'

收纳袋（1.17+）/潜影盒

内容物

配置部分格式为：槽位 ID、物品或物品格式。

可疑方块（1.20+）

内容物

可刷扫方块内的掉落物。如果你需要自定义可刷扫方块，你可以来这里看看我们的 CustomArcheology！

YAML

content:
  material: APPLE

刷怪笼

如果你想要刷怪笼中有实体，那么只需填入 spawner 选项。其他选项均为可选。

YAML

spawner: ZOMBIE
min-delay: 200
max-delay: 800
max-entities: 6
player-range: 16
spawn-range: 30

不详之瓶（1.20.5+）

等级

YAML

power: 3

乐器（1.18+）

音乐

YAML

music: PONDER_GOAT_HORN # 音乐

可修复

YAML

repair-cost: 15

可附魔

YAML

enchantable: 15

发光（1.21.2+）

YAML

glider: true

物品模型（1.21.2+）

YAML

item-model: 'mycustom:itemmodel'

提示框类型（1.21.2+）

YAML

tooltip-style: 'mycustom:tooltip'

使用冷却（1.21.2+）

YAML

use-cooldown:
  cooldown-group: 'minecraft:custom_weapon'
  cooldown-seconds: 1.5

可装备

YAML

equippable:
  entities: 
    - 'zombie' # 实体类型 ID
    - 'skeletons' # 实体类型标签
  dispensable: true
  swappable: true
  damage-on-hurt: true
  camera-overlay: misc/pumpkinblur
  sound: ambient.basalt_deltas.mood
  model: mycustomarmor
  slot: head

伤害免疫

YAML

damage-resistant: is_fall # 伤害类型标签

外部物品格式选项

部分额外的物品格式选项可以在兼容性章节找到。它们的目的是为了以物品格式兼容其他插件，这样它们就可以参与到物品生成的过程中。

当前支持的插件有：

MythicChanger
AdvancedEnchantments
NBTAPI

贡献者

SnowCutieOwO

页面历史

最后编辑于 28 天前

查看完整历史

📝 物品格式™

📝 物品格式™ ​

对接物品 ​

对接插件 ​

对接物品 ​

材料 ​

数量 ​

最低价/最高价 - 仅支持价格/物品 ​

物品属性组件（仅 1.21.5+，需要 Paper 系服务端） ​

自定义名称/显示名称 ​

物品名称（1.20.5+） ​

描述 ​

最大堆叠（1.20.5+） ​

食物（1.20.5+） ​

工具（1.21+） ​

唱片机可播放（1.21+） ​

免疫火焰（1.20.5+） ​

隐藏工具提示框（1.20.5+） ​

无法破坏 ​

稀有度（1.20.5+） ​

标志 ​

附魔 ​

发光（1.20.5+） ​

自定义模型数据 ​

属性 ​

可损坏 ​

单次损坏值 ​

最大损坏值（1.20.5+） ​

附魔存储 ​

存储附魔 ​

旗帜 ​

图案 ​

药水 ​

基本效果（1.20.5+） ​

基本效果（1.20.5 前） ​

效果/自定义效果 ​

颜色 ​

盔甲 ​

纹饰（1.20.5+） ​

皮革盔甲 ​

颜色 ​

美西螈桶（1.17+） ​

颜色 ​

热带鱼桶（1.14+） ​

颜色 ​

图案颜色 ​

图案 ​

头颅 ​

烟花 ​

飞行时间 ​

效果 ​

烟火之星 ​

烟花效果 ​

迷之炖菜 ​

效果 ​

收纳袋（1.17+）/潜影盒 ​

内容物 ​

可疑方块（1.20+） ​

内容物 ​

刷怪笼 ​

不详之瓶（1.20.5+） ​

等级 ​

乐器（1.18+） ​

音乐 ​

可修复 ​

可附魔 ​

发光（1.21.2+） ​

物品模型（1.21.2+） ​

提示框类型（1.21.2+） ​

使用冷却（1.21.2+） ​

可装备 ​

伤害免疫 ​

外部物品格式选项 ​

贡献者

页面历史

📝 物品格式™

对接物品

对接插件

对接物品

材料

数量

最低价/最高价 - 仅支持价格/物品

物品属性组件（仅 1.21.5+，需要 Paper 系服务端）

自定义名称/显示名称

物品名称（1.20.5+）

描述

最大堆叠（1.20.5+）

食物（1.20.5+）

工具（1.21+）

唱片机可播放（1.21+）

免疫火焰（1.20.5+）

隐藏工具提示框（1.20.5+）

无法破坏

稀有度（1.20.5+）

标志

附魔

发光（1.20.5+）

自定义模型数据

属性

可损坏

单次损坏值

最大损坏值（1.20.5+）

附魔存储

存储附魔

旗帜

图案

药水

基本效果（1.20.5+）

基本效果（1.20.5 前）

效果/自定义效果

颜色

盔甲

纹饰（1.20.5+）

皮革盔甲

颜色

美西螈桶（1.17+）

颜色

热带鱼桶（1.14+）

颜色

图案颜色

图案

头颅

烟花

飞行时间

效果

烟火之星

烟花效果

迷之炖菜

效果

收纳袋（1.17+）/潜影盒

内容物

可疑方块（1.20+）

内容物

刷怪笼

不详之瓶（1.20.5+）

等级

乐器（1.18+）

音乐

可修复

可附魔

发光（1.21.2+）

物品模型（1.21.2+）

提示框类型（1.21.2+）

使用冷却（1.21.2+）

可装备

伤害免疫

外部物品格式选项