我的世界中国版 Wiki

主题

自定义武器 ​

本页面镜像自
BedrockWiki

根据原始项目协议授权。本文经过AI翻译处理，如有内容遗漏，可以提交PR进行补充。

自1.16.100版本更新以来，制作自定义武器变得非常简单。您只需在BP/items文件夹中定义物品条目，并在RP/textures/items文件夹中提供相应纹理，稍作配置即可获得功能完整的可定制武器。

自定义剑类物品 ​

与其他物品教程类似，我们先从制作基础剑类物品开始。

json
{
	"format_version": "1.16.100",
	"minecraft:item": {
		"description": {
			"identifier": "wiki:my_sword",
			// 注意我们将其归类为装备
			"category": "equipment"
		},
		"components": {
			// 这样可以将剑放置在创造模式下的剑类物品栏中
			"minecraft:creative_category": {
				"parent": "itemGroup.name.sword"
			},
			"minecraft:max_stack_size": 1,
			// 新增配置使物品可手持
			"minecraft:hand_equipped": true,
			"minecraft:durability": {
				"max_durability": 600
			},
			// 按需设置伤害值
			"minecraft:damage": 10,
			// 允许在"sword"槽位附魔
			"minecraft:enchantable": {
				"value": 10,
				"slot": "sword"
			},
			// 该纹理同时用于物品栏和手持模型
			"minecraft:icon": {
				"texture": "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"
					}
				]
			}
		}
	}
}
json
{
	"resource_pack_name": "vanilla",
	"texture_name": "atlas.items",
	"texture_data": {
		"my_sword": {
			// 确保已添加名为my_sword.png的纹理
			"textures": "textures/items/my_sword"
		}
	}
}

若需示例纹理，可将下方图片另存为my_sword.png并放入RP/textures/items目录。

点击此处下载纹理

游戏内效果 ​

完成BP物品配置和RP纹理添加后，创建新世界时需加载这两个包，并在实验性玩法中启用假日创作者功能。

进入创造模式后，可通过名称搜索或剑类物品栏找到您的自定义武器。

手持时效果如下：

工具类功能扩展 ​

可通过添加minecraft:digger等组件实现特殊挖掘功能：

json
"minecraft:digger": {
    "use_efficiency": true,
    "destroy_speeds": [
        {
            "block": "minecraft:web",
            "speed": 15
        },
        {
            "block": "minecraft:bamboo",
            "speed": 10
        }
    ],
	"on_dig":{
		"event": "wiki:my_sword.on_dig_damage"
		// 用于改变武器耐久度
	}
}
json
"events": {
    "wiki:my_sword.on_dig_damage": {
		"damage":{
			// 该事件会使武器在挖掘时损耗耐久
			"type":"durability",
			"target":"self",
			// 使用"self"指定物品自身承受损耗
			"amount":1
		}
	}
}

伤害数值显示 ​

添加"minecraft:weapon": {}组件可在物品提示中显示攻击伤害值。

特殊能力与耐久系统 ​

通过武器组件触发事件实现特殊效果：

json
"minecraft:weapon": {
    "on_hurt_entity": {
        "event": "wiki:my_sword.hurt_entity"
    }
}
json
"events": {
    "wiki:my_sword.hurt_entity": {
		"sequence":[
			{
				"randomize": [
					{
						// 权重值为1
						"weight": 1,
						// 在8x8x8范围内传送持有者
						"teleport": {
							"target": "holder",
							"max_range": [8,8,8]
						},
						// 显示提示文本
						"run_command":{
							"command":[
								"tellraw @s{\"rawtext\":[{\"text\":\"§a剑身发出光芒§r\"}]}"
							]
						}
					},
					{
						// 占位权重值
						"weight": 3
					}
				]
			},
			{
				// 损耗武器耐久度
				"damage":{
					"type":"durability",
					"target":"self",
					"amount":1
				}
			}
		]
    }
}

合成配方示例 ​

json
{
	"format_version": "1.12.0",
	"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"
		}
	}
}

现在您已掌握制作自定义武器的基本方法，可以尝试扩展更多创意功能！