This plugin adds a whole bunch of awesome new Items and enchantments that are independent of the Minecraft Enchantment system.
This is my first plugin and at the same time my first Java Project.
For Suggestions/Commissions/Bugs/etc., leave a comment below.
If you want to see the plugin in action, check out the following servers!
Current official Servers:
Videos of the Plugin
Please note that the following Videos were made using older versions of the plugin:
- /ce - The main command node for Custom Enchantments
Please note that for any command after the main node, you do not have to enter it's full name, the first letter is enough (Example: /ce list = /ce l).
Words in angle Brackets ( < > ) mean that the argument is required, while words written in square Brackets ( [ ] ) are optional.
- /ce runecrafting - Opens the runecrafting inventory.
- /ce menu - Opens an inventory menu for navigating and obtaining Custom Enchantments and Items.
- /ce reload - Reloads the CE config.
- /ce remove [Enchantment] - Removes an enchantment (or all of them) from an item.
- /ce list <Enchantment/Item> - Lists all Custom Enchantments or Items.
- /ce enchant [Required material] <Enchantment> [level] - Adds the specified Enchantment to the item in your hand. If a required material is given, the command will only work if the player holds that item. If an item already has the enchantment, the level will be increased.
- /ce item <Item> - Transforms the item in the player's hand into the specified Custom Item.
- /ce change <Name/Lore> <Color/Set/Add/Reset> [New Value] - Allows you to change the name/lore of the item in your hand
- /ce give <Player> <Material> <Item/Custom or Vanilla Enchantment:Level> [Custom or Vanilla Enchantment:Level] ... - Gives the target player an item with the set material containing the given Enchantments. Please note that the Material has to be either the Minecraft material ID or the Bukkit material ID. The same goes for the Vanilla enchantment names. You can add infinite vanilla and custom enchantments to the item using this command.
Version 2.4 added a feature called Runecrafting that allows enchantments to be put on books.
They can be created using /ce ench or /ce menu, given through /ce give and obtained by enchanting a book using the enchanting table.
If disenchanting is enabled, enchanted items can also be turned into enchantment books.
Using an enchantment book or an enchanted item on an Anvil will open the Runecrafting inventory, which can also be opened by using /ce menu or /ce runecrafting. The lower slot requires the enchanted item while the top slot requires the item to enchant.
If you are using version 2.2 or higher of the plugin, you can sell Enchantments by setting up a sign in the following format:
- "[CustomEnchant]" (Without the "s) as the first line.
- The Enchantment you want to sell as the second line.
- The cost of the enchantment as the fourth line. This requires Vault and a compatible economy plugin
Players that do not have the enchantment will have the enchantment applied to their current item, if they already have the enchantment they are trying to buy, the level of the enchantment will increase by 1, up to the specified maximum level of the Enchantment (Can be set in the config).
If you have Vault installed, you can set a price for the Items/Enchantments through the config. The items and enchantments can then be bought in /ce menu.
CE's in Kits
To add Custom Enchantments and Items into kits, follow this guide:
- Check out if your kit plugin supports colored names and/or lores.
- Find example kits that add colored names and/or lores in your kit plugin
- For items, set "name: <Item>", for Enchantments, set "lore: <Enchantment>". You may have to find out how to add multiple lines of lore via your kit plugin
The <Item> is structured like this: <Colorcode of the Item><The full Itemname>, the <Enchantment> is defined as: <Colorcode of the Enchantments><EnchantmentName> <Level in roman numerals>
The Colorcodes can be found on this site.
Lifesteal would be "lore: &4&oLifesteal" (If you didn't change the standard color of the enchantments) &4 stands for the Color Dark Red, &o stands for the name being italic
In essentials, Lifesteal II and Poison III would be "lore: &4&oLifesteal II|&4&oPoison III" (Note: the '|' in the middle of the two enchantments seperates multiple lines in the lore of the kits made by essentials)
Flamethrower would then be "name: &4Flamethrower"
To make it faster and easier for me to help you with bugs and errors occuring, please send me a pm containing the following information:
- What version are you using? (See the Point Further Information to find out if a newer Version is avaivable)
- Does your console give you any errors? If yes, please send me a copy of them, this might make the further steps obsolete.
- What situation did the error occur in?
- Can you reproduce the error or does it happen randomly?
If you want to support development, you can donate by clicking here. It really helps me out a lot and I am thankful for every single donation, no matter how small :)
If you want to contribute to Custom Enchantments or just want to take a look at the source code, you can check out the official repository of Custom Enchantments. Please note that the project was not originally designed for the public, so the project contains little to none documentation.
Current Version: 2.4c
Things that are planned for the future can be found here and you are also free to leave suggestions on there aswell
The main page for older versions can be found here.