🧥 Armament

The Armament mod enables you to create various sets of custom armor using resource packs. You're given flexibility in customizing the appearance and characteristics of your character's equipment.

🛡️ Main Features

• Unique Armor Creation — easily add your own armor sets to the game.
• Automatic Resource Pack Generation — the system automatically generates resource packs based on your configuration.
• Intuitive Graphical Interface — uses a user-friendly interface for convenient armor selection and viewing.
• Performance Optimization — developed with efficient server performance in mind.
• Easy Configuration — customize armor through YAML files and convenient commands.
• Compatibility — works with Minecraft versions from 1.20 to the latest releases.

💻 Available Commands

Set of administrative commands for managing custom armor:

• /armament reload — reload configuration without server restart.
• /armament give <armor_name> <piece> [player] — grant specific equipment piece.
• /armament giveset <armor_name> [player] — grant complete armor set.
• /armament gui — open graphical interface for set selection.

🔒 Permissions

Access to all administrative functions is provided by the armament.admin permission.

📋 Installation and Setup

1. Download the latest plugin version and place the .jar file in your server's plugins directory.
2. Restart the server to activate the mod.
3. Edit the armors.yml file in the plugins/Armament/ folder to configure your own armor sets:

armors:
  epic_armor:
    custom_model_data: 1
    helmet:
       name: "&6Epic Helmet"
       lore:
       - "&7Unique Epic Armor!"
    chestplate:
       name: "&6Epic Chestplate"
       lore:
       - "&7Unique Epic Armor!"
    leggings:
       name: "&6Epic Leggings"
       lore:
       - "&7Unique Epic Armor!"
    boots:
       name: "&6Epic Boots"
       lore:
       - "&7Unique Epic Armor!"

4. Place texture files in the appropriate folders:

• Main textures: source_files/layer_files/
• Display items: source_files/item_files/ (optional)

5. Upload the generated resource pack to your server and specify the path in the server.properties file:

🎨 Creating Custom Textures

Use the armor_model.bbmodel template model to create unique armor textures. Textures must follow Minecraft armor structure and specific naming conventions:

For main files (source_files/layer_files/ section):

• armorName_layer_1.png — texture for helmet, chestplate, and boots
• armorName_layer_2.png — texture for leggings

For individual item textures (source_files/item_files/ folder, optional):

• armorName_helmet.png
• armorName_chestplate.png
• armorName_leggings.png
• armorName_boots.png

Textures must match the names specified in the configuration file armors.yml.

📞 Support

Technical issues are addressed through the official GitHub repository or Discord.

📜 License

The project is distributed under Apache 2.0 license.