06. Weapon Models per Style

The Models per Style system allows you to dynamically swap a weapon's visual 3D model depending on the player's current combat style (stance).

💡 What's New in v2.2: I have completely deprecated the old, complex "Item Socket" channel system. Model overrides are now declared directly and cleanly by mapping the Combat Style to the target Model Path, making development significantly faster!

---

📁 File Location & Naming

Place your configuration files inside your resource pack or mod assets at:
assets/<mod_id>/weapons_model_properties/*.json

---

⚔️ Combat Application

In this case, we have a sword from the Simply Sword mod, which, when changing from Two Hand to Ochs, changes its texture

{
  "weapons_models": [
    {
      "item": "simplyswords:brimstone_claymore",
      "style_config": [
        {
          "style": "ochs",
          "model": "simplyswords:item/brimstone_claymore_blue"
        }
      ]
    }
  ]
}


https://github.com/user-attachments/assets/c71ee2db-0217-4283-9ff6-552edebc74c6