mc-item · diff
v1.14.4 to v1.14.4
36 added, 14 removed. Audit A to A.
---
name: mc-item
- description: Fabric 物品开发。FabricItemSettings、Item、FoodComponent、ToolMaterial。触发词：物品、Item、ItemStack、ToolMaterial、FoodComponent
+ description: Fabric 物品开发。Item.Settings、Item、FoodComponent、ToolMaterial。触发词：物品、Item、ItemStack、ToolMaterial、FoodComponent
platform: fabric
version: "1.14.4"
dependencies: []
mappings: yarn
---
# 物品开发（Fabric 1.14.4）
+ Yarn：[`Item.Settings`](https://github.com/FabricMC/yarn/blob/1.14.4/mappings/net/minecraft/item/Item.mapping)（`maxCount` / `maxDamage` / `food`），不是 `Item.Properties`。
+
## 快速开始
```java
private static final Item MY_ITEM = Registry.register(
Registry.ITEM,
new Identifier(MOD_ID, "my_item"),
new Item(new Item.Settings().maxCount(64))
);
```
## Decision: 选择物品类型
```
IF 普通物品（无特殊行为）
→ new Item(new Item.Settings())
IF 食物
- → new Item(new Item.Settings().food(FoodComponent.Builder))
+ → new Item(new Item.Settings().food(new FoodComponent.Builder()...build()))
IF 工具（剑/镐）
- → 继承 DiggerItem 或自定义工具类
+ → SwordItem / PickaxeItem（公共父类 MiningToolItem）。不要 DiggerItem
IF 可耐久
→ 设置 maxDamage
IF 自定义行为
- → 继承 Item 并重写 use()、onEntityUse() 等方法
+ → 继承 Item 并重写 use()、useOnBlock()、useOnEntity()
```
## 食物
```java
private static final Item MY_APPLE = Registry.register(
Registry.ITEM,
new Identifier(MOD_ID, "golden_apple"),
new Item(new Item.Settings()
.food(new FoodComponent.Builder()
.hunger(4)
.saturationModifier(1.2f)
.statusEffect(
new StatusEffectInstance(StatusEffects.REGENERATION, 100, 1),
1.0f
)
.alwaysEdible()
.snack()
.build())
.maxCount(64))
);
```
+ ## 燃料
+
+ [Fabric wiki items](https://wiki.fabricmc.net/tutorial:items)：1.21.2 前用 `FuelRegistry.INSTANCE.add(item, burnTime)`。
+
+ ```java
+ FuelRegistry.INSTANCE.add(MY_ITEM, 300);
+ ```
+
## 工具
+ `ToolMaterial` 只有六个方法，**不要**把 `TagKey` / `FabricToolTags` 塞进材质接口。1.14 没有铜锭。修复材料用 `Ingredient.ofItems`。
+
```java
public enum MyToolMaterial implements ToolMaterial {
- COPPER(2, 250, 6.0f, 2.0f, 15,
- FabricToolTags.PICKAXES, () -> Items.COPPER_INGOT);
+ IRON_LIKE(2, 250, 6.0f, 2.0f, 14, Ingredient.ofItems(Items.IRON_INGOT));
private final int miningLevel;
private final int itemDurability;
private final float miningSpeed;
private final float attackDamage;
private final int enchantability;
- private final TagKey<Block> breakableBlocks;
- private final Supplier<Item> repairIngredient;
+ private final Ingredient repairIngredient;
- MyToolMaterial(...) { ... }
+ MyToolMaterial(int miningLevel, int itemDurability, float miningSpeed,
+ float attackDamage, int enchantability, Ingredient repairIngredient) {
+ this.miningLevel = miningLevel;
+ this.itemDurability = itemDurability;
+ this.miningSpeed = miningSpeed;
+ this.attackDamage = attackDamage;
+ this.enchantability = enchantability;
+ this.repairIngredient = repairIngredient;
+ }
+
+ @Override public int getMiningLevel() { return miningLevel; }
@Override public int getDurability() { return itemDurability; }
@Override public float getMiningSpeed() { return miningSpeed; }
- @Override public float getAttackDamage() { return attackDamage + 1.0f; }
- @Override public int getMiningLevel() { return miningLevel; }
+ @Override public float getAttackDamage() { return attackDamage; }
@Override public int getEnchantability() { return enchantability; }
- @Override public Ingredient getRepairIngredient() { return Ingredient.of(repairIngredient.get()); }
+ @Override public Ingredient getRepairIngredient() { return repairIngredient; }
}
```
+ 自定义镐加入 `data/fabric/tags/items/pickaxes.json`，以便 `FabricBlockSettings.breakByTool(FabricToolTags.PICKAXES, level)` 认工具（[wiki](https://wiki.fabricmc.net/tutorial:1.1x-1.17:mining_levels)）。
+
## 自定义物品行为
```java
public class MySpecialItem extends Item {
public MySpecialItem(Settings settings) {
super(settings);
}
@Override
public TypedActionResult<ItemStack> use(World world, PlayerEntity player, Hand hand) {
if (!world.isClient) {
- player.getItemStack(hand).damage(1, player,
+ player.getStackInHand(hand).damage(1, player,
(p) -> p.sendToolBreakStatus(hand));
}
- return TypedActionResult.success(player.getItemStack(hand));
+ return TypedActionResult.success(player.getStackInHand(hand));
}
}
```
## 常见错误
- ❌忘记注册 Item — 物品不会出现在游戏中
- ❌耐久物品忘记设置 `maxDamage` — 无法消耗耐久
- ❌ FoodComponent.Builder 忘记 `.hunger()` — 食物不会被消耗
+ - ❌ `world.isRemote` / `getItemStack` / `DiggerItem` / `Ingredient.of` / `TagKey`（1.14 Yarn 不是这些）
## 扩展点
| 配合 Skill | 协作说明 |
|-----------|---------|
| `mc-registry` | 物品通过 Registry.register() 注册 |
| `mc-datagen` | DataGen 生成物品模型 JSON |
| `mc-block` | BlockItem 关联方块 |