Skip to main content

Attributes Applicator Effect

The ATTRIBUTES_APPLICATOR effect allows you to create items that add or modify attributes on other items. This is perfect for creating attribute runes, stat boosters, or equipment upgrade items.

Configuration​

effects:
  - type: ATTRIBUTES_APPLICATOR
    attributes:
      - attribute: ATTACK_DAMAGE
        operation: ADD_NUMBER
        amount: 10.0
        slot: HAND
      - attribute: ATTACK_SPEED
        operation: ADD_NUMBER
        amount: 2.0
        slot: HAND

    # Merge strategy for existing attributes
    strategy: ADD  # ADD, REPLACE, KEEP_HIGHEST, KEEP_LOWEST, SUM

    # Optional: Restrict which items can have this effect
    applicable-materials:
      - DIAMOND_SWORD
      - NETHERITE_SWORD
    applicable-tags:
      - SWORDS
    applicability-blacklisted: false

Parameters​

ParameterTypeRequiredDefaultDescription
attributesListYes-List of attributes to apply
strategyEnumNoADDHow to merge with existing attributes
applicable-materialsListNo-Items that can have this effect
applicable-tagsListNo-Item tags
applicability-blacklistedBooleanNofalseInvert applicability

Attribute Parameters​

Each attribute entry supports:

ParameterTypeRequiredDescription
attributeStringYesThe attribute type
operationEnumYesHow the value is applied
amountDoubleYesThe attribute value
slotEnumNoEquipment slot restriction

Merge Strategies​

StrategyDescription
ADDAdd new attributes while keeping existing ones
REPLACEReplace all existing attributes with new ones
KEEP_HIGHESTKeep only the highest value for each attribute
KEEP_LOWESTKeep only the lowest value for each attribute
SUMSum modifiers with same attribute and operation

Available Attributes​

Combat Attributes​

AttributeDescription
ATTACK_DAMAGEMelee damage dealt
ATTACK_SPEEDAttack cooldown speed
ATTACK_KNOCKBACKKnockback on hit

Defense Attributes​

AttributeDescription
ARMORDamage reduction
ARMOR_TOUGHNESSArmor effectiveness vs strong attacks
KNOCKBACK_RESISTANCEResistance to knockback

Movement Attributes​

AttributeDescription
MOVEMENT_SPEEDWalking speed
FLYING_SPEEDFlight speed (creative)
JUMP_STRENGTHJump height
SAFE_FALL_DISTANCEFall distance before damage
FALL_DAMAGE_MULTIPLIERFall damage multiplier
STEP_HEIGHTAuto-step height

Health & Combat​

AttributeDescription
MAX_HEALTHMaximum health
SCALEEntity size scale
GRAVITYGravity strength
BURNING_TIMETime on fire
EXPLOSION_KNOCKBACK_RESISTANCEExplosion knockback resistance
OXYGEN_BONUSUnderwater breathing bonus
WATER_MOVEMENT_EFFICIENCYSwimming speed
BLOCK_BREAK_SPEEDMining speed
BLOCK_INTERACTION_RANGEBlock reach distance
ENTITY_INTERACTION_RANGEEntity reach distance
LUCKLuck stat
FOLLOW_RANGEEntity follow range

Minecraft 1.21+ Attributes​

AttributeDescription
MINING_EFFICIENCYMining speed multiplier
SNEAKING_SPEEDSneaking speed
SUBMERGED_MINING_SPEEDUnderwater mining speed
SWEEPING_DAMAGE_RATIOSweep attack damage ratio

Operations​

OperationFormulaDescription
ADD_NUMBERBase + ValueAdds flat amount
ADD_SCALARBase * (1 + Value)Adds percentage
MULTIPLY_SCALAR_1Base * ValueMultiplies by value

Equipment Slots​

SlotDescription
HANDMain hand
OFF_HANDOff hand
HEADHelmet slot
CHESTChestplate slot
LEGSLeggings slot
FEETBoots slot
ARMORAny armor slot
BODYBody slot (for horses/armor stands)
ANYAny equipment slot

Examples​

Damage Boost Rune​

damage_rune:
  material: BLAZE_POWDER
  display-name: "<gradient:#ff4500:#ff0000>Damage Rune</gradient>"
  lore:
    - ""
    - "<gray>Increases attack damage.</gray>"
    - ""
    - "<red>+10 Attack Damage</red>"

  effects:
    - type: ATTRIBUTES_APPLICATOR
      attributes:
        - attribute: ATTACK_DAMAGE
          operation: ADD_NUMBER
          amount: 10.0
          slot: HAND

      applicable-tags:
        - SWORDS
        - AXES

      representation:
        material: BLAZE_POWDER
        display-name: "<gradient:#ff4500:#ff0000>Damage Rune</gradient>"
        lore:
          - ""
          - "<gray>Apply in smithing table</gray>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

Speed Boost Gem​

speed_gem:
  material: EMERALD
  display-name: "<gradient:#00ff00:#00aa00>Speed Gem</gradient>"
  lore:
    - ""
    - "<gray>Increases movement speed.</gray>"
    - ""
    - "<green>+20% Movement Speed</green>"

  effects:
    - type: ATTRIBUTES_APPLICATOR
      attributes:
        - attribute: MOVEMENT_SPEED
          operation: ADD_SCALAR
          amount: 0.2
          slot: FEET

      strategy: ADD

      applicable-materials:
        - NETHERITE_BOOTS
        - DIAMOND_BOOTS
        - IRON_BOOTS

      representation:
        material: EMERALD
        display-name: "<gradient:#00ff00:#00aa00>Speed Gem</gradient>"
        lore:
          - ""
          - "<gray>Apply to boots</gray>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

Warrior's Essence​

warrior_essence:
  material: NETHER_STAR
  display-name: "<gradient:#ffd700:#ff8c00>Warrior's Essence</gradient>"
  lore:
    - ""
    - "<gray>The essence of a true warrior.</gray>"
    - ""
    - "<yellow>Combat Attributes:</yellow>"
    - "<gray>+15 Attack Damage</gray>"
    - "<gray>+50% Attack Speed</gray>"
    - "<gray>+2 Attack Knockback</gray>"

  effects:
    - type: ATTRIBUTES_APPLICATOR
      attributes:
        - attribute: ATTACK_DAMAGE
          operation: ADD_NUMBER
          amount: 15.0
          slot: HAND
        - attribute: ATTACK_SPEED
          operation: ADD_SCALAR
          amount: 0.5
          slot: HAND
        - attribute: ATTACK_KNOCKBACK
          operation: ADD_NUMBER
          amount: 2.0
          slot: HAND

      strategy: ADD

      applicable-tags:
        - SWORDS

      representation:
        material: NETHER_STAR
        display-name: "<gradient:#ffd700:#ff8c00>Warrior's Essence</gradient>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

Tank Armor Upgrade​

tank_upgrade:
  material: IRON_BLOCK
  display-name: "<gradient:#808080:#696969>Tank Upgrade</gradient>"
  lore:
    - ""
    - "<gray>Become an unstoppable tank!</gray>"
    - ""
    - "<white>Defense Attributes:</white>"
    - "<gray>+10 Armor</gray>"
    - "<gray>+5 Armor Toughness</gray>"
    - "<gray>+50% Knockback Resistance</gray>"
    - "<gray>+10 Max Health</gray>"

  effects:
    - type: ATTRIBUTES_APPLICATOR
      attributes:
        - attribute: ARMOR
          operation: ADD_NUMBER
          amount: 10.0
          slot: CHEST
        - attribute: ARMOR_TOUGHNESS
          operation: ADD_NUMBER
          amount: 5.0
          slot: CHEST
        - attribute: KNOCKBACK_RESISTANCE
          operation: ADD_SCALAR
          amount: 0.5
          slot: CHEST
        - attribute: MAX_HEALTH
          operation: ADD_NUMBER
          amount: 10.0
          slot: CHEST

      strategy: ADD

      applicable-materials:
        - NETHERITE_CHESTPLATE
        - DIAMOND_CHESTPLATE

      representation:
        material: IRON_BLOCK
        display-name: "<gradient:#808080:#696969>Tank Upgrade</gradient>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

Miner's Blessing​

miner_blessing:
  material: GOLDEN_PICKAXE
  display-name: "<gradient:#ffd700:#daa520>Miner's Blessing</gradient>"
  lore:
    - ""
    - "<gray>Blessed by the mining gods.</gray>"
    - ""
    - "<yellow>Mining Attributes:</yellow>"
    - "<gray>+50% Block Break Speed</gray>"
    - "<gray>+2 Block Reach</gray>"

  effects:
    - type: ATTRIBUTES_APPLICATOR
      attributes:
        - attribute: BLOCK_BREAK_SPEED
          operation: ADD_SCALAR
          amount: 0.5
          slot: HAND
        - attribute: BLOCK_INTERACTION_RANGE
          operation: ADD_NUMBER
          amount: 2.0
          slot: HAND

      strategy: ADD

      applicable-tags:
        - PICKAXES

      representation:
        material: GOLDEN_PICKAXE
        display-name: "<gradient:#ffd700:#daa520>Miner's Blessing</gradient>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

Replace Strategy Example​

perfect_stats:
  material: DIAMOND
  display-name: "<aqua>Perfect Stats Crystal</aqua>"
  lore:
    - ""
    - "<gray>Replaces all attributes with</gray>"
    - "<gray>perfect balanced stats.</gray>"

  effects:
    - type: ATTRIBUTES_APPLICATOR
      strategy: REPLACE  # Removes existing attributes!

      attributes:
        - attribute: ATTACK_DAMAGE
          operation: ADD_NUMBER
          amount: 20.0
          slot: HAND
        - attribute: ATTACK_SPEED
          operation: ADD_NUMBER
          amount: 4.0
          slot: HAND

      applicable-tags:
        - SWORDS

      representation:
        material: DIAMOND
        display-name: "<aqua>Perfect Stats Crystal</aqua>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

Craftable Speed Boots Upgrade​

swiftness_crystal:
  material: PRISMARINE_SHARD
  display-name: "<gradient:#00ffff:#1e90ff>Swiftness Crystal</gradient>"
  lore:
    - ""
    - "<gray>Enhances boot speed.</gray>"
    - ""
    - "<aqua>+30% Movement Speed</aqua>"
    - "<aqua>+20% Jump Strength</aqua>"

  effects:
    - type: ATTRIBUTES_APPLICATOR
      attributes:
        - attribute: MOVEMENT_SPEED
          operation: ADD_SCALAR
          amount: 0.3
          slot: FEET
        - attribute: JUMP_STRENGTH
          operation: ADD_SCALAR
          amount: 0.2
          slot: FEET

      strategy: ADD

      applicable-materials:
        - NETHERITE_BOOTS
        - DIAMOND_BOOTS
        - IRON_BOOTS
        - GOLDEN_BOOTS
        - CHAINMAIL_BOOTS
        - LEATHER_BOOTS

      representation:
        material: PRISMARINE_SHARD
        display-name: "<gradient:#00ffff:#1e90ff>Swiftness Crystal</gradient>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

  recipe:
    type: SHAPED
    pattern:
      - "PEP"
      - "ESE"
      - "PEP"
    ingredients:
      - item: PRISMARINE_SHARD
        sign: P
      - item: EMERALD
        sign: E
      - item: SUGAR
        sign: S

Use Cases​

  1. Stat Upgrades: Allow players to customize item stats
  2. Progression System: Tiered attribute upgrades
  3. Class Items: Role-specific stat modifiers
  4. Balance Tools: Items that normalize stats (REPLACE strategy)
  5. Event Rewards: Powerful stat boosters

Strategy Comparison​

# ADD - Keeps existing + adds new
strategy: ADD
# Result: Item has both old and new attributes

# REPLACE - Removes all, adds new
strategy: REPLACE
# Result: Only new attributes remain

# KEEP_HIGHEST - Keeps highest for each attribute
strategy: KEEP_HIGHEST
# Result: For each attribute, only the highest value is kept

# SUM - Combines same attribute+operation
strategy: SUM
# Result: +5 damage + +3 damage = +8 damage

Tips​

  • Use ADD for stacking upgrades
  • Use REPLACE for setting exact values
  • Use KEEP_HIGHEST for best-in-slot systems
  • Use SUM for cumulative upgrades
  • Consider balance when setting attribute values
  • Test with different equipment slots
  • Combine with crafting recipes for balanced acquisition
Copyright © 2026 GroupeZ|Build #loading...|-