CustomArmor 1.2

Create your own armor with enchants and effects!

  1. XxTheEnderGodxX
    Tested Minecraft Versions:
    • 1.7
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    Custom Armor:
    This plugin was made using Dropix's idea.
    This was a plugin request made from the Bukkit Plugin Requests :)
    The plugin lets server owners add enchants, effects a Name and a Lore to armor, which can be crafted with a custom crafting recipe.

    This plugin can allow players to craft armor with custom effects and can let players have fun using their new set of armor. Making a lot of armor could even end up with players deciding what types of armor is the best and the best mixes to make variations of armor on the server.
    Commands:
    In future updates, I will be adding more commands. Here is a list of the current ones:
    - /careload - Reloads the config file and the crafting recipes.

    Permissions:
    With more commands in the future will come more permissions, here is a list of the current permissions:
    - customarmor.admin

    Configuration:
    The config file gives you the ability to create new armor and crafting recipes, and with certain enchants and effects.

    Code (Text):

    config:
      defaults:
        prefix: '&b&lCustomArmor&2>>'
        no-perm: '&cYou do not have permission to run this command!'
      custom-armor:
        '1':
          Item: IRON_BOOTS
          Amount: 1
          Meta:
            Name: '&b&lSpeedy Boots'
            Lore: '&aGotta blast!'
          Enchants:
            PROTECTION_FALL: 5
            DURABILITY: 3
          Effects:
            SPEED: 4
            DAMAGE_RESISTANCE: 2
          Craftable: true
          Recipe:
            Row1: '   '
            Row2: T T
            Row3: X X
            Ingredients:
              T: IRON_INGOT
              X: NETHER_STAR
        '2':
          Item: DIAMOND_CHESTPLATE
          Amount: 1
          Meta:
            Name: '&7&lHeavy Protection'
            Lore: '&bProtect'
          Enchants:
            PROTECTION_ENVIRONMENTAL: 5
            DURABILITY: 3
          Effects:
            SLOW: 2
            DAMAGE_RESISTANCE: 4
          Craftable: true
          Recipe:
            Row1: I I
            Row2: DID
            Row3: III
            Ingredients:
              D: DIAMOND
              I: IRON_BLOCK
        '3':
          Item: GOLD_LEGGINGS
          Amount: 1
          Meta:
            Name: '&r&lAngelic Leggings'
            Lore: '&r&lAngels protect you with &aRegen'
          Enchants:
            PROTECTION_ENVIRONMENTAL: 5
            DURABILITY: 3
          Effects:
            REGENERATION: 1
            HEALTH_BOOST: 2
          Craftable: true
          Recipe:
            Row1: GGG
            Row2: A A
            Row3: A A
            Ingredients:
              G: GOLD_INGOT
              A: GOLDEN_APPLE
        '4':
          Item: LEATHER_HELMET
          Amount: 1
          Meta:
            Name: '&6&lRusty Helmet'
            Lore: Rusty, but still protective
          Enchants:
            PROTECTION_ENVIRONMENTAL: 2
            DURABILITY: 3
          Effects:
            WATER_BREATHING: 1
          Craftable: true
          Recipe:
            Row1: ' W '
            Row2: ILI
            Row3: L L
            Ingredients:
              L: LEATHER
              I: IRON_INGOT
              W: WATER_BUCKET
        '5':
          Item: IRON_SWORD
          Amount: 1
          Meta:
            Name: '&5&lDagger'
            Lore: '&7Fast like a ninja!'
          Enchants:
            DAMAGE_ALL: 2
            DURABILITY: 10
          Effects:
            SPEED: 5
            INCREASE_DAMAGE: 1
          Craftable: true
          Recipe:
            Row1: ' I '
            Row2: ISI
            Row3: ' S '
            Ingredients:
              I: IRON_INGOT
              S: STICK
     

    In the configuration, you find the default 4 pieces of armor. It is to demonstrate the usage of the configuration file. It uses different pieces of armor and different enchants/effects some being the same.
    If after your reboot, or server startup, rows can sometimes be buggy and leave an apostrophe before and after that row, for example, it may show the following:

    Code (Text):

            Recipe:
              Row1: ' W '
              Row2: ILI
              Row3: L L
     

    This is completely normal and if you would like you can add the apostrophes to make it back to normal, but either way it should scan. I will in future updates be trying to fix this bug. But for the moment, it still does scan it properly and the outcomes are working crafting recipes.
    There is also an option for an item being craftable, if set to true, it will register the new recipe, if set to false, it will not register the recipe, but you can make one anyway just in case you would like to add it in the future. This option will also be needed for the future update. In the plugin request it was said to have no commands, but to make it easier I added one to this version. The next will have a command to spawn in the armor instead of crafting. This could make these custom armor items rare.
    Now for setting up an item, if you understand the above configuration then you can download, start the server and start making your custom armor! For those who need it, here is a tutorial on how to setup your new items!

    1. You can start off first by copying and pasting the blank template from below:
    Code (Text):

          '#':
            Item: 'ITEM'
            Amount: 1
            Meta:
              Name: 'Name'
              Lore: 'Lore'
            Enchants:
              ENCHANT: 0
            Effects:
              EFFECT: 0
            Craftable: true
            Recipe:
              Row1: '   '
              Row2: '   '
              Row3: '   '
              Ingredients:
                A: MATERIAL
     

    This may look like a lot, and it is, but don't worry, we will go through it all in these steps :) We will get through this.

    2. In the template, after copying and pasting, we can start by replacing the '#' sign with a number. This line is shown below. This number can be any number as long as it hasn't been used yet by another custom armor piece. (I like to keep them in an ascending order going up by one like this: 1,2,3,4,5,6, etc.)

    Code (Text):

    '#': - This is what it looks like in the template

    '5': - This is what it will look like after you finish step 2 (but with whatever number you used)
     


    3. Now we can change the Item. In this step, you will replace 'ITEM' with whatever Armor you want. MAKE SURE THIS ITEM NAME IS IN CAPITALS AND IS THE BUKKIT NAME! (For example, if the piece of armor you choose is an Iron Chestplate, type 'IRON_CHESTPLATE')
    (For a list of all the Bukkit Item Names: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html)
    For the rest of explaining the configuration, anything that is in caps on the template you need to replace with capital letters.

    Code (Text):

          Item: 'ITEM' - This is what it looks like in the template

          Item: 'DIAMOND_CHESTPLATE' - This is what it should look like when you finish step 2. (But with whatever piece of armor you used)
     


    4. Next, we change the Name and Lore. For these, you can use whatever color codes you want and whatever words or phrases you want for the item name or item lore.

    Code (Text):

    This is what it looks like in the template:
            Meta:
              Name: 'Name'
              Lore: 'Lore'

    This is what it should look like after completing step 4:
    (But with whatever name and lore you typed.)
            Meta:
              Name: '&b&lCustom Armor'
              Lore: '&c&lWreck everyone!!!'
     


    5. Next up we change the enchants. In this, you can change ENCHANT: 0. You will change ENCHANT to a Bukkit Enchant Name in all caps. You can also create multiple of these lines, all with different enchants! Remember to only use the enchants that the version of your server supports! If it is 1.11 or below, it cannot support 1.12 enchants. After replacing ENCHANT, you can replace the number. But if the enchant was from 1.7 it could work in 1.7+ versions. This number is the level of the enchant (For example, PROTECTION_ENVIRONMENTAL: 4 would give us Protection 4.)
    Here is a link that shows all of the current Bukkit Enchants: https://docs.oc.tc/reference/enchantments

    Code (Text):

    This is what it looks like in the template:
            Enchants:
              ENCHANT: 0

    This is what it should look like after completing step 5:
    (But with whatever enchants and enchant levels you typed. Remember you can add as many enchants as you would like, in this case, I added two enchants, not one.)
            Enchants:
              PROTECTION_ENVIRONMENTAL: 4
              PROTECTION_FIRE: 2
     
    6. Next, we change the Effects. In this case, you will change EFFECT: 0. You will change EFFECT to the Bukkit potion effect you would like to give the player if they are wearing the armor. Remember to make this all caps. Then you can replace the 0 with a number, this is the potion amplfier. What it does is if the effect is, let's say, for example, REGENERATION, and this number was set to 1 (REGENERATION: 1), it would give us Regeneration 1. And like the enchants, if the effect is in a higher version than what your server runs on, it will not work. Also like the enchants, you can create multiple effects, as much as you like.

    Here is a link to all of the Bukkit Potion Effect Names: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/potion/PotionEffectType.html
    Code (Text):

    This is what it looks like in the template:
            Effects:
              EFFECT: 0

    This is what it looks like after finishing step 6. (But with whatever Effect you used, and whatever amplifier you used, and however much you added.):
            Effects:
              REGENERATION: 2
              DAMAGE_RESISTANCE: 2
     
    7. In our last step, we will cover the rest of the template. We start offsetting the value if you want the item to be craftable, to true, if you don't want it to be craftable then you can set it to false (but still follow the steps below for in case you would like to release it later, if not then at the moment, setting the value to false does nothing until the next update where you can spawn it in by command.) You then work on the Rows. These rows represent Row1, Row2, and Row3 of the crafting table. You put in in a letter for each different item you want to use. In the rows, you can only put a maximum of Three characters, if you leave a letter, it is one character, if it is a space, then that is one character. A space is means that there will be nothing on that slot of the crafting table. After setting up your Rows, you can move on to Ingredients. Here you add all the letters you used in your Crafting recipe or Rows. So if you used 'I' which stood for Iron, you would put I: IRON_INGOT. You would put whatever letter you used, and what material does it represent. Make sure that the material follows the bukkit name as well and in all caps.

    Here is the link to all of the bukkit item names: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
    Code (Text):

    This is what it looks like in the template:
            Craftable: true
            Recipe:
              Row1: '   '
              Row2: '   '
              Row3: '   '
              Ingredients:
                A: MATERIAL
    This is what it looks like after the template:
    (But with your own Craftable boolean value, your own recipe, and your own ingredients.)
            Craftable: true
            Recipe:
              Row1: 'D D'
              Row2: 'NAN'
              Row3: 'ONO'
              Ingredients:
                D: DIAMOND
                N: NETHER_STAR
                O: OBSIDIAN
                A: DIAMOND_CHESTPLATE
     


    That's it! You have now created your custom item! The end product would look something similar to this, but with whatever enchants, effects, materials, names and such that you chose:

    Code (Text):

          '5':
            Item: 'DIAMOND_CHESTPLATE'
            Amount: 1
            Meta:
              Name: '&b&lCustom Armor'
              Lore: '&c&lWreck everyone!!!'
            Enchants:
              PROTECTION_ENVIRONMENTAL: 4
              PROTECTION_FIRE: 2
            Effects:
              REGENERATION: 2
              DAMAGE_RESISTANCE: 2
            Craftable: true
            Recipe:
              Row1: 'D D'
              Row2: 'NAN'
              Row3: 'ONO'
              Ingredients:
                D: DIAMOND
                N: NETHER_STAR
                O: OBSIDIAN
                A: DIAMOND_CHESTPLATE
    Now you can go and create your own custom armor!
    Planned Updates:
    1. New Command to spawn in the custom item that you've made in the config file
    2. Fix bug with recipes in config
    3. Make a GUI with creating armor from ingame.
    4. Make custom weapons with custom effects
    5. Fixing any other bugs that may appear
    6. Implementing your suggestions that you can leave on the discussion page! :)

    If you have any errors or problems using the plugin, please leave them in the Discussion page. You can also leave suggestions for future updates there as well :)

Recent Reviews

  1. Fighter-HUN
    Fighter-HUN
    5/5,
    Version: 1.0
    This is amazing! i'm used on my server, it run is well!

    skyhero.mcraft.io

    Can you add more features?

    example:
    enchantments hiding and show options i think is good idea!

    sorry for my bad english
    1. XxTheEnderGodxX
      Author's Response
      I've send a chat, we can talk there and you can describe them a bit more for me :) Glad you enjoy it so far!
  2. TylerGalaxy
    TylerGalaxy
    4/5,
    Version: 1.0
    =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
    Pretty good plugin ! This is one of the thing i needed
    =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
    1. XxTheEnderGodxX
      Author's Response
      Thanks for the rating! I hope I can get to better updates for the plugin soon! If you have any suggestions for improvement don't hesitate to ask :)