Skip to content

(进阶)物品

物品创建的所有微妙之处

原版选项

组件(Components)

物品模板(ItemTemplate)

与格式刷类似,该功能允许你将模板物品的属性快速应用至其他物品。

模板物品配置:

YAML
template_item:
  template: true
  material: DIAMOND_SWORD
  ...

在你想要复制模板属性的物品配置中:

YAML
template_item1:
  template: template_item
  displayname: 模板物品 1

template_item2:
  template: template_item
  displayname: 模板物品 2
  material: CLOCK

自定义名称(Custom Name)

改变显示在提示框顶部的名称,即物品名称。

材料(Material)

允许你修改物品的类型。

YAML
my_item:
  material: WOODEN_SWORD

颜色(Color)

允许你修改某些物品(如皮革盔甲)的染色颜色。

YAML
my_item:
  color: 3, 252, 136 # 此为 RGB 颜色格式

描述(Lore)

允许你在物品名称下添加自定义描述。

YAML
my_item:
  lore:
  - "一行描述"
  - "<green>另一行描述"

注入 ID(injectID)

允许 Oraxen 识别物品,默认情况下设置为 true,且你不应调整这个设置。如果修改,则物品的机制就不再起效。

YAML
my_item:
  injectID: false

禁止附魔(Disable Enchanting)

该选项允许你阻止指定物品通过铁砧或附魔台附魔。

不影响通过配置文件施加的附魔。

YAML
my_item:
  disable_enchanting: true

隐藏物品(excludeFromInventory)

允许你将该物品在 Oraxen 的物品列表中隐藏。设置后它将不再在该界面中可见,但仍然可以通过 Oraxen 的给予命令获取。在应用至其他插件例如界面图标时非常有用。

YAML
  excludeFromInventory: true

耐久度(durability)

允许你修改物品的耐久度(不很有用)。

提示

在 Oraxen 1.174.0 之后的版本,所有低于 1.20.5 的服务器都不再使用该功能。 1.20.5+ 的服务器使用 max-durability 标签而非该设置。

YAML
my_item:
  durability: 10

不可损坏(unbreakable)

这会使物品不消耗任何耐久(真正意义上的无限耐久,通过原版 NBT 标签而非插件实现)

YAML
my_item:
  unbreakable: true

不可堆叠(Unstackable)

这会让物品无法堆叠。对诸如背包等独特物品的限制堆叠非常有用。

YAML
my_item:
  unstackable: true

物品标志(ItemFlags)

允许设置物品的标志(ItemFlags),所有可用的标志可在这里浏览。

YAML
my_item:
  ItemFlags:
    - HIDE_ENCHANTS
    - HIDE_ATTRIBUTES
    - HIDE_UNBREAKABLE
    - HIDE_DESTROYS
    - HIDE_PLACED_ON
    - HIDE_POTION_EFFECTS

药水效果(PotionEffects)

这允许你向你的药水类物品添加自定义药水效果。可以在这里浏览可用药水效果。

YAML
my_item:
  PotionEffects:
    # - type: 在这里获取完整效果列表: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/potion/PotionEffectType.html
    # - duration: 单位为刻
    # - amplifier: 药水效果等级
    # - ambient: true/false, 是否产生更多渐变的粒子效果
    # - particles: true/false, 是否显示粒子效果
    # - icon: true/false, 药水效果是否拥有图标
    - { type: WITHER,
        duration: 200,
        amplifier: 2,
        ambient: false,
        particles: true,
        icon: true }

属性修饰符(AttributeModifiers)

允许你向物品添加 Minecraft 原版的属性。它们非常强大,能够让你制作增加生命上限、提升玩家速度的物品。可以在这里获取完整的属性列表。

YAML
my_item:
  AttributeModifiers:
    # - attribute: 在这里获取完整列表: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/attribute/Attribute.html
    # - operations: 0 表示 ADD_NUMBER, 1 表示 ADD_SCALAR, 2 表示 MULTIPLY_SCALAR_1;
    # - slot: HAND, OFF_HAND, FEET, LEGS, CHEST 或 HEAD
    - {
       attribute: GENERIC_MOVEMENT_SPEED, 
       amount: 0.1, 
       operation: 0, 
       slot: HAND
      }

附魔(Enchantments)

若你想要为物品添加附魔(甚至是超出原版等级上限的附魔,如锋利 15),你可以试着编辑这部分配置。

YAML
my_item:
  Enchantments:
    protection: 4
    flame: 34
    sharpness: 18

下文为完整的原版可用附魔列表:

protection
fire_protection
feather_falling
blast_protection
projectile_protection
respiration
aqua_affinity
thorns
depth_strider
frost_walker
binding_curse
sharpness
smite
bane_of_arthropods
knockback
fire_aspect
looting
sweeping
efficiency
silk_touch
unbreaking
fortune
power
punch
flame
infinity
luck_of_the_sea
lure
loyalty
impaling
riptide
channeling
multishot
quick_charge
piercing
mending
vanishing_curse
soul_speed

如何指定自定义模型数据(Custom Model Data)?

YAML
my_item:
  Pack:
    generate_model: true
    parent_model: "custom/items/generated_elite"
    textures:
      - custom/items/elite_zombie_walk
    custom_model_data: 452

资源包设置

该部分有独立的章节,你可以在这里继续阅读。

机制选项

该部分有独立的章节。你可以在这里继续阅读。