UberEnchant

---

---

---

Affiliates

Thinking about getting a dedicated server? Try Kinetic hosting!
Save 15% on your first month by using code 'UberDiscount' at checkout!
Click the image or link below to get started now!

https://billing.kinetichosting.net/aff.php?aff=340

---

Description

Ever wanted to have ridiculous enchants on your items? Then use UberEnchant! This plugin allows you to add enchants of any level* (yes, level 5 , only tested to level 15,000) to any item. This includes food, tools, swords, armor, blocks, but the enchant will not stay on the item if it is placed. Be careful to not lose the items you enchant, as they are all powerful and can get into the wrong hands.

*Limited to 255 internally by Minecraft since 1.17

---

Features

Support of Minecraft 1.17.1+ (Since Beta 8.11.2)

Economy Support

• Requires Vault!

WorldGuard Support! (Since UberEnchant 8.11.8)

• Custom enchantments respect the following flags:
  
  • pvp
  • damage_animals
  • potion_splash

Towny Support! (Since UberEnchant 8.12.1)

• Custom effect enchantments should respect Towny's protections

ProtocolLib Support! (Since UberEnchant 8.12.1)

• Used to fix the "Too Expensive" issue on the anvil

ExcellentEnchants Compatible! (Since UberEnchant 8.12.1)

• Custom effect enchantments appear alongside ExcellentEnchants enchantments on the Enchantment Table

Enchantments!

• Add
• Remove
• Any item
• Almost any level*
• Hide/Show (UberEnchant 8.9.7+)

*Limited to 255 internally by Minecraft since 1.17

Custom Enchantment Api! (Since Beta 8.10.0)

UberEnchant now has a custom enchantment api developers can utilize to create customized enchantments easily!

• JavaDocs can be found at https://coltonj96.github.io/UberEnchant/
• An example plugin can be found at https://github.com/coltonj96/UberEnchantApiExample/

Meta Tags (For UberEnchantments/Effect Enchants added by UberEnchant only, Since UberEnchant 8.11.8)

• Add
• Remove
• Set
• Current Meta Tags:
  - duration (Duration of the effect in seconds IE 1.5 is One and a half seconds)
  - has_chance (Whether or not this effect should have a chance of activating)
  - chance (A value between 0.0 and 1.0, 1.0 being 100%. The chance the effect activates when has_chance is true)
  - hidden (Sets whether the custom enchantment should show up on the item or not)
  - level (Just another way to set the effects level)
  - on_consume (If true, the effect applies when a player consumes an item such as eating steak)
  - on_held (If true, the effect is applied while the player is holding the item)
  - on_drop (If true, the effect applies to the player when the item is dropped)
  - on_pickup (If true, the effect will apply to the player when the item is picked up)
  - on_projectile (Used on bow/crossbow. If true, the effect will apply to the player when the bow/crossbow is fired. Can be used with 'on_chance' and 'chance' to give random chance to activate Since 8.12.5)
  - on_shield (Used on shield. If true, the effect will apply to the player while blocking with a shield, Since 8.12.6)

Item Attributes! (Since 8.12.2)

• Easy to use commands allow adding attributes to items
• Ability to add/set/remove attributes

Potion Effects! (Vanilla potion effects only. Add effects to items from Beta 8.9.8+.
Beta 8.10.0 changes these over to custom enchantments)

• Add
• Remove
• Any item (Version 8.10.0 removes this for items in favor of custom enchantments. Must be holding item when issuing the command)
  Effects added to items will apply the effect to what is hit IE hitting a player or mob
  Effects added to armor will apply upon taking damage
  (Positive/Neutral effects apply to the wearer and Negative effects apply to the attacker.)
  (Version 8.11.6 changes how effect enchantments behave, such as applying speed effect enchantment to boots gives the wearer speed effect)

Custom game mechanics!

Enchantment tables (Since beta 8.11.0):

• Acts just like a Vanilla enchantment table
• Uses xp/lapis
• Custom enchantments appear in the Vanilla enchantment table as extra enchantments
• Vanilla enchantments can appear higher levels than Vanilla (max level can be changed in the enchantment config)
• Can be turned off in config.yml (Moved to 'mechanics/enchantment_table.yml' since Beta 8.11.2)
• Allow only specific enchantments to appear, specified in 'mechanics/enchantment_table.yml' (Beta 8.11.2)
• Adds a 'Floor Bonus' (Beta 8.11.5)
  Acts just like bookshelves but increases the limit from 15-22 max bonus to 40 max bonus using the floor, allowing up to Level 10 enchantments at the enchantment table.
  • Placed under the enchantment table
  • Customize the floor block types and bonus values (Since 8.11.6)
  • By default, floor bonus uses iron blocks, gold blocks, emerald blocks, diamond blocks, and netherite blocks for bonus, 9 blocks max for floor bonus. Any combination works.
    Iron adds 0.25 per block for max 2.25 added bonus
    Gold adds 0.5 per block for max 4.5 added bonus
    Emerald adds 0.75 per block for max 6.75 bonus
    Diamond adds 1.0 per block for max 9 bonus
    Netherite adds 2.0 per block for max 18 bonus

Anvils (Since beta 8.11.0):

• Acts just like Vanilla anvils
• Uses xp
• Custom enchantments can be used in anvils
• Vanilla enchantments can be combined to higher levels than Vanilla as defined in the enchantment configs
• Can be turned off in config.yml (Moved to 'mechanics/anvil.yml' since Beta 8.11.2)
• Use color codes/hex colors in anvil (Since Beta 8.11.2, enabled in 'mechanics/anvil.yml')
• Adds ability to enable and specify a maximum cost on anvil (Since 8.12.1, enabled in 'mechanics/anvil.yml')
• When items with colors/formatting placed in the first slot of anvil allow editing their format/keeping it when using anvils (Merging two items will keep formatting of the first slot) (Since 8.12.4)
• When combining an item with a display name with more than 50 characters losing the charcters past 50. If any change is made to the display name while on the anvil, the long name is lost in favor of the change. (Since 8.12.4)

Villager Trading (Since 8.12.2):

• Custom UberEnchantments appear in villager trades for enchanted books
• Can be turned off in 'plugins/UberEnchant/mechanics/villager.yml'

Grindstone (Since 8.12.2):

• UberEnchantments get removed/give xp when using the grindstone
• Can be turned off in 'plugins/UberEnchant/mechanics/grindstone.yml'

Lore!

• Color codes
• Hex colors supported (UberEnchant 8.9.3+, 1.16+, requires spigot/paper, Spigot/Paper not required since 8.12.4)
  Hex format: #000000 or #000
  Hex example for red: #ff0000This is red
• Add
• Remove
• Set
• Add/Set a blank line with "/uadd lore %null" or "/uset lore <line> %null" (Version 8.9.2+)

Item Names!

• Color codes
• Hex colors supported (UberEnchant 8.9.3+, 1.16+, requires spigot/paper)
  Hex format: #000000
  Hex example for red: #ff0000This is red
• Set
• Clear

Locale Support! (Since version 8.9.15) (Send translations and they'll be added!)
Supported:

• EN_US

Permissions!

• https://dev.bukkit.org/projects/uberenchant/pages/permissions

---

Commands

• Color Codes Supported!!
  
• Hex colors supported (UberEnchant 8.9.3+, 1.16+, requires spigot/paper)
  Hex format: #000000
  Hex example for red: #ff0000This is red
• /uadd enchant <enchantment|alias> <level>
  Adds <enchantment> with <level> to held item
• /uadd enchant all <level>
  Adds all enchantments with <level> to held item
• /uadd effect <effect|id> <duration> <level>
  Gives you the specified potion effect with duration in seconds (with empty hand)
  Adds the effect to an item when holding the item
• /uadd meta <enchant> <tag> <value> (Since UberEnchant 8.11.8)
  Adds <tag> to <Enchant>
• /uadd name <text...>
  Appends <text...> to the displayname
• /uadd lore <text...>
  Appends <text..> to the list of lore
  Using %null as the text will add an empty line
• /uadd attribute <attribute> <value> <operation> [group]
  Adds <attribute> with <value> via <operation> to an item, optionally specifying [group]
• /ucost add <enchant|alias> <level>
  Check cost of adding level <level> <enchant>
• /ucost del <enchant|alias>
  Check cost of deleting enchant
• /ucost extract <enchant|alias>
  Cost of extracting an enchant
• /uset hidden <true|false>
  Sets enchantments to be hidden/shown (UberEnchant 8.9.7+)
• /uset meta <enchant> <tag> <value> (Since UberEnchant 8.11.8)
  Sets <tag> on <Enchant> to <value>
• /uset name <text...>
  Sets the display name of the item to <text...>
• /uset lore <line#> <text...>
  Sets the lore on <line#> to <text...>
  Using %null as the text will set an empty line
• /uset attribute <key> <value | operation | group> <value>
  Sets specified data of <key> to <value>
• /uset unbreakable <true | false>(Since UberEnchant 8.12.4)
  Sets the held item to be unbreakable or not
• /udel enchant <enchantment|alias>
  Removes <enchantment> from held item
• /udel effect <effect|id>
  Removes specified potion effect from your character (When holding nothing)
  Removes specified potion effect from your held item
• /udel meta <enchant> <tag> (Since UberEnchant 8.11.8)
  Removes <tag> from <Enchant>
• /udel name
  Removes the display name of held item
• /udel attribute <key>
  Removes the attribute <key> from the item
• /uextract <enchant|alias>
  Extracts the specified enchantment from held item
• /uinsert lore <line#> <text...>
  Inserts <text...> after the lore on <line#>
  Using %null as text will insert an empty line
• /uitem save <item>
  Saves held item using <item> as an identifier (items currently get overwritten when using the same name for two different items)
• /uitem load <item> [player]
  Loads <item> from file and gives to the player, optionally giving to specified player
  This also enables kit plugins(like essentialsX) to give players predefined items with custom enchantments/data
  (To add the command to a kit with essentialsX add '/uitem load <your item name here> {USERNAME}' to the kit under the items list)
• /uitem delete <item>
  Deletes <item> from file
• /uclear enchant|lore|effect
  Resets the held item or potion effects
• /ulist
  List the available enchantment values
• /ureload
  (Since 8.10.1)
  Reloads any custom enchantment configs to allow changes to take effect
• /uhelp
  Lists all the commands

---

Current enchants and potion effects:

Use the in-game command (/ulist) to see enchantments

---

Planning

• Custom villager mechanics regarding enchanted books/gear
• Custom fishing mechanics regarding enchantments found while fishing
• Send us Ideas!

---

Feedback

Please Leave Feedback For:

• Issues
• Suggestions
• Comments

---

Other Notes

1. Implements Plugin Metrics To Collect Data _{(Can Be Opted Out Of By Editing The Config In "/plugins/ Plugins Metrics/config.yml")}
   • Plugin Metrics Collects:
     • A unique identifier
     • The server's version of Java
     • Whether the server is in offline or online mode
     • The plugin's version
     • The server's version
     • The OS version/name and architecture
     • The core count for the CPU
     • The number of players online
     • The Metrics version
2. Implements BStats (Same idea as Plugin Metrics above)
3. Implements FastStats (Same idea as BStats)

---