命令/enchant

/enchant

需要的权限等级	Java版：2 基岩版：1
限制条件	启用作弊[仅基岩版]

为一个实体手持的物品添加魔咒。受限于铁砧机制。

语法

• Java版

enchant <targets> <enchantment> [<level>]

• 基岩版

enchant <player: target> <enchantmentId: int> [level: int]

enchant <player: target> <enchantmentName: Enchant> [level: int]

参数

JE：<targets>：entity
BE：player: target：CommandSelector<Actor>

指定目标。

必须为玩家名、目标选择器或UUID^[仅Java版]。

JE：<enchantment>：resource
BE：enchantmentId: int：int或<enchantmentName: Enchant>：enum

指定要添加到实体主手持有物品上的魔咒。

在Java版中，必须是一个注册在minecraft:enchantment注册表的一个注册项的命名空间ID。在基岩版中，必须是一个魔咒的ID（无命名空间）。

JE：<level>：integer
BE：level: int：int

指定魔咒的等级。此值不应当大于指定魔咒的最大等级。若未指定则默认为1。

必须为 32位整数。在Java版中，必须大于等于0。在基岩版中，应当大于等于1。

结果

命令	触发条件	Java版	基岩版
任意	参数不正确	无法解析	无法解析
	<targets>或player: target未能选中实体（指定的玩家必须在线上）	执行失败	执行失败
	<level>或level: int大于指定魔咒的最大等级
	level: int小于1	无法解析
	所有实体均无手持物品	执行失败
	魔咒对所有实体的手持物品无效
	魔咒与已存在的魔咒冲突 （例如不能给带有“多重射击”的弩添加“穿透”，不能给带有“锋利I”的剑添加“锋利III”[仅Java版]）
	所有目标的手持物品均带有该（最高等级的）[仅基岩版]魔咒
	不符合以上所有条件	执行成功

输出

命令	版本	条件	成功次数	/execute store success ...	/execute store result ...
任意	Java版	失败	0	0	0
		成功	1	1	物品成功添加魔咒的玩家数量
	基岩版	失败	0	N/A	N/A
		成功	物品成功添加魔咒的玩家数量	N/A	N/A

示例

• 给所有手持弓的玩家的主手物品添加无限：enchant @a 22^{[仅基岩版]}或enchant @a infinity
• 给所有手持剑的盔甲架的主手物品添加锋利：enchant @e[type=armor_stand] 9^{[仅基岩版]}或enchant @e[type=armor_stand] sharpness

历史

Java版
1.4.4			pre				加入了/enchant命令。
1.13			17w45a				移除了/enchant命令。
			18w06a				重新加入了/enchant命令。
携带版Alpha
0.16.0			build 5				加入了/enchant命令。