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.

---

🔄 Matrix (Valid Pairings)

• disable_hurt_enemy ➡️ when we want to disable the item's qualities that are executed when an entity is impacted.
• force_use_method ➡️ We force the object to have a "right click" function; this is useful if for some reason the right click function breaks and prevents interaction with some passive or active functions.
• use_animation ➡️ Adds an animation when using the right click; this animation does not conflict with the guard animation.

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 PassiveSkill 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"
  }
}