AttributeModify: Customize Item Attributes in Minecraft

Mastering Item Customization with Attribute Modify in Minecraft

Minecraft modding has always been about pushing boundaries, but few tools give you the sheer flexibility to reshape item behavior without writing a single line of Java. The Attribute Modify family—AttributeModify for Forge 1.20.1 and NeoAttributeModify for NeoForge 1.21.1—lets you control attributes, mining speed, durability, and even quality tiers using clean JSON datapacks. Whether you’re a server owner balancing gear or a modpack creator weaving progression systems, this duo opens up a world of possibilities.

What Exactly Is Attribute Modify?

At its core, Attribute Modify is a datapack-driven system that overrides or extends how items work in Minecraft. You can add, modify, or remove attributes on any vanilla or modded item, target specific equipment slots, and even hook into Curios. The two versions share the same folder layout and JSON style, so migrating between them is straightforward. The main internal difference is that the 1.20.1 edition reads NBT-style data, while 1.21.1 evaluates data components. For cross-version packs, you can use component-like paths such as component:apotheosis:rarity to keep your configs maintainable.

Key Features That Redefine Item Behavior

• Attribute manipulation – Add, modify, or remove attributes on items, with support for shorthand syntax that auto-detects slots.
• Slot targeting – Apply rules to standard equipment slots (mainhand, offhand, head, chest, legs, feet, body) or optional Curios slots.
• Tag-wide rules – Affect entire item tags like #minecraft:swords with a single entry.
• Conditional matching – Use NBT or component operators (equals, not_equals, greater, exists, matches_regex, and more) to apply attributes only when certain conditions are met.
• Mining overrides – Change mining speed and tier per item, optionally gated by conditions.
• Durability control – Override max durability and set custom durability triggers (melee_hit, block_break, right_click).
• Quality system – Roll weighted random quality tiers on item creation, with triggers for crafting, loot, villager trades, and Apotheosis sync.
• Decorative flag – Mark items as decorative to prevent accidental use.
• Hot-reload and multiplayer sync – Use /reload to refresh datapacks without restarting; servers automatically sync attribute, mining, durability, and decorative data to clients.

Getting Started with Datapacks

All configuration lives in data/<namespace>/item_attributes/<file>.json. Entries from multiple files merge seamlessly, so you can organize your datapack however you like. No Java compilation, no complex modding setup—just edit JSON and reload. For those who want an even smoother experience, the mod can be easily installed via the foxygame.net launcher, a convenient, flexible, and modern Minecraft launcher where you can download mods right from the menu, making it a breeze to keep your instance up to date.

Practical Examples to Spark Your Creativity

Let’s walk through a few real-world scenarios. The syntax is intuitive once you see the patterns.

Quick Attribute Boost

Give diamond chestplates a luck bonus with automatic slot detection:

{
  "minecraft:diamond_chestplate": {
    "attribute": "minecraft:generic.luck",
    "action": "add",
    "amount": 1.0,
    "operation": "add_value"
  }
}

Multiple Attributes on Boots

Stack armor and movement speed on diamond boots:

{
  "minecraft:diamond_boots": {
    "attributes": [
      { "attribute": "minecraft:generic.armor", "action": "add", "amount": 1.0, "operation": "add_value" },
      { "attribute": "minecraft:generic.movement_speed", "action": "add", "amount": 0.03, "operation": "add_multiplied_total" }
    ]
  }
}

Explicit Slot Control

Modify attack damage and remove attack speed on diamond swords in the mainhand:

{
  "minecraft:diamond_sword": {
    "equipment_slots": {
      "mainhand": [
        { "attribute": "minecraft:generic.attack_damage", "action": "modify", "amount": 10.0, "operation": "add_value" },
        { "attribute": "minecraft:generic.attack_speed", "action": "remove" }
      ]
    }
  }
}

Curios Integration

Boost max health when a magic ring is in a Curios ring slot (requires Curios):

{
  "mymod:magic_ring": {
    "curios_slots": {
      "ring": [
        { "attribute": "minecraft:generic.max_health", "action": "add", "amount": 4.0, "operation": "add_value" }
      ]
    }
  }
}

Tag-Based Knockback

Add knockback to all swords in the game:

{
  "#minecraft:swords": {
    "equipment_slots": {
      "mainhand": [
        { "attribute": "minecraft:generic.attack_knockback", "action": "add", "amount": 0.5, "operation": "add_value" }
      ]
    }
  }
}

Conditional Attributes with Apotheosis Rarity

Apply extra damage only to mythic diamond swords:

{
  "minecraft:diamond_sword": {
    "equipment_slots": {
      "mainhand": [
        {
          "attribute": "minecraft:generic.attack_damage",
          "action": "add",
          "amount": 5.0,
          "operation": "add_value",
          "nbt": { "path": "component:apotheosis:rarity", "operator": "equals", "value": "apotheosis:mythic" }
        }
      ]
    }
  }
}

Quality System

Assign random rarity tiers to iron swords when crafted, looted, or traded:

{
  "minecraft:iron_sword": {
    "quality_system": {
      "tag_path": "quality",
      "triggers": ["craft", "loot", "villager_trade", "apotheosis_sync"],
      "levels": [
        { "value": "common", "weight": 60 },
        { "value": "rare", "weight": 30 },
        { "value": "mythic", "weight": 10 }
      ]
    }
  }
}

Mining and Durability Overrides

Set a mythic iron pickaxe to mine at diamond tier and speed, and give diamond pickaxes 3000 durability that depletes on block break or right-click:

{
  "minecraft:iron_pickaxe": {
    "mining": [
      { "speed": 12.0, "tier": "diamond", "nbt": { "path": "quality", "operator": "equals", "value": "mythic" } },
      { "speed": 8.0, "tier": "iron" }
    ]
  },
  "minecraft:diamond_pickaxe": {
    "durability": 3000,
    "durability_triggers": ["block_break", "right_click"]
  }
}

Multiplayer and Reloading

One of the standout features is how seamlessly it works in multiplayer. Run /reload and your datapack changes take effect instantly—no server restart needed. All attribute, mining, durability, and decorative data syncs to clients automatically, so everyone sees the same custom behavior. This makes balancing on a live server a stress-free process.

Compatibility and Advanced Tips

Attribute Modify plays nicely with both vanilla and modded items. Curios support is optional, and Apotheosis-style data checks are built right in through conditional matching. If you need fixed custom modifier identities for inter-mod compatibility, use the modifier_id field. The shorthand syntax and tag-wide rules keep your datapacks concise, while the full slot-by-slot control gives you precision when you need it.

Conclusion

Attribute Modify transforms the way you think about item stats in Minecraft. By moving complex attribute logic into datapacks, it democratizes modding for server admins, pack makers, and tinkerers who want deep customization without a Java IDE. The dual-version approach ensures you can stay on your preferred mod loader while enjoying a consistent, powerful feature set. Start with a small attribute tweak, then build entire progression systems—the only limit is your imagination.

--- **Update Jul 3, 2026:** Added 4 files for version 1.21.1, 1.20.1 (NeoForge, Forge).