13 自定义物品和物品ToolTip

要使用KubeJS来添加物品，你需要使用事件item.registry。该事件属于StartUp事件。

一、事件监听

你可以使用event.create("自定义物品ID")语句来创建物品。

onEvent("item.registry", event => {
  event.create("自定义物品ID")
})

物品的材质应被放于kubejs/assets/kubejs/textures/item/物品ID.png

如果你想使用自定义的物品模型，你可以使用 Blockbench 制作然后把它放于kubejs/assets/kubejs/models/item/物品ID.json

此外，你还可以手动定义材质路径，详见下文。

注意：1.18.2中事件监听方式有修改，详见1.18.2 方块 / 物品注册修改章节

二、ItemBuilder

你可以使用以下方法设定物品属性。

方法

描述

属性默认值

返回值

type(ItemType 类型)

设置物品类型[1]（仅1.16）

basic

ItemBuilder

tier(字符串类型)

设置物品Tier[2]

ItemBuilder

modifyTier(tier => ...)

自定义物品tier

ItemBuilder

maxStackSize(整形数量)

设置物品单组最大数量

ItemBuilder

maxDamage(整形耐久值)

设置物品最大耐久值

ItemBuilder

burnTime(整形燃烧时间)

（燃料）设置物品燃烧时间

ItemBuilder

containerItem(字符串物品ID)

设置物品容器ID[3]

"minecraft:air"

ItemBuilder

subtypes(Function<ItemStackJS, Collection> fn)

设置物品的SubTypes

null

ItemBuilder

tool(ToolType 类型, 整形等级)

设置物品工具属性

new HashMap<>()

ItemBuilder

miningSpeed(浮点型速度)

（工具）设置挖掘速度

1.0F

ItemBuilder

attackDamage(浮点型伤害)

（武器）设置攻击伤害

ItemBuilder

attackSpeed(浮点型速度)

（武器）设置攻击速度

ItemBuilder

rarity(RarityWrapper 稀有度)

设置物品稀有度

RarityWrapper.COMMON

ItemBuilder

glow(布尔值是否发光)

设置物品是否发光

false

ItemBuilder

tooltip(Component 文本)

设置物品的ToolTip

new ArrayList<>()

ItemBuilder

group(字符串物品组)

设置物品的创造物品栏位[4]

KubeJS.tab

ItemBuilder

color(整形 index, 整形 c)

设置物品颜色

0xFFFFFFFF

ItemBuilder

texture(字符串材质路径)

手动设置物品材质

空字符串

ItemBuilder

parentModel(字符串模型路径)

手动设置物品模型

空字符串

ItemBuilder

food(Consumer b)

（转换为食物）设置食物属性

null

ItemBuilder

[1] 可用值有：basic（默认值）、sword、pickaxe、axe、shovel、hoe、helmet、chestplate、leggings、boots。

注意：1.18.2中该方法有修改，详见1.18.2 方块 / 物品注册修改章节

[2] 工具类的tier类型有：wood、stone、iron、gold、diamond、netherite；护甲类的tier类型有：leather、chainmail、iron、gold、diamond、turtle、netherite

[3] 支持的方法同新建tier

[4] 即类似于岩浆桶和空桶之间的关系。

[5] 可用值有：search、buildingBlocks、decorations、redstone、transportation、misc、food、tools、combat、brewing

注：以上方法中attackDamage(浮点型伤害)、attackSpeed(浮点型速度)在1.16.5版本中可能无法生效，截至编辑本节时仍未修复。

以下为示例：

onEvent("item.registry", event => {
  // 基础示例
  event.create("can_empty").displayName("空罐头盒").maxStackSize(32);
  // 注册头盔
  event.create("another_helmet").displayName("另一个头盔").type("helmet").tier("netherite");
  // 食物注册
  event.create("magic_steak").food(food => {// FoodBuilder
		food
    		.hunger(6)// 饱食度
    		.saturation(6)// 饱和度
      		.effect("speed", 600, 0, 1)// 食用后给予的效果，接受值：效果ID, 持续时间, 等级, 概率(0~1)
      		.removeEffect("poison")// 食用后移除的效果
      		.alwaysEdible()// 无视饱食度依旧可以食用（类似金苹果）
      		.fastToEat()// 缩短食用事件（类似干海带）
      		.meat()// 设置为肉类（狗可食用）
      		.eaten(ctx => {// 当使用时执行...（ItemFoodEatenEventJS）
      			// 该方法可用于部分替代item.food_eaten事件
        		ctx.player.tell(`${ctx.item.id} 真好吃~`)
        	})
	})
})

另请参阅：ItemBuilder、FoodBuilder、ItemFoodEatenEventJS

三、新建Tier

通过新建Tier你可以将一套属性快速应用于多个物品上。

// 注：以下数据均为默认值（对应tier:iron）

// 注册工具tier
onEvent('item.registry.tool_tiers', event => {
  event.add('tier_id', tier => {
    tier.uses = 250 // 耐久
    tier.speed = 6.0 // 挖掘速度
    tier.attackDamageBonus = 2.0 //伤害加成
    tier.level = 2 // 等级
    tier.enchantmentValue = 14 // 附魔
    tier.repairIngredient = '#forge:ingots/iron'// 铁砧修复用物品
  })
})

// 注册护甲tier
onEvent('item.registry.armor_tiers', event => {
  // 栏位顺序对应 [靴子, 护腿, 胸甲, 头盔]
  event.add('tier_id', tier => {
    tier.durabilityMultiplier = 15 // 耐久倍率，每个栏位对应[13, 15, 16, 11]
    tier.slotProtections = [2, 5, 6, 2]// 保护倍率
    tier.enchantmentValue = 9 // 附魔
    tier.equipSound = 'minecraft:item.armor.equip_iron' // 装备音效
    tier.repairIngredient = '#forge:ingots/iron' // 铁砧修复用物品
    tier.toughness = 0.0 // 护甲韧性，钻石为2.0，下界合金为3.0
    tier.knockbackResistance = 0.0
  })
})

在添加完毕以上tier后，你可以在type(ItemType 类型)中传入你自己添加的tier_id来应用它。

以下为部分示例：

onEvent('item.tooltip', tooltip => {
  // 批量添加tooltip
  tooltip.add(['minecraft:diorite', 'minecraft:granite', 'minecraft:andesite'], '三 大 废 岩')
  // 你可以使用除#tag以外的其他任何表述方法
  tooltip.add(/refinedstorage:red_/, 'Can be any color')
  // 你可以使用数组来新建多行tooltip. 你可以使用其他转义符来避开'这个符号
  tooltip.add('thermal:latex_bucket', ["Not equivalent to Industrial Foregoing's Latex", 'Line 2'])
  
  tooltip.addAdvanced('thermal:latex_bucket', (item, advanced, text) => {
    text.add(0/*index*/, Text.of('Hello')) // 当index为0时，这种表示方法 会替换掉物品名称. 如果你想要在第二行添加tooltip，index必须为1，以此类推.
  })
})

另请参阅：ItemTooltipEventJS

上一页12.8 LootJS战利品表修改实例下一页14 方块和物品属性修改

这有帮助吗？

一、事件监听

二、ItemBuilder

三、新建Tier

四、ToolTip