12. Item Properties

Modify some properties regarding your items

💡 What's New in v2.2: In older versions, a tag system was used, which caused several problems, such as it not working in NeoForge 1.21.1, or being cumbersome to use in Forge 1.20.1. Now a config JSON file is used!

---

📁 File Location

Place your configuration files here:
data/<item_namespaces>/weapons_item_properties/<item_id>.json

---

📄 File Structure & Schema

Field	Description	Valid Options
combat	array	Allows configure some aspects of the item's combat.
interaction	array	Allows you to configure the item's interactions.

Config Example

In this example, we've configured an item to remove its special abilities and qualities that trigger when it damages an entity. We've also added the "use item" ability (only applicable if a Weapon Passive exists). Additionally, we've modified its Use animation when using the right-click function.

This use animation does not overlap with the Guard animation. The Guard animation will always take priority!

{
  "combat": {
    "disable_hurt_enemy": true
  },
  "interaction": {
    "force_use_method": true,
    "use_animation": "epicfight:biped/skill/guard_longsword"
  }
}