自定义武器

easy

自定义武器

自定义剑物品
游戏内效果
工具类功能
物品合成配方

跟随本指南创建一把自定义剑。你可以自由调整来制作任何想要的武器！

如需为武器添加更多功能，可参考命中实体事件。

自定义剑物品

与其他物品教程类似，我们将从制作一把基础自定义剑开始。

BP/items/my_sword.json

json

{
    "format_version": "1.21.70",
    "minecraft:item": {
        "description": {
            "identifier": "wiki:my_sword",
            "menu_category": {
                "category": "equipment",
                "group": "minecraft:itemGroup.name.sword"
            }
        },
        "components": {
            "minecraft:max_stack_size": 1,
            // 使物品在第三人称视角正确持握
            "minecraft:hand_equipped": true,
            "minecraft:durability": {
                "max_durability": 600
            },
            // 该武器对实体造成的额外伤害值
            "minecraft:damage": 10,
            // 允许在"剑"槽位附魔
            "minecraft:enchantable": {
                "value": 10,
                "slot": "sword"
            },
            // 该纹理同时用于物品栏和手持模型
            "minecraft:icon": "wiki:my_sword",
            "minecraft:display_name": {
                "value": "我的自定义剑"
            },
            // 允许用木棍修复剑
            "minecraft:repairable": {
                "repair_items": [
                    {
                        "items": ["minecraft:stick"],
                        "repair_amount": "context.other->q.remaining_durability + 0.05 * context.other->q.max_durability"
                    }
                ]
            }
        }
    }
}

以上配置已足够在游戏中生成一把剑。我们还需要在资源包中注册图标，只需在RP文件夹中添加如下内容：

RP/textures/item_texture.json

json

{
    "resource_pack_name": "custom-weapon",
    "texture_name": "atlas.items",
    "texture_data": {
        "wiki:my_sword": {
            // 确保此处已放置名为my_sword.png的图标纹理
            "textures": "textures/items/my_sword"
        }
    }
}

若没有现成纹理，可保存下方示例图片至RP/textures/items目录。

下载纹理

游戏内效果

完成行为包（BP）的物品JSON定义和资源包（RP）的纹理配置后，创建新世界时请确保加载该附加包。

完成上述步骤后，进入创造模式即可通过名称或在剑类物品栏中找到你的自定义剑。

手持时，游戏内显示效果如下：

这并不困难对吧？现在你可以制作任意数量的自定义剑了。如果想进一步探索，还有更多有趣的功能可以实现。

工具类功能

你可以混合其他组件，例如添加minecraft:digger组件使剑能快速破坏蜘蛛网或竹子：

minecraft:item > components

json

"minecraft:digger": {
    "use_efficiency": true,
    "destroy_speeds": [
        {
            "block": "minecraft:web",
            "speed": 15
        },
        {
            "block": "minecraft:bamboo",
            "speed": 10
        }
    ]
}

物品合成配方

建议为武器添加合成配方（此前章节已涵盖相关内容）。若不确定如何操作，这里提供一个用末影之眼和末影珍珠合成剑的示例：

BP/recipes/my_sword.json

json

{
    "format_version": "1.21.70",
    "minecraft:recipe_shaped": {
        "description": {
            "identifier": "wiki:my_sword"
        },
        "tags": ["crafting_table"],
        "pattern": ["e", "E", "#"],
        "key": {
            "#": {
                "item": "minecraft:stick"
            },
            "E": {
                "item": "minecraft:ender_eye"
            },
            "e": {
                "item": "minecraft:ender_pearl"
            }
        },
        "result": {
            "item": "wiki:my_sword"
        },
        "unlock": [
            {
                "item": "minecraft:ender_eye"
            }
        ]
    }
}