跳到主要内容
版本：26.1

内置附魔效果组件

原版 Minecraft 提供了众多不同类型的附魔效果组件，供附魔定义使用。本文将逐一讲解，包括它们的用法和代码内定义。

数值效果组件​

另请参阅 Minecraft Wiki 上的 Value Effect Components

数值效果组件（value effect component）用于会改变游戏中某处数值的附魔，由 EnchantmentValueEffect 类实现。如果一个值被多个数值效果组件改变（例如被多个附魔改变），它们的效果都会应用。

数值效果组件可以设置为对给定值使用以下任一运算：

  • minecraft:set：覆盖给定的基于等级的值。
  • minecraft:add：将指定的基于等级的值加到旧值上。
  • minecraft:all_of：接受一个由其他数值效果组成的列表，并按所述顺序应用它们。
  • minecraft:multiply：将指定的基于等级的因子与旧值相乘。
  • minecraft:remove_binomial：使用二项分布对给定的（基于等级的）几率进行一次投掷。若成功，则从值中减去 1。注意许多值实际上是标志位，在 1 时完全开启，在 0 时完全关闭。
  • minecraft:exponential：投掷一个给定的（基于等级的）底数和（基于等级的）指数，然后将底数升到该指数次幂。将结果与旧值相乘。

锋利（Sharpness）附魔使用了数值效果组件 minecraft:damage，如下所示，以达成其效果：

"effects": {
    // The type of this effect component is "minecraft:damage".
    // This means that the effect will modify weapon damage.
    // See below for a list of more effect component types.
    "minecraft:damage": [
        {
            // A value effect that should be applied.
            // In this case, since there's only one, this value effect is just named "effect".
            "effect": {
                // The type of value effect to use. In this case, it is "minecraft:add", so the value (given below) will be added 
                // to the weapon damage value.
                "type": "minecraft:add",

                // The value block. In this case, the value is a LevelBasedValue that starts at 1 and increases by 0.5 every enchantment level.
                "value": {
                    "type": "minecraft:linear",
                    "base": 1.0,
                    "per_level_above_first": 0.5
                }
            }
        }
    ]
}

value 块内的对象是一个 LevelBasedValue，它可以让数值效果组件按等级改变其效果的强度。

EnchantmentValueEffect#process 方法可用于根据所提供的数值运算来调整值，如下所示：

// `valueEffect` is an EnchantmentValueEffect instance.
// `enchantLevel` is an integer representing the level of the enchantment
float baseValue = 1.0;
float modifiedValue = valueEffect.process(enchantLevel, server.random, baseValue);

原版附魔数值效果组件类型​

定义为 DataComponentType<EnchantmentValueEffect>​

  • minecraft:crossbow_charge_time：以秒为单位修改此弩的蓄力时间。由快速装填（Quick Charge）使用。
  • minecraft:trident_spin_attack_strength：修改三叉戟旋转攻击的"强度"（见 TridentItem#releaseUsing）。由激流（Riptide）使用。

定义为 DataComponentType<List<ConditionalEffect<EnchantmentValueEffect>>>​

护甲相关：

  • minecraft:armor_effectiveness：决定护甲对此武器的有效程度，取值范围为 0（无防护）到 1（正常防护）。由破甲（Breach）使用。
  • minecraft:damage_protection：每"点"减伤会将持有此物品时受到的伤害减少 4%，最多减少 80%。由爆炸保护、摔落缓冲、火焰保护、保护和弹射物保护使用。

攻击相关：

  • minecraft:damage：修改此武器的攻击伤害。由锋利、穿刺、节肢杀手、力量和亡灵杀手使用。
  • minecraft:smash_damage_per_fallen_block：为重锤按下落方块数添加伤害。由致密（Density）使用。
  • minecraft:knockback：修改持有此武器时造成的击退量，以游戏单位衡量。由击退和冲击使用。
  • minecraft:mob_experience：修改击杀生物所获得的经验量。未使用。

耐久相关：

  • minecraft:item_damage：修改物品受到的耐久损伤。低于 1 的值表示物品受损的几率。由耐久使用。
  • minecraft:repair_with_xp：使物品利用经验获取来修复自身，并决定其效果如何。由经验修补使用。

弹射物相关：

  • minecraft:ammo_use：修改发射弓或弩时消耗的弹药量。该值被钳制为整数，因此低于 1 的值将导致消耗 0 弹药。由无限使用。
  • minecraft:projectile_piercing：修改此武器发射的弹射物所穿透的实体数量。由穿透（Piercing）使用。
  • minecraft:projectile_count：修改射出此弓时生成的弹射物数量。由多重射击使用。
  • minecraft:projectile_spread：修改弹射物相对于发射方向的最大散布度数。由多重射击使用。
  • minecraft:trident_return_acceleration：使三叉戟返回其拥有者，并修改返回过程中施加于该三叉戟的加速度。由忠诚（Loyalty）使用。

其他：

  • minecraft:block_experience：修改破坏方块所获得的经验量。由精准采集使用。
  • minecraft:fishing_time_reduction：将使用此钓竿时浮标下沉所需的时间减少给定的秒数。由饵钓（Lure）使用。
  • minecraft:fishing_luck_bonus：修改钓鱼战利品表中所用的幸运量。由海之眷顾使用。

定义为 DataComponentType<List<TargetedConditionalEffect<EnchantmentValueEffect>>>​

  • minecraft:equipment_drops：修改被此武器击杀的实体掉落装备的几率。由抢夺（Looting）使用。

基于位置的效果组件​

另请参阅 Minecraft Wiki 上的 Location Based Effect Components

基于位置的效果组件（location based effect component）是实现 EnchantmentLocationBasedEffect 的组件。这些组件定义了需要知道附魔持有者在世界中所处位置才能执行的动作。它们主要通过两个方法运作：EnchantmentEntityEffect#onChangedBlock，在附魔物品被装备时以及持有者改变其 BlockPos 时调用；以及 onDeactivate，在附魔物品被移除时调用。

下面是一个使用 minecraft:attributes 基于位置的效果组件类型来改变持有者实体缩放比例的示例：

// The type is "minecraft:attributes" (described below).
// In a nutshell, this applies an attribute modifier.
"minecraft:attributes": [
    {
        // This "amount" block is a LevelBasedValue.
        "amount": {
            "type": "minecraft:linear",
            "base": 1,
            "per_level_above_first": 1
        },

        // Which attribute to modify. In this case, modifies "minecraft:scale"
        "attribute": "minecraft:scale",
        // The unique identifier for this attribute modifier. Should not overlap with others, but doesn't need to be registered.
        "id": "examplemod:enchantment.size_change",
        // What operation to use on the attribute. Can be "add_value", "add_multiplied_base", or "add_multiplied_total".
        "operation": "add_value"
    }
],

原版添加了以下基于位置的事件：

  • minecraft:all_of：按顺序运行一系列实体效果。
  • minecraft:apply_mob_effect：对受影响的生物施加一个状态效果。
  • minecraft:attribute：对附魔持有者施加一个属性修饰符。
  • minecraft:change_item_damage：损耗此物品的耐久。
  • minecraft:damage_entity：对受影响的实体造成伤害。若处于攻击上下文中，这会与攻击伤害叠加。
  • minecraft:explode：召唤一次爆炸。
  • minecraft:ignite：使实体着火。
  • minecraft:apply_impulse：对实体施加指定的速度（分解为方向、坐标和量级）。
  • minecraft:apply_exhaustion：为玩家增加指定量的饥饿消耗。
  • minecraft:play_sound：播放指定的声音。
  • minecraft:replace_block：替换给定偏移处的一个方块。
  • minecraft:replace_disk：替换一个圆盘状区域的方块。
  • minecraft:run_function：运行指定的数据包函数。
  • minecraft:set_block_properies：修改指定方块的方块状态属性。
  • minecraft:spawn_particles：生成一个粒子。
  • minecraft:summon_entity：召唤一个实体。

原版基于位置的效果组件类型​

定义为 DataComponentType<List<ConditionalEffect<EnchantmentLocationBasedEffect>>>​

  • minecraft:location_changed：在持有者的方块位置改变时以及此物品被装备时，运行一个基于位置的效果。由冰霜行者和灵魂疾行使用。

定义为 DataComponentType<List<EnchantmentAttributeEffect>>​

  • minecraft:attributes：对持有者施加一个属性修饰符，并在附魔物品不再被装备时移除它。

实体效果组件​

另请参阅 Minecraft Wiki 上的 Entity Effect Components。

实体效果组件（entity effect component）是实现 EnchantmentEntityEffect 的组件，它是 EnchantmentLocationBasedEffect 的一个子类型。这些组件重写 EnchantmentLocationBasedEffect#onChangedBlock 以改为运行 EnchantmentEntityEffect#apply；这个 apply 方法也会视组件的具体类型而定，在代码库中的其他某处被直接调用。这使得效果无需等待持有者的方块位置改变即可发生。

所有基于位置的效果组件类型也都是合法的实体效果组件类型，minecraft:attribute 除外——它只被注册为基于位置的效果组件。

下面是取自火焰附加（Fire Aspect）附魔的一个此类组件的 JSON 定义示例：

// This component's type is "minecraft:post_attack" (see below).
"minecraft:post_attack": [
    {
        // Decides whether the "victim" of the attack, the "attacker", or the "damaging entity" (the projectile if there is one, attacker if not) recieves the effect.
        "affected": "victim",
        
        // Decides which enchantment entity effect to apply.
        "effect": {
            // The type of this effect is "minecraft:ignite".
            "type": "minecraft:ignite",
            // "minecraft:ignite" requires a LevelBasedValue as a duration for how long the entity will be ignited.
            "duration": {
                "type": "minecraft:linear",
                "base": 4.0,
                "per_level_above_first": 4.0
            }
        },

        // Decides who (the "victim", "attacker", or "damaging entity") must have the enchantment for it to take effect.
        "enchanted": "attacker",

        // An optional predicate which controls whether the effect applies.
        "requirements": {
            "condition": "minecraft:damage_source_properties",
            "predicate": {
                "is_direct": true
            }
        }
    }
]

这里，实体效果组件是 minecraft:post_attack。其效果是 minecraft:ignite，由 Ignite record 实现。该 record 对 EnchantmentEntityEffect#apply 的实现会使目标实体着火。

原版附魔实体效果组件类型​

定义为 DataComponentType<List<ConditionalEffect<EnchantmentEntityEffect>>>​

  • minecraft:post_piercing_attack：在生物实体向前突刺时运行一个实体效果。由突刺（Lunge）使用。
  • minecraft:hit_block：在一个实体（例如弹射物）击中方块时运行一个实体效果。由引雷（Channeling）使用。
  • minecraft:tick：每刻运行一个实体效果。由灵魂疾行使用。
  • minecraft:projectile_spawned：在一个弹射物实体从弓或弩生成之后运行一个实体效果。由火矢（Flame）使用。

定义为 DataComponentType<List<TargetedConditionalEffect<EnchantmentEntityEffect>>>​

  • minecraft:post_attack：在一次攻击对实体造成伤害之后运行一个实体效果。由节肢杀手、引雷、火焰附加、荆棘和风爆使用。

关于这些的更多细节，请查看相关的 Minecraft Wiki 页面。

其他原版附魔组件类型​

定义为 DataComponentType<List<ConditionalEffect<DamageImmunity>>>​

  • minecraft:damage_immunity：对指定伤害类型施加免疫。由冰霜行者使用。

定义为 DataComponentType<Unit>​

  • minecraft:prevent_equipment_drop：防止此物品在玩家死亡时被掉落。由消失诅咒使用。
  • minecraft:prevent_armor_change：防止此物品从护甲槽位被卸下。由绑定诅咒使用。

定义为 DataComponentType<List<CrossbowItem.ChargingSounds>>​

  • minecraft:crossbow_charge_sounds：决定为弩蓄力时发生的声音事件。每个条目代表附魔的一个等级。

定义为 DataComponentType<List<Holder<SoundEvent>>>​

  • minecraft:trident_sound：决定使用三叉戟时发生的声音事件。每个条目代表附魔的一个等级。