09. Weapon Categories

The Weapon Categories system allows register brand-new weapon classifications from JSON. This forms the foundation for applying customized animations, guard skills, and models specifically to your unique weapon types.

---

📁 File Locations & Loading Methods

Depending on whether you want users to be able to modify categories locally or bundle them inside your mod/resource pack, choose one of the following paths:

⚙️ Option A: Local Config Folder

Use this path if you want the setup to be easily accessible/editable by servers or pack devs.

• Path: .minecraft/config/epicfight_edp/weapon_builder/category/*.json
• ⚠️ Rule: You MUST explicitly declare the modid field inside the JSON when using this folder.

📦 Option B: In-Jar (Bundled Data-Driven)

Use this path to ship categories natively pre-configured inside your mod jar file or data-driven setup.

• Path: data_driven/<your_modid>/weapon_builder/category/*.json
• 💡 Rule: The modid field can be safely omitted inside the JSON because the directory's namespace acts as the fallback signer automatically.

---

📄 JSON Structure & Schema

Here is the precise structure required to build a custom weapon category (e.g., registering a hyper_sword category under the my_modid namespace):

{
  "weapon_category_builder": [
    {
      "modid": "my_modid",
      "category": [
        "hyper_sword"
      ]
    }
  ]
}