配置与物品定义

主配置 (config.yml)

# EMC物品库 全局配置

# 插件前缀（支持颜色码）
prefix: "&8[&6EMC物品库&8] "

# 调试模式（输出更多日志信息）
debug: false

# 物品源优先级（未指定来源时按此顺序搜索）
# 可以调整顺序来改变默认搜索优先级
source-priority:
  - config
  - mythicmobs
  - mmoitems
  - neigeitems
  - itemsadder
  - oraxen
  - executableitems
  - ecoitems
  - sxitem

# 启用的物品源（设为false可禁用某个物品源）
enabled-sources:
  config: true
  mythicmobs: true
  mmoitems: true
  neigeitems: true
  itemsadder: true
  oraxen: true
  executableitems: true
  ecoitems: true
  sxitem: true

参数说明

参数	说明
prefix	插件消息前缀，支持 & 颜色码
debug	调试模式，启用后输出更多日志
source-priority	物品源搜索优先级，当使用不带来源前缀的物品 ID 时，按此列表顺序依次查找
enabled-sources	各物品源开关，设为 false 可禁用某个来源（即使对应插件已安装）

物品定义文件

自定义物品配置位于 plugins/EMC物品库/items/ 目录下，支持多个 .yml 文件，每个文件中可定义多个物品。

文件结构

plugins/EMC物品库/
├── config.yml
└── items/
    ├── example.yml      ← 示例（首次启动自动生成）
    ├── weapons.yml      ← 自定义：武器类
    ├── armor.yml        ← 自定义：装备类
    └── consumables.yml  ← 自定义：消耗品类

每个 YAML 文件中的顶级键即为物品 ID，使用 config:<物品ID> 引用。

支持的属性

属性	类型	说明
material	字符串	材质名（跨版本兼容，自动转换）
data	整数	数据值（仅 1.12.2 及以下有效）
name	字符串	显示名称，支持 & 颜色码和 &#RRGGBB 十六进制颜色
lore	列表	描述文本列表
enchantments	键值对	附魔（跨版本兼容附魔名）
item-flags	列表	物品标志（如 HIDE_ENCHANTS）
unbreakable	布尔	是否不可破坏（跨版本兼容）
custom-model-data	整数	自定义模型数据（1.14+）
color	字符串	皮革装备颜色（#RRGGBB 或 R,G,B）
potion-effects	列表	药水效果
skull-owner	字符串	头颅皮肤（玩家名）

完整示例

# 传说武器
example_sword:
  material: DIAMOND_SWORD
  name: "&b&l示例钻石剑"
  lore:
    - "&7这是一把示例钻石剑"
    - "&7由 EMC物品库 创建"
    - ""
    - "&e品质: &6传说"
  enchantments:
    SHARPNESS: 5
    UNBREAKING: 3
    FIRE_ASPECT: 2
  item-flags:
    - HIDE_ENCHANTS
  unbreakable: true

# 装备
example_helmet:
  material: DIAMOND_HELMET
  name: "&d&l示例头盔"
  lore:
    - "&7一顶坚固的头盔"
  enchantments:
    PROTECTION: 4
    UNBREAKING: 3
  unbreakable: true

# 染色皮革装备
example_leather:
  material: LEATHER_CHESTPLATE
  name: "&c&l红色皮甲"
  lore:
    - "&7一件染色的皮革胸甲"
  color: "#FF3333"
  unbreakable: true

# 自定义药水
example_potion:
  material: POTION
  name: "&a&l强力治疗药水"
  lore:
    - "&7饮用后恢复大量生命"
  potion-effects:
    - type: HEAL
      amplifier: 1
    - type: REGENERATION
      duration: 200
      amplifier: 1

药水效果格式

potion-effects:
  - type: HEAL           # 药水效果类型
    amplifier: 1          # 等级（0=I级, 1=II级）
  - type: REGENERATION
    duration: 200         # 持续时间（tick，20tick=1秒）
    amplifier: 1

颜色格式

皮革装备的 color 字段支持两种格式：

# 十六进制格式
color: "#FF3333"

# RGB 格式
color: "255,51,51"

物品标志

可用的 item-flags 值：

标志	说明
HIDE_ENCHANTS	隐藏附魔信息
HIDE_ATTRIBUTES	隐藏属性修饰符
HIDE_UNBREAKABLE	隐藏"不可破坏"标签
HIDE_DESTROYS	隐藏"可破坏"信息
HIDE_PLACED_ON	隐藏"可放置在"信息
HIDE_POTION_EFFECTS	隐藏药水效果

跨版本材质名

插件内置材质兼容层，自动转换 1.12 与 1.13+ 之间的材质名差异。以下为部分常用映射：

旧名称 (1.12-)	新名称 (1.13+)
WOOD_SWORD	WOODEN_SWORD
GOLD_SWORD	GOLDEN_SWORD
GOLD_HELMET	GOLDEN_HELMET
SULPHUR	GUNPOWDER
WATCH	CLOCK
EXP_BOTTLE	EXPERIENCE_BOTTLE
INK_SACK	INK_SAC
LOG	OAK_LOG
WOOD	OAK_PLANKS
WORKBENCH	CRAFTING_TABLE

配置中使用任意一方的名称均可，插件自动识别并转换。

跨版本附魔名

同样，附魔名也支持任意版本写法：

通用名	旧名称	新名称
SHARPNESS	DAMAGE_ALL	SHARPNESS
PROTECTION	PROTECTION_ENVIRONMENTAL	PROTECTION
EFFICIENCY	DIG_SPEED	EFFICIENCY
UNBREAKING	DURABILITY	UNBREAKING
FORTUNE	LOOT_BONUS_BLOCKS	FORTUNE
POWER	ARROW_DAMAGE	POWER
INFINITY	ARROW_INFINITE	INFINITY
LOOTING	LOOT_BONUS_MOBS	LOOTING