EpicArmor Plugin

A simple Spigot plugin that adds custom, craftable Netherite armor with unique potion effects and a configurable crafting limit.

tested versions

1.21.8 paperMC

Features

• Custom Crafting Recipes: Adds special crafting recipes for epic armor pieces.
• Unique Potion Effects: Each armor piece grants a configurable potion effect when worn.
• Crafting Limit: Set a maximum number of times the armor can be crafted.
• Unbreakable Armor: All epic armor pieces are automatically made unbreakable.
• Command: Use /resetarmor to reset the crafting limit for all players.

Configuration (config.yml)

You can easily configure the plugin to fit your server.

max_crafts:
  epic_helmet: 1
  epic_chestplate: 1
  epic_leggings: 1
  epic_boots: 1

armor_settings:
  epic_helmet:
    name: 'Epic Helmet'
  epic_chestplate:
    name: 'Epic Chestplate'
  epic_leggings:
    name: 'Epic Leggings'
  epic_boots:
    name: 'Epic Boots'
  default_armor_name: 'Epic Armor'

armor_effects:
  4: # CustomModelData for Epic Helmet
    effect: 'NIGHT_VISION'
    amplifier: 0
    duration: 300 # in ticks (20 ticks = 1 second)
  3: # CustomModelData for Epic Chestplate
    effect: 'RESISTANCE'
    amplifier: 0
    duration: 300
  2: # CustomModelData for Epic Leggings
    effect: 'SPEED'
    amplifier: 0
    duration: 300
  1: # CustomModelData for Epic Boots
    effect: 'JUMP_BOOST'
    amplifier: 1
    duration: 300

recipes:
  epic_helmet:
    pattern:
      - 'AAA'
      - 'ABA'
      - '   '
    ingredients:
      A: NETHERITE_INGOT
      B: NETHERITE_HELMET
  # ... (Similar recipes for other armor pieces)

### Configuration Details

* **`max_crafts`**: Set the maximum number of times a player can craft each armor piece. Set the value to `-1` for unlimited crafting.
* **`armor_settings`**: Change the display name of each armor piece. You can use color codes (e.g., `&b` for blue).
* **`armor_effects`**: Customize the potion effects for each piece. The number (e.g., `4`) corresponds to the `CustomModelData` you've set in the plugin code.
    * `effect`: The name of the potion effect (e.g., `NIGHT_VISION`, `SPEED`, `RESISTANCE`).
    * `amplifier`: The strength of the effect (0 for level I, 1 for level II, etc.).
    * `duration`: The duration of the effect in ticks. 20 ticks = 1 second.
* **`recipes`**: Define the crafting pattern and required ingredients for each epic armor piece.

---

## Commands & Permissions

* `/resetarmor`
    * **Permission:** `epicarmor.reset`
    * **Description:** Resets the crafting limit for all players, allowing them to craft the epic armor pieces again.
This isnt the real config. Its just an example. Please use the format how the plugin generates it.