跳到主要内容

物品字段总表

这一页列出物品文件里每一个可以写的字段。所有字段都可以省略，省略时的行为和 MMOItems 相同（见「未填时」一栏）。

三个规则先记住
  1. 文件是 items/<类型小写>.yml，例如长剑写在 items/long_sword.yml；类型 ID 见 物品类型与阶级。
  2. 物品可以直接写在文件最外层，也可以放在 物品: 下面，两种都行。
  3. 物品 ID 只能用英文、数字、_、-，例如 BLOOD_CROWN、'1'。

中文键与英文键可以任选，详见 中英配置。表中「是 / 否」字段也接受 true / false。

基本​

中文键英文键类型未填时说明
名称name文字原版物品名称支持 MiniMessage（<gradient:#E8DDD0:#D41438>…</gradient>、&l）与 &e、&#55FFAA 色码
材质materialMaterialDIAMOND_SWORD原版物品 ID，例如 IRON_SWORD、BOW、PLAYER_HEAD
类型type类型 ID文件名对应的类型一般不用写；写了必须与所在文件一致
版本revision整数1编辑器每次保存自动 +1；手动修改后 /ci reload 也会刷新玩家手上的物品外观
tiertier文字无tier.yml 里的阶级 ID（默认 1 精良、2 稀有、3 史诗、4 传说），显示在 Lore 的 #tier# 位置
Lorelore文字列表无物品说明，只用于显示，不会产生属性
Lore排列lore-layout列表使用 lore-format.yml单件物品自定义区块顺序，例如 ['{属性}', '{技能}', '{说明}']

外观与原版设定​

中文键英文键类型未填时说明
自订模型数值custom-model-data整数不设置资源包模型编号，例如 10001
物品模型modelnamespace:id不设置1.21.4+ 的 item model，例如 minecraft:diamond_sword；ItemsAdder 4 与新版资源包多半用这个
自订模型字串custom-model-strings文字清单不设置1.21.4+ custom model data 的字串，例如 [star_breaker]
自订模型浮点custom-model-floats数字清单不设置1.21.4+ custom model data 的浮点数
装备外观equippable-modelnamespace:id不设置1.21.2+ 盔甲穿在身上的材质（equippable asset），例如 myitems:star
提示框样式tooltip-stylenamespace:id不设置1.21.2+ 物品提示框的样式
隐藏提示框hide-tooltip是／否否整个物品提示框不显示
IA模型itemsaddernamespace:id不设置ItemsAdder 物品外观，例如 cloud:moon_blade（也可写 ItemsAdder模型）
CE模型craftenginenamespace:id不设置CraftEngine 物品外观，例如 cloud:moon_blade（也可写 CraftEngine模型）；与 IA模型 择一
头颅材质.valueskull-texture.valueBase64不设置材质: PLAYER_HEAD 时的皮肤纹理
染色dye-color'R G B' 或 '#RRGGBB'不设置皮革装备与药水的颜色，例如 '125 0 255'
盔甲纹饰armor-trim材料:图案不设置盔甲纹饰，例如 netherite:silence（原版纹饰材料与图案 ID）
类型显示displayed-type文字类型名称Lore 类型行改显示这段文字，例如 '&cSharp Dagger'
套装set套装 ID不设置加入 item-sets.yml 的套装，见 套装
无法破坏unbreakable是 / 否否停用耐久损耗
最大堆叠max-stack-size1 – 99原版1.20.5+ 生效
耐久上限max-item-damage正整数原版1.20.5+ 生效，材质必须有耐久
附魔enchants附魔: 等级无{锋利: 5, 耐久: 3}；中文名、原版 ID、EcoEnchants ID 都可以，等级 1 – 255
隐藏附魔hide-enchants是 / 否否只隐藏附魔文字，光效与效果保留
隐藏标记item-flags列表无HIDE_ATTRIBUTES,HIDE_UNBREAKABLE 等，逗号或列表皆可
保留原版属性keep-vanilla-attributes是 / 否否否 = 与 MMOItems 相同：隐藏并移除材质原本的攻击 / 护甲属性；是 = 保留并叠加

可用的 隐藏标记：HIDE_ENCHANTS、HIDE_ATTRIBUTES、HIDE_UNBREAKABLE、HIDE_DESTROYS、HIDE_PLACED_ON、HIDE_ADDITIONAL_TOOLTIP、HIDE_DYE、HIDE_ARMOR_TRIM、HIDE_STORED_ENCHANTS（以服务器版本支持的为准，写错会在载入警告中提示）。

属性​

中文键英文键类型说明
属性stats区块每一行一个属性；键可以写属性 ID、中文名或别名
物品等级item-level整数只用于正态分布写法的 每级增加

三种写法：

属性:
  暴击机率: 5                                             # 固定值
  攻击伤害: {最小值: 10, 最大值: 15, 小数位数: 1}          # 均匀随机
  生命力: {基础值: 100, 每级增加: 5, 浮动标准差: 8, 最大浮动比例: 0.3}  # 正态分布

全部 155 项属性与每种写法的细节见 属性。

技能​

中文键英文键类型未填时说明
技能.<触发>.技能IDskills.<trigger>.skill技能 ID无MythicLib 已注册的技能
技能.<触发>.参数skills.<trigger>.params参数: 数值技能默认值{damage: 20, cooldown: 5, mana: 10}
攻击模式attack-mode模式名原版仅法杖类（STAFF、GREATSTAFF、WAND、STAVE 及其子类型），见 攻击模式
普攻魔力消耗attack-mana-cost数值0法杖普攻每次消耗的 MMOCore 魔力

触发：左键、右键、蹲下左键、蹲下右键、攻击命中、长按蹲下、双击蹲下，以及 受击、击杀生物、定时 等与 MMOItems 相同的被动触发，共 32 种；中文（简繁）、英文键、MythicLib 名称都能写。完整列表见 技能与攻击模式。

行为限制​

全部默认「否」，与 MMOItems 相同。

中文键英文键作用
禁止附魔disable-enchanting禁止附魔台与铁砧新增 / 提升附魔（配置里的附魔保留）
禁止附魔台disable-enchant-table只禁止附魔台，铁砧仍可附魔
禁止铁砧disable-anvil禁止铁砧改名、修理、合并
禁止砂轮disable-grindstone禁止砂轮移除附魔与修理
禁止锻造台disable-smithing禁止原版锻造台升级与纹饰（不影响 CI 锻造站）
禁止丢弃disable-drop禁止玩家主动丢出（不改变死亡掉落）
禁止放置disable-place禁止放置成方块、船、矿车、盔甲架、挂饰
禁止原版合成disable-crafting不能作为原版合成材料（含自动合成器；不影响 CI 配方）
禁止原版修理disable-repair阻挡铁砧、砂轮、合成格修理（不含经验修补）
禁止命中被动disable-on-hit-skills停用这件物品的「攻击命中」技能

使用限制​

中文键英文键平铺写法（中 / 英）说明
限制.MMOCore等级restrictions.level等级限制 / required-level最低等级，0 为不限（需要 MMOCore）
限制.MMOCore最高等级restrictions.max-level最高等级限制 / required-max-level最高等级，不可低于最低等级
限制.MMOCore职业restrictions.classes职业限制 / required-class职业 ID，逗号分隔，留空不限
限制.装备部位restrictions.slots装备部位 / equip-slots主手、副手、头部、胸部、腿部、脚部（或 MAIN_HAND…FEET）
限制.权限restrictions.permission—使用权限节点，例如 items.legendary

平铺写法与区块写法等价，只能择一；两边都写且数值不同会被拒绝载入。详见 限制。

养成：强化、宝石孔、词缀​

中文键英文键平铺写法（中 / 英）说明
养成.宝石孔growth.gem-sockets宝石槽 / gem-sockets物理伤害宝石槽x4,万用x1 或数字 2（= 2 个万用孔），最多 8
养成.强化方案growth.upgrade-scheme强化方案 / upgrade-schemeprogression.yml 的方案 ID；武器省略时用默认武器方案
养成.词缀池growth.affix-pool词缀池 / affix-poolprogression.yml 的词缀池 ID
养成.词缀数量growth.affix-count词缀数量 / affix-count0 – 8，生成时抽取
养成.词缀growth.affixes词缀从多个词缀池抽：池: {最少, 最多, 机率}，见 词缀
最大强化max-upgrade—覆盖方案的最高等级；0 = 不可强化
强化.强化机率upgrade.chance—强化站成功率，例如 10%
强化.强化素材upgrade.materials—type:id*数量;diamond*50 或区块
强化.强化条件upgrade.conditions—level=0;money=200

宝石​

中文键英文键类型未填时说明
宝石.启用gem.enabled是 / 否否这件物品是宝石
宝石.类别gem.category文字未分类必须和装备 宝石孔 的类别一致（或装备孔为 万用）
宝石.唯一群组gem.unique-group文字无同一件装备不能镶两颗同群组的宝石
宝石.成功率gem.success-rate0 – 100100失败时宝石消耗，装备与既有宝石保留

宝石的 属性 就是镶嵌后加到装备上的数值。详见 宝石 · 词缀 · 强化。

消耗品​

只有行为为「消耗品」的类型（CONSUMABLE 及其子类型）会读取。

中文键英文键类型未填时说明
使用.恢复生命consumable.heal数值0恢复生命
使用.恢复饱食consumable.food0 – 200恢复饱食度
使用.恢复饱和consumable.saturation0 – 200恢复饱和度
使用.消耗数量consumable.amount1 – 641每次使用消耗几个
使用.冷却秒consumable.cooldown秒0冷却
使用.冷却群组consumable.cooldown-group文字物品 ID同群组共用冷却
使用.指令consumable.commands列表无{执行者: 控制台, 内容: 'say {player}'}
使用.音效consumable.sounds列表无{名称: 'minecraft:entity.player.levelup', 音量: 1, 音高: 1.2}
使用.药水效果consumable.potion-effects区块无{speed: {秒数: 10, 等级: 2}}

详见 消耗品。

评分与回收​

中文键英文键类型未填时说明
评分.显示score.visible是 / 否自动是 = 强制显示；否 = 隐藏；不写 = 零分、材料、消耗品自动隐藏
评分.基础分score.base数值0额外基础分（没有战斗属性的材料可以用它定价）
评分.倍率score.scale数值1评分倍率
回收.允许sell.allowed是 / 否是否 = 不能在 /ci sell 卖出
回收.倍率sell.scale数值1回收价 = 评分 × 此倍率；0 表示没有回收价值

详见 评分与回收。

其他​

中文键英文键类型说明
常驻药水permanent-effects效果: 等级主手持有（或装在饰品栏）且满足使用限制时持续获得，例如 {speed: 1, night_vision: 1}；效果 ID 用原版英文，等级 1 – 255

完整示例​

下面这件物品用到了绝大多数字段。中文键与英文键两份内容完全等价。

items/long_sword.yml
BLOOD_CROWN:
  名称: <gradient:#E8DDD0:#D41438>噬渊 · 血冕</gradient>
  材质: DIAMOND_SWORD
  版本: 1
  tier: 3
  自订模型数值: 10001
  无法破坏: true
  最大堆叠: 1
  附魔: {锋利: 5}
  隐藏附魔: 是
  隐藏标记: HIDE_ATTRIBUTES,HIDE_UNBREAKABLE
  禁止原版修理: 是
  禁止铁砧: 是
  等级限制: 10
  职业限制: WARRIOR,PALADIN
  装备部位: 主手
  属性:
    攻击伤害: {最小值: 10, 最大值: 15, 小数位数: 1}
    暴击机率: 5
    雷击机率: 12
    雷击伤害: 30
    雷击冷却: 2
  技能:
    蹲下右键:
      技能ID: FIREBOLT
      参数: {damage: 20, cooldown: 5}
  最大强化: 10
  强化方案: 通用武器强化
  宝石槽: 物理伤害宝石槽x4,万用x1
  词缀池: 基础词缀
  词缀数量: 1
  评分: {基础分: 0, 倍率: 1}
  回收: {允许: 否, 倍率: 1}
  Lore:
    - <gradient:#C9C3FF:#A9B7FF>此剑铸於无月之夜，以陨星碎铁为骨
    - <gradient:#C9C3FF:#A9B7FF>剑身流淌着星河之光，如月华凝而不散
方案、词缀池、宝石类别的名称

通用武器强化、基础词缀、物理伤害宝石槽 这类是你在 progression.yml 与宝石物品里自己取的名字，不是键，所以英文配置里照写原本的名字即可。

最后于 更新