终极自定义装备

终极自定义装备

终极自定义装备让服务器管理员和整合包制作者能够通过简单的JSON文件向Minecraft添加完全自定义的内容。无需编程,支持热重载,并且会在服务器与客户端之间自动进行验证。

UltimateCustomGear

UltimateCustomGear 是一个数据驱动的 NeoForge 模组,适用于 Minecraft 1.21.1,允许服务器管理员、整合包作者和玩家通过简单的 JSON 文件添加完全自定义的盔甲套装、武器、工具、食物、物品、方块和流体——无需编程。


功能

内容创建

  • 盔甲套装:每个部件拥有独立的属性(耐久度、防御、韧性、击退抗性)
  • 武器:剑、弓、弩和盾牌,支持自定义伤害、耐久度和蓄力速度
  • 工具:镐、斧、锹和锄,支持挖掘速度、采掘等级和范围耕地
  • 食物:支持营养值、饱和度、食用速度和食用后效果
  • 方块:可设置方向和重力影响,支持六面纹理、光照、声音和挖掘需求
  • 流体:支持自定义颜色、接触效果和燃烧行为

效果与游戏机制

  • 手持效果、单件效果和全套加成
  • 生物掉落:任意物品均可通过可配置的概率、数量和实体过滤器从生物掉落(热重载:即时平衡经济)
  • fire_resistant 物品:可像下界合金一样抵御火焰和岩浆——适用于物品、食物、装备、方块和桶
  • 透明盔甲:拥有完整属性和效果但不在身体上显示任何内容的盔甲
  • 伤害抗性:通过伤害类型、攻击者或两者结合,提供三层伤害减免(热重载)

纹理与模型

  • 引用原版/模组纹理,或提供自定义 PNG 文件
  • 支持方块六面纹理、弓拉弦动画、自定义盔甲层
  • 通过 GeckoLib 实现 3D 盔甲模型:使用 Blockbench 模型,支持可选动画,替代扁平盔甲层(可选依赖:无此模组时,盔甲降级为 2D 层)

配方与标签

  • 原生配方系统:支持有序、无序、熔炼、高炉和锻造,在 JSON 中定义
  • 配方原料支持标签("#minecraft:planks" = 任意木板,包括来自其他模组的物品)
  • 内容可通过 tags 字段归属到标签,使其能被其他模组的配方使用

服务器与多人游戏

  • 内容包:将所有内容打包为单个 .zip 文件,玩家放入 packs/ 文件夹即可
  • 多人游戏内容验证:服务器在登录时检查客户端是否拥有匹配的文件,并可配置强制执行
  • /customgear reload:无需重启即可更新名称、效果、配方和掉落物

生活质量

  • 每个物品支持完整的多语言
  • 信息丰富的工具提示(效果、套装加成、挖掘等级、生物掉落)
  • 清晰的验证错误信息,指明文件名和具体问题

安装

  1. 下载并安装 NeoForge 1.21.1
  2. 将 ultimatecustomgear-1.x.x.jar 放入你的 mods/ 文件夹
  3. 启动一次游戏,以在 .minecraft/ 中生成 ultimatecustomgear/ 文件夹
  4. 将你的 JSON 文件添加到 .minecraft/ultimatecustomgear/——或将一个内容 .zip 文件放入 .minecraft/ultimatecustomgear/packs/(参见下方的内容包)
  5. 重启游戏

JSON 语法说明: 标准 JSON 不允许尾部逗号。在对象或数组的最后一个元素后添加尾部逗号会导致该文件在加载时被静默跳过。


JSON 文件结构

所有 JSON 文件都放在 .minecraft/ultimatecustomgear/ 内。每个文件定义一个物品、套装、方块或流体。文件可以按你喜欢的任何子文件夹结构组织。

内容也可以打包成 packs/ 内的 .zip 文件——参见内容包部分。

支持的类型

类型 描述
armor_set 完整盔甲套装(头盔、胸甲、护腿、靴子)
tool_set 完整工具套装(镐、斧、锹、锄)
weapon_set 完整武器套装(剑、弓、弩、盾牌)
sword 单独的剑
bow 单独的弓
crossbow 单独的弩
shield 单独的盾牌
pickaxe 单独的镐
axe 单独的斧
shovel 单独的锹
hoe 单独的锄
food 可消耗的食物物品
item 简单的非消耗品
block 方块,支持可选的六面纹理和定向放置
fluid 流体,带桶、可配置的扩散和接触效果

JSON 示例

食物物品 — 完整示例

{
  "id": "magic_apple",
  "type": "food",
  "names": {
    "en_us": "Magic Apple",
    "es_mx": "Manzana Mágica"
  },
  "nutrition": 4,
  "saturation": 1.2,
  "always_edible": true,
  "fire_resistant": true,
  "mob_drops": {
    "entities": ["minecraft:zombie", "#minecraft:undead"],
    "chance": 0.15,
    "min": 1,
    "max": 2
  },
  "on_eat_effects": [
    { "effect": "minecraft:regeneration",    "amplifier": 1, "duration": 10,  "probability": 1.0 },
    { "effect": "minecraft:absorption",      "amplifier": 0, "duration": 120, "probability": 1.0 },
    { "effect": "minecraft:fire_resistance", "amplifier": 0, "duration": 30,  "probability": 1.0 },
    { "effect": "minecraft:resistance",      "amplifier": 0, "duration": 300, "probability": 1.0 }
  ],
  "texture": {
    "mode": "reference",
    "refs": { "item": "minecraft:item/golden_apple" }
  },
  "recipe": {
    "type": "shaped",
    "pattern": ["GGG","GAG","GGG"],
    "key": { "G": "minecraft:gold_block", "A": "minecraft:apple" }
  }
}

此物品掉落后可抵御火焰和岩浆,且僵尸和其他亡灵生物死亡时有 15% 的几率掉落 1-2 个此物品。

也支持即时食物(eat_duration: 0)和缓慢食物(eat_duration: 10 = 10 秒)。

盔甲套装 — 完整示例

{
  "id": "my_armor",
  "type": "armor_set",
  "piece_names": {
    "en_us": {
      "helmet":     "My Armor Helmet",
      "chestplate": "My Armor Chestplate",
      "leggings":   "My Armor Leggings",
      "boots":      "My Armor Boots"
    },
    "es_mx": {
      "helmet":     "Casco de Mi Armadura",
      "chestplate": "Pechera de Mi Armadura",
      "leggings":   "Pantalones de Mi Armadura",
      "boots":      "Botas de Mi Armadura"
    }
  },
  "pieces": {
    "helmet":     { "durability": 363, "defense": 3, "toughness": 1.0, "knockback_resistance": 0.0 },
    "chestplate": { "durability": 528, "defense": 8, "toughness": 2.0, "knockback_resistance": 0.1 },
    "leggings":   { "durability": 495, "defense": 6, "toughness": 1.5, "knockback_resistance": 0.1 },
    "boots":      { "durability": 429, "defense": 3, "toughness": 1.0, "knockback_resistance": 0.0 }
  },
  "enchantable": true,
  "enchantability": 15,
  "piece_effects": {
    "helmet": [ { "effect": "minecraft:night_vision", "amplifier": 0 } ],
    "boots":  [ { "effect": "minecraft:jump_boost",   "amplifier": 0 } ]
  },
  "set_bonus": {
    "required_pieces": 4,
    "effects": [
      { "effect": "minecraft:strength",   "amplifier": 1 },
      { "effect": "minecraft:resistance", "amplifier": 0 }
    ]
  },
  "texture": {
    "mode": "reference",
    "refs": {
      "helmet":     "minecraft:item/diamond_helmet",
      "chestplate": "minecraft:item/diamond_chestplate",
      "leggings":   "minecraft:item/diamond_leggings",
      "boots":      "minecraft:item/diamond_boots"
    },
    "armor_layers": {
      "layer_1": "minecraft:models/armor/diamond_layer_1",
      "layer_2": "minecraft:models/armor/diamond_layer_2"
    }
  },
  "recipes": {
    "helmet":     { "type": "shaped", "pattern": ["GGG","G G","   "], "key": {"G": "mymod:my_gem"} },
    "chestplate": { "type": "shaped", "pattern": ["G G","GGG","GGG"], "key": {"G": "mymod:my_gem"} },
    "leggings":   { "type": "shaped", "pattern": ["GGG","G G","G G"], "key": {"G": "mymod:my_gem"} },
    "boots":      { "type": "shaped", "pattern": ["   ","G G","G G"], "key": {"G": "mymod:my_gem"} }
  }
}

带有 3D 模型和抗性的盔甲套装 — 完整示例

{
  "id": "dragonslayer_armor",
  "type": "armor_set",
  "piece_names": {
    "en_us": {
      "helmet":     "Dragonslayer Helm",
      "chestplate": "Dragonslayer Cuirass",
      "leggings":   "Dragonslayer Greaves",
      "boots":      "Dragonslayer Sabatons"
    }
  },
  "pieces": {
    "helmet":     { "durability": 407, "defense": 3, "toughness": 3.0, "knockback_resistance": 0.1 },
    "chestplate": { "durability": 592, "defense": 8, "toughness": 3.0, "knockback_resistance": 0.1 },
    "leggings":   { "durability": 555, "defense": 6, "toughness": 3.0, "knockback_resistance": 0.1 },
    "boots":      {
      "durability": 481, "defense": 3, "toughness": 3.0, "knockback_resistance": 0.1,
      "damage_resistances": { "#minecraft:is_fall": 0.25 }
    }
  },
  "damage_resistances": {
    "#minecraft:is_fire": 0.125,
    "#minecraft:is_projectile": 0.0625
  },
  "attacker_resistances": {
    "#minecraft:undead": 0.10,
    "minecraft:ender_dragon": 0.15
  },
  "conditional_resistances": [
    { "attacker": "minecraft:blaze", "damage": "#minecraft:is_fire", "amount": 0.20 }
  ],
  "show_player_resistances": false,
  "enchantable": true,
  "enchantability": 15,
  "set_bonus": {
    "required_pieces": 4,
    "effects": [ { "effect": "minecraft:fire_resistance", "amplifier": 0 } ]
  },
  "texture": {
    "mode": "custom",
    "refs": {
      "helmet":     "armor/textures/item/dragonslayer_helmet.png",
      "chestplate": "armor/textures/item/dragonslayer_chestplate.png",
      "leggings":   "armor/textures/item/dragonslayer_leggings.png",
      "boots":      "armor/textures/item/dragonslayer_boots.png"
    },
    "armor_layers": {
      "layer_1": "transparent",
      "layer_2": "transparent"
    },
    "armor_3d": {
      "model":     "armor/geo/dragonslayer.geo.json",
      "texture":   "armor/textures/armor/dragonslayer_3d.png",
      "animation": "armor/geo/dragonslayer.animation.json"
    }
  }
}

此示例展示了什么:

  • armor_3d 将四个部件转换为 GeckoLib 模型。refs 仍然指向平面 PNG——这些是物品栏图标,始终是 2D 的。
  • armor_layers: "transparent" 在这里是故意的降级方案:在没有 GeckoLib 的实例上,盔甲不显示任何内容,而不是降级为原版铁质层,这对这套盔甲来说会显得很奇怪。
  • 套装级别的抗性是按部件计算的:四个部件的 0.125 火焰抗性在穿齐全套时是 50%,而 0.0625 弹射物抗性是 25%。
  • 靴子额外添加了自己的 damage_resistances。部件的条目会与套装级别的条目合并:靴子仍然会获得火焰和弹射物减免,加上自己的摔落条目。一个部件只会覆盖它声明的特定键。
  • 条件规则 优先于更通用的火焰条目:烈焰人的火焰攻击每个部件减少 20%(穿齐全套时为 80%),而不是 12.5%,因为 conditional 的优先级高于 damage。
  • 套装加成和抗性独立叠加:火焰抗性效果首先应用,然后任何幸存下来的伤害再被盔甲减少。

除了基础属性外,一切都是可热重载的。添加或移除 armor_3d 块需要重启。

工具套装 — 完整示例

注意: tool_set 只支持 pickaxe、axe、shovel 和 hoe。要在工具旁边添加剑,请使用单独的 weapon_set 或单独的 sword 文件。

{
  "id": "my_tools",
  "type": "tool_set",
  "tool_names": {
    "en_us": {
      "pickaxe": "My Pickaxe",
      "axe":     "My Axe",
      "shovel":  "My Shovel",
      "hoe":     "My Hoe"
    },
    "es_mx": {
      "pickaxe": "Mi Pico",
      "axe":     "Mi Hacha",
      "shovel":  "Mi Pala",
      "hoe":     "Mi Azada"
    }
  },
  "tools": {
    "pickaxe": {
      "durability": 8000,
      "attack_damage": 5.0,
      "attack_speed": 1.2,
      "mining_speed": 20.0,
      "harvest_level": 4,
      "held_effects": [ { "effect": "minecraft:haste", "amplifier": 1 } ]
    },
    "axe": {
      "durability": 7000,
      "attack_damage": 8.0,
      "attack_speed": 0.9,
      "mining_speed": 15.0,
      "harvest_level": 4
    },
    "shovel": {
      "durability": 6000,
      "attack_damage": 4.0,
      "attack_speed": 1.0,
      "mining_speed": 18.0,
      "harvest_level": 4
    },
    "hoe": {
      "durability": 5000,
      "attack_damage": 3.0,
      "attack_speed": 1.0,
      "mining_speed": 16.0,
      "harvest_level": 4,
      "till_radius": 3
    }
  },
  "enchantable": true,
  "enchantability": 22,
  "texture": {
    "mode": "reference",
    "refs": {
      "pickaxe": "minecraft:item/netherite_pickaxe",
      "axe":     "minecraft:item/netherite_axe",
      "shovel":  "minecraft:item/netherite_shovel",
      "hoe":     "minecraft:item/netherite_hoe"
    }
  },
  "recipes": {
    "pickaxe": { "type": "smithing_transform", "template": "minecraft:netherite_upgrade_smithing_template", "base": "mymod:my_diamond_pickaxe",  "addition": "minecraft:netherite_ingot" },
    "axe":     { "type": "smithing_transform", "template": "minecraft:netherite_upgrade_smithing_template", "base": "mymod:my_diamond_axe",     "addition": "minecraft:netherite_ingot" },
    "shovel":  { "type": "smithing_transform", "template": "minecraft:netherite_upgrade_smithing_template", "base": "mymod:my_diamond_shovel",  "addition": "minecraft:netherite_ingot" },
    "hoe":     { "type": "smithing_transform", "template": "minecraft:netherite_upgrade_smithing_template", "base": "mymod:my_diamond_hoe",     "addition": "minecraft:netherite_ingot" }
  }
}

武器套装 — 完整示例

{
  "id": "my_weapons",
  "type": "weapon_set",
  "weapon_names": {
    "en_us": {
      "sword":    "My Sword",
      "bow":      "My Bow",
      "crossbow": "My Crossbow",
      "shield":   "My Shield"
    },
    "es_mx": {
      "sword":    "Mi Espada",
      "bow":      "Mi Arco",
      "crossbow": "Mi Ballesta",
      "shield":   "Mi Escudo"
    }
  },
  "weapons": {
    "sword": {
      "durability": 2031,
      "attack_damage": 8.0,
      "attack_speed": 1.6,
      "held_effects": [ { "effect": "minecraft:strength", "amplifier": 1 } ]
    },
    "bow": {
      "durability": 384,
      "arrow_damage": 8.0,
      "arrow_damage_bonus": 2.0,
      "arrow_damage_multiplier": 1.3,
      "charge_speed": 1.0
    },
    "crossbow": {
      "durability": 465,
      "arrow_damage": 11.0,
      "arrow_damage_multiplier": 1.5,
      "charge_speed": 1.0
    },
    "shield": { "durability": 336 }
  },
  "enchantable": true,
  "enchantability": 15,
  "texture": {
    "mode": "reference",
    "refs": {
      "sword":    "minecraft:item/netherite_sword",
      "bow":      "minecraft:item/bow",
      "crossbow": "minecraft:item/crossbow",
      "shield":   "minecraft:item/shield"
    }
  },
  "recipes": {
    "sword": { "type": "smithing_transform", "template": "minecraft:netherite_upgrade_smithing_template", "base": "mymod:my_diamond_sword", "addition": "minecraft:netherite_ingot" }
  }
}

单独的剑 — 完整示例

{
  "id": "my_sword",
  "type": "sword",
  "names": {
    "en_us": "My Custom Sword",
    "es_mx": "Mi Espada Personalizada"
  },
  "durability": 1561,
  "attack_damage": 8.0,
  "attack_damage_bonus": 0.0,
  "attack_speed": 1.6,
  "enchantable": true,
  "enchantability": 15,
  "held_effects": [ { "effect": "minecraft:strength", "amplifier": 1 } ],
  "texture": {
    "mode": "reference",
    "refs": { "sword": "minecraft:item/diamond_sword" }
  },
  "recipe": {
    "type": "shaped",
    "pattern": [" G ", " G ", " S "],
    "key": { "G": "mymod:my_gem", "S": "minecraft:stick" }
  }
}

单独的弓 — 完整示例

{
  "id": "my_bow",
  "type": "bow",
  "names": {
    "en_us": "My Custom Bow",
    "es_mx": "Mi Arco Personalizado"
  },
  "durability": 600,
  "arrow_damage": 10.0,
  "arrow_damage_bonus": 1.0,
  "arrow_damage_multiplier": 1.2,
  "charge_speed": 1.0,
  "enchantable": true,
  "enchantability": 15,
  "texture": {
    "mode": "reference",
    "refs": { "bow": "minecraft:item/bow" }
  },
  "recipe": {
    "type": "shaped",
    "pattern": [" GT", "G T", " GT"],
    "key": { "G": "mymod:my_gem", "T": "minecraft:string" }
  }
}

单独的弩 — 完整示例

{
  "id": "my_crossbow",
  "type": "crossbow",
  "names": {
    "en_us": "My Custom Crossbow",
    "es_mx": "Mi Ballesta Personalizada"
  },
  "durability": 465,
  "arrow_damage": 12.0,
  "arrow_damage_multiplier": 1.5,
  "charge_speed": 1.0,
  "enchantable": true,
  "enchantability": 15,
  "texture": {
    "mode": "reference",
    "refs": { "crossbow": "minecraft:item/crossbow" }
  }
}

带有接触效果的流体 — 完整示例

{
  "id": "poison_lake",
  "type": "fluid",
  "names": {
    "en_us": "Poison Lake",
    "es_mx": "Lago Venenoso"
  },
  "bucket_names": {
    "en_us": "{fluid_name} Bucket",
    "es_mx": "Cubeta de {fluid_name}"
  },
  "light_level": 3,
  "color": "0xFF4CAF50",
  "tick_rate": 10,
  "spread_distance": 6,
  "burns_entities": false,
  "contact_effect_interval": 2.0,
  "contact_effects": [
    { "effect": "minecraft:poison",   "amplifier": 0, "duration": 3 },
    { "effect": "minecraft:slowness", "amplifier": 1, "duration": 3 }
  ],
  "texture": {
    "mode": "default"
  }
}

类似岩浆的流体 — 完整示例

{
  "id": "magma_fluid",
  "type": "fluid",
  "names": {
    "en_us": "Magma Flow",
    "es_mx": "Flujo de Magma"
  },
  "bucket_names": {
    "en_us": "{fluid_name} Bucket",
    "es_mx": "Cubeta de {fluid_name}"
  },
  "light_level": 15,
  "color": "0xFFFF6600",
  "tick_rate": 30,
  "spread_distance": 4,
  "burns_entities": true,
  "burn_duration": 8,
  "contact_effect_interval": 1.0,
  "contact_effects": [
    { "effect": "minecraft:weakness",       "amplifier": 1, "duration": 5 },
    { "effect": "minecraft:mining_fatigue", "amplifier": 0, "duration": 5 }
  ],
  "texture": {
    "mode": "default"
  }
}

方块 — 简单示例

{
  "id": "my_ore",
  "type": "block",
  "names": {
    "en_us": "My Ore",
    "es_mx": "Mi Mineral"
  },
  "light_level": 3,
  "destroy_time": 3.0,
  "explosion_resistance": 3.0,
  "map_color": "deepslate",
  "required_tool": "pickaxe",
  "harvest_level": 2,
  "sound": "stone",
  "texture": {
    "mode": "reference",
    "refs": {
      "block": "minecraft:block/diamond_ore"
    }
  }
}

带有六面纹理的方块 — 示例

{
  "id": "multi_ore",
  "type": "block",
  "names": {
    "en_us": "Multi Ore",
    "es_mx": "Mineral Multi"
  },
  "texture": {
    "mode": "reference",
    "faces": {
      "top":    "minecraft:block/coal_ore",
      "bottom": "minecraft:block/iron_ore",
      "north":  "minecraft:block/gold_ore",
      "south":  "minecraft:block/redstone_ore",
      "east":   "minecraft:block/emerald_ore",
      "west":   "minecraft:block/diamond_ore"
    }
  }
}

使用 "side" 作为快捷方式,将相同的纹理应用于所有 4 个水平面。

定向方块 — 示例

{
  "id": "directional_block",
  "type": "block",
  "directional": true,
  "names": {
    "en_us": "My Machine",
    "es_mx": "Mi Máquina"
  },
  "texture": {
    "mode": "reference",
    "faces": {
      "top":    "minecraft:block/stone",
      "bottom": "minecraft:block/stone",
      "side":   "minecraft:block/stone",
      "north":  "minecraft:block/furnace_front_on"
    }
  }
}

"north" 面是正面——当方块放置时,它指向放置者。

受重力影响的方块 — 示例

{
  "id": "my_falling_block",
  "type": "block",
  "gravity": true,
  "names": {
    "en_us": "My Falling Block",
    "es_mx": "Mi Bloque con Caída"
  },
  "sound": "sand",
  "destroy_time": 0.5,
  "explosion_resistance": 0.5,
  "texture": {
    "mode": "reference",
    "refs": { "block": "minecraft:block/sand" }
  }
}

配方

UltimateCustomGear 支持直接定义在 JSON 中的原生合成配方。不需要外部模组。

配方类型

类型 描述
shaped 合成台,有特定图案
shapeless 合成台,原料任意顺序
smelting 熔炉
blasting 高炉
smithing_transform 锻造台(模板 + 基础物品 + 升级材料)

标签作为原料

任何原料槽都接受带有 # 前缀的标签——配方将接受该标签中的任何物品:

{
  "key": {
    "P": "#minecraft:planks",
    "I": "#c:ingots/iron",
    "S": "minecraft:stick"
  }
}

适用于有序、无序、熔炼、高炉和锻造配方。结构错误的配方(不均匀的图案行、未定义的图案符号、未使用的键、格式错误的 ID)将被跳过,并会在日志中显示一条详细消息,指明物品和具体问题。

单个物品的配方

{
  "recipe": {
    "type": "shaped",
    "pattern": [
      " G ",
      " G ",
      " S "
    ],
    "key": {
      "G": "mymod:my_gem",
      "S": "minecraft:stick"
    }
  }
}

对于多个配方,使用数组:

{
  "recipe": [
    {
      "type": "shaped",
      ...
    },
    {
      "type": "smelting",
      "ingredient": "mymod:my_ore",
      "experience": 1.0,
      "cooking_time": 200
    }
  ]
}

套装的配方(盔甲、工具、武器)

{
  "recipes": {
    "helmet": {
      "type": "shaped",
      "pattern": [
        "GGG",
        "G G",
        "   "
      ],
      "key": {
        "G": "mymod:my_gem"
      }
    },
    "chestplate": {
      "type": "shaped",
      "pattern": [
        "G G",
        "GGG",
        "GGG"
      ],
      "key": {
        "G": "mymod:my_gem"
      }
    },
    "leggings": {
      "type": "shaped",
      "pattern": [
        "GGG",
        "G G",
        "G G"
      ],
      "key": {
        "G": "mymod:my_gem"
      }
    },
    "boots": {
      "type": "shaped",
      "pattern": [
        "   ",
        "G G",
        "G G"
      ],
      "key": {
        "G": "mymod:my_gem"
      }
    }
  }
}

锻造台配方

{
  "recipe": {
    "type": "smithing_transform",
    "template": "minecraft:netherite_upgrade_smithing_template",
    "base": "mymod:my_diamond_sword",
    "addition": "minecraft:netherite_ingot"
  }
}

原料支持通过资源位置引用任何已安装模组中的任何物品(例如 "othermod:special_ingot")。


标签

同一系统的两个方面:

  • 在配方中使用标签时,使用 # 前缀:"#minecraft:planks" 接受该标签中的任何物品(参见配方 → 标签作为原料)。
  • 让你的内容归属于标签时,使用内容上的 tags 字段,不加 #,这样其他模组的配方——以及你自己的配方——可以接受你的物品/方块/流体。
{
  "id": "ruby_ingot",
  "type": "item",
  "tags": ["c:ingots", "c:ingots/ruby"]
}

标签只是一个声明它的所有内容的集合——你可以使用原版标签、跨模组通用的约定标签(c:),或者创建你自己的标签(customgear:magic_gems)。你的标签会与同名的现有标签合并。

方块会被同时添加到方块和物品标签注册表中(因此使用物品形态的配方可以接受你的方块)。流体会标记流体本身及其桶物品。盔甲/工具/武器套装暂不支持(它们的 ID 是按部件派生的)。

常用标签

原版标签(minecraft:)——让你的内容被视为一种原版材料:

标签 用途
minecraft:planks 在原版配方中视为木板
minecraft:logs 原木
minecraft:wool 羊毛
minecraft:leaves 树叶(用剑/剪刀快速挖掘)
minecraft:swords / minecraft:pickaxes / minecraft:axes / minecraft:shovels / minecraft:hoes 相应类型的工具
minecraft:coals 煤炭类燃料

约定标签(c:)——跨模组互操作性标准(最有用):

标签 用途
c:ingots + c:ingots/<material> 锭
c:gems + c:gems/<material> 宝石
c:ores + c:ores/<material> 矿石
c:raw_materials + c:raw_materials/<material> 粗金属
c:nuggets + c:nuggets/<material> 粒
c:dusts + c:dusts/<material> 粉
c:storage_blocks + c:storage_blocks/<material> 存储方块(X 块)
c:tools + c:tools/<type> 按类型划分的工具
c:armors + c:armors/<slot> 按槽位划分的盔甲
c:foods + c:foods/<type> 食物(c:foods/fruits,c:foods/vegetables…)
c:dyes + c:dyes/<color> 染料
c:seeds / c:crops 种子和作物

提示:同时使用通用标签和材料子标签(c:ingots 和 c:ingots/ruby)以获得最大兼容性——前者用于“任何锭”,后者用于“特指红宝石锭”。


纹理

有三种纹理模式可用:

模式 描述
default 使用原版铁/木头纹理作为占位符
reference 复用另一个物品(原版或模组)的模型
custom 使用你放在 ultimatecustomgear/ 文件夹中的自定义 PNG 文件

⚠️ reference 模式会创建硬依赖。 资源位置指向的属于另一个模组的文件,因此该模