Melee

🪓 Melee Weapons

Melee weapons are close-combat weapons designed for hand-to-hand fighting. They can deal significant damage to enemies at close range and often have unique abilities or effects.

---

📂 Folder Structure

.minecraft/
├── content-pack/
 └── items/
  └── melees/
   └── your_melee_item.json
 └── assets/
  └── niwer_engine/
   └── textures/
    └── item/
     └── melees/
      └── your_melee_item.png

---

🧾 Example JSON

{
	"inventoryVolume": {
		"x": 1,
		"y": 2
	},
	"damage": 7.5,
	"meleeType": "SHARP",
	"isThrowable": true,
	"isTwoHanded": false,
	"displayNames": {
        "en": "Your Melee Item",
        "fr": "Votre Arme de Mêlée"
    }
}

---

⚙️ Available Parameters

• damage : Integer — The amount of damage the melee weapon deals per hit.

• meleeType : MeleeEnumType — Defines the type of melee weapon (e.g., SHARP, BLUNT, DEFAULT). Used for the sound and the way the weapon will bounce on surfaces.

• isThrowable : Boolean — If true, the melee weapon can be thrown (with the right click).

• isTwoHanded : Boolean — If true, the melee weapon requires two hands to use effectively. This force the player to have is second hand free when holding the melee weapon.

• length : Float — Deprecated.

• range : Float — The radius within which the melee weapon's effects will apply.

• speed : Integer — Deprecated.

---

🖼️ Textures

Melee items textures are always located in the assets/niwer_engine/textures/item/melees/your_melee_item.png folder of your content pack.

---

Continue to the next section: create firearms