/enchant 命令

/enchant 命令

来源：Commands/enchant，英文修订 ID：3846696。

给玩家选中的物品添加附魔，限制与铁砧相同，也可用于主手持有武器、工具或盔甲的任何生物或实体。Java 版所需权限等级为 2；基岩版为 1，并需要启用作弊。

语法

Java 版：

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

基岩版：

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

参数

<targets>: entity／player: target（CommandSelector<Actor>）：目标实体。Java 版可用玩家名称、目标选择器或 UUID；基岩版可用玩家名称或目标选择器。以名称指定的玩家必须在线。

<enchantment>: resource／enchantmentId: int／enchantmentName: Enchant：要加到目标主手物品上的附魔。Java 版必须为 minecraft:enchantment 注册表中已有的资源位置；基岩版使用有效附魔名称或数字 ID。

<level>: integer／level: int：附魔等级，默认 1，不得超过该附魔的最高等级。Java 版必须为至少 0 的 32 位整数；基岩版必须为 1 至 2147483647 之间的整数。

结果

命令不完整或任一参数指定错误时无法解析。目标未解析为一个或多个实体、基岩版等级小于 1、等级超过附魔最高等级，或所有目标都符合下列一种或多种情况时失败：

  • 主手没有物品。
  • 该附魔不适用于主手物品。
  • 附魔与现有附魔冲突，例如已有多重射击的弩不能再获得穿透；已有锋利 I 的剑不能再获得锋利 III。
  • Java 版中，主手物品已拥有此附魔。
  • 基岩版中，主手物品已拥有此附魔的最高等级。

其他情况成功。

输出

Java 版失败时成功次数、success 与 result 均为 0；成功时成功次数与 success 为 1，result 为物品成功附魔的玩家数量。

基岩版失败时成功次数为 0，成功时为物品成功附魔的玩家数量。

示例

为所有持弓玩家的弓添加无限：

/enchant @a infinity

给最近玩家手持的剑添加锋利 V：

/enchant @p sharpness 5

参考资料

  • MC-261942。
  • /enchant 检查最高等级和兼容性，但 /give、/replaceitem、/data 等命令可以绕过这些限制。
  • 原文历史部分另引用了已修复问题 MCPE-113623 与 MCPE-153204。

外部链接

本文为 Minecraft Wiki 对应英文条目的中文翻译与改编，已按要求省略变更历史。原作者与贡献者见来源页及其历史；除另有说明外，按 CC BY-NC-SA 3.0 非商业、署名、相同方式共享。