# AdvancedEnchantments Have questions? Pre-sale, support, or just want to talk? Join our support Discord for any type of help! ## Download AdvancedEnchantments From: **AdvancedPlugins.net:** \ **SpigotMC.org:** \ **Polymart:** \ **BuiltByBi**t: # AdvancedEnchantments UI Reimagined Menus and Icons for immersive experience

* Completely reimagined **Enchanter GUI** with new book icons and direct buttons to Tinkerer and Alchemist * Brand new **Tinkerer GUI** with unique layout and new icons * New **Alchemist GUI** with new icons and a new inventory layout * **Upgraded** default messages * **New 7x book icons** for Simple, Unique, Elite, Ultimate, Legendary and Fabled enchants
### Upgrade your AdvancedEnchantments UI here: #### How does this work? This uses ItemsAdder or Oraxen plugins to apply custom textures to AdvancedEnchantments menus. This is as simple as just installing one of those plugins, adding this pack and custom AdvancedEnchantments configuration - that's it!

Complete guide on how to install with those plugins (or just as a resource pack) is included within the pack files.\ \ **Full installation support is available for customers of this pack on our official AdvancedPlugins discord server, any questions or problems will be answered there.**
# List of Enchantments ***All** enchantments can be fully modified, deleted removed, and edited easily without any coding - that's what this plugin is all about!* ### Available Enchantments: {% hint style="success" %} **Enchantments List** (200+ enchants)**:** [**Click to see all enchantments**](/enchantments/list-of-enchantments/default-enchants-200+)\ Loaded by default with the plugin. {% endhint %} {% hint style="info" %} **Action-packed CosmicPvP enchantments** (200+ enchants)**:**[ **Click to see all enchantments**](/enchantments/list-of-enchantments/cosmic-enchants-200+)\ Load in-game using `/ae premade` command. {% endhint %} # Default Enchants (250+) 250+ new default enchants of AdvancedEnchantments. How to install? Use the command `/ae premade` in-game to install this enchantment pack! Preview: ![](https://286155643-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MI09GrzCaIdY780LjYd%2F-MVu3XtkW3muw_gw92Mq%2F-MVu3iy7-jRNiwTWz_KE%2FinstallPack1.gif?alt=media\&token=ed93da85-3063-4da2-b78a-21ed2e7d0014)

Enchantment	Description	Applies to	Rarity	Max Level
Enchantment	Description	Applies to	Rarity	Max Level
Abiding	Weapons with this enchant become unbreakable	Weapons	Legendary	1
Aegis	Chance to gain speed when taking fall damage.	Boots	Ultimate	3
Allure	Your attack pulls mobs towards you.	Swords	Elite	3
Ambit	Damages mobs within a radius that increases with the level of enchant.	Swords, Axes	Ultimate	7
Angelic	Heals health when damaged.	Armor	Ultimate	5
Auto Reel	Automatically reels in the fishing rod when it gets a bite.	Fishing Rods	Ultimate	4
Aqua	Deal double damage while in water.	Boots	Legendary	4
Aquatic	Breathe underwater.	Helmets	Simple	1
Archer	Increases damage dealt with bows.	Bow	Ultimate	4
Armored	Decreases damage from enemy swords by 2% per level.	Armor	Legendary	4
Arrow Break	Chance for arrows to bounce off you while holding item with this enchant.	Axe	Ultimate	6
Arrow Deflect	Chance to prevent enemy arrow from dealing damage.	Armor	Ultimate	4
Axe of Spirits	Chance to get more souls from killing players.	Axes	Fabled	3
Bait	Chance to receive double fishing drops.	Fishing Rod	Legendary	3
Barbarian	Chance to inflicts more axe damage.	Axes	Legendary	4
Beastslayer	Increases damage dealt to Hostile Mobs.	Swords, Axes	Legendary	4
Berserk	Chance of strength and mining fatigue.	Swords, Axes	Unique	5
Blacksmith	Repair your weapon in exchange for dealing less damage.	Axe	Legendary	5
Bleed	Make your opponent bleed.	Axes	Ultimate	6
Blind	A chance of causing blindness when attacking.	Swords	Elite	3
Block	A chance to negate an attack and deal up to 4 damage back.	Swords	Ultimate	3
Blunt Force	Chance to strike with great force.	Axes	Elite	4
Bone Crusher	Increases damage dealt to Skeletons.	Swords, Axes	Simple	3
Bowmaster	Multiplies damage against players who are wielding a Sword at the time they are hit.	Bow, Crossbow, Trident	Elite	5
Carrot Planter	Plant carrots in a 3x3 area by shift+right-clicking.	Hoes	Simple	3
Chaos	Deal weakness and wither effects.	Trident	Legendary	5
Chunky	Chance to receive less damage.	Chestplates	Legendary	6
Cleave	Damages players within a radius that increases with the level of enchant.	Axes	Ultimate	7
Confuse	Chance to give nausea effect.	Swords	Ultimate	4
Convulse	Chance to throw your attackers into the air.	Boots	Legendary	6
Creeper Armor	Chance to be immune to explosive damage, at higher levels you have a chance to heal.	Armor	Ultimate	3
Critical	Increase damage done with critical hit.	Swords	Elite	3
Curse	Chance to give your enemy mining fatigue.	Armor	Elite	2
Deadshot	Headshots with tridents deal double damage.	Trident	Legendary	5
Death Punch	Increases damage dealt to Zombies.	Swords, Axes	Simple	5
Decapitation	Chance to have opponents head drop on death.	Swords, Axes	Simple	3
Deranged	Strike lightning at nearby players.	Swords	Legendary	3
Devour	Chance to restore food while killing mobs.	Weapons	Unique	3
Diminish	Chance to give your enemy mining fatigue.	Axes	Ultimate	1
Diploid	Chance to multiply mob drops. Costs 5 souls / activation.	Swords	Fabled	5
Disappear	Chance to become invisible when low on health.	Armor	Ultimate	4
Disarm	Chance to disarm opponent.	Swords	Fabled	3
Disarmor	Chance of unequipping random armor piece from your opponent.	Sword	Legendary	8
Disintegrate	Chance to deal extra durability damage to all enemy armor with every attack.	Swords	Ultimate	4
Distance	Chance to distance yourself from your enemies and gain regeneration.	Weapons	Ultimate	4
Divert	Chance of poisoning opponent and gaining regeneration.	Armor	Legendary	5
Dodge	Chance to dodge physical enemy, chance increases when sneaking.	Armor	Ultimate	5
Double Strike	A chance to strike twice.	Swords	Legendary	3
Ender Slayer	Increases damage dealt to Enderman and Ender dragons.	Weapons	Elite	5
Endmaster	Double damage to mobs in End.	Swords	Ultimate	3
Epicness	Display particles on attack.	Swords	Simple	3
Exalted	A chance of removing bad potion effects.	Swords	Ultimate	4
Experience	Chance to get more experience from ores.	Tools	Simple	5
Explosive	Chance for arrows to explode.	Bow	Unique	5
Explosive Demise	Summon creepers as your guards when near death.	Leggings	Unique	8
Extinguish	Chance to extinguish yourself when on fire.	Leggings	Elite	3
Famine	A chance to give your opponent the hunger effect.	Weapons	Unique	4
Featherweight	Chance to get a burst of haste.	Swords, Axes	Unique	3
Forcefield	Chance to push away your opponent.	Swords	Simple	5
Frenzy	Chance for arrows to explode.	Crossbow	Unique	5
Frozen	Can cause slowness to attacker when defending.	Armor	Elite	3
Fire Hook	The hook is on fire.	Fishing Rod	Elite	3
Fuddle	Disorganize opponent's hotbar.	Swords	Ultimate	3
Fumble	Chance to explode enemy when hit by their arrows.	Chestplate	Legendary	3
Gears	Added speed when equipped.	Boots	Legendary	3
Glowing	Gives permanent night vision.	Helmet	Simple	1
Greatsword	Multiplies damage against players who are wielding a Bow at the time they are hit.	Sword	Elite	5
Guardians	A chance to spawn iron golems to assist you and watch over you.	Armor	Ultimate	10
Hardened	Chance to recover durability when damaged by players.	Armor	Legendary	3
Haste	Allows you to swing your tools faster.	Tools	Fabled	3
Hasten	Chance to gain Haste after breaking blocks.	Tools	Simple	3
Heavy	Decreases damage from enemy bows by 2% per level.	Armor	Ultimate	5
Hellfire	Arrows turn into fireballs.	Bow	Ultimate	5
Hook	Get more exp from fishing.	Fishing Rod	Elite	3
Hook	Chance to increase luck while fishing.	Fishing Rod	Ultimate	3
Hunter	Increases damage dealt to Passive Mobs.	Bow, Crossbow, Trident	Unique	4
Ice Aspect	A chance of causing the slowness effect on your enemy.	Swords	Ultimate	3
Immolate	Increases damage dealt to Spiders.	Swords, Axes	Elite	3
Immolation	Set all mobs in radius on fire.	Swords	Ultimate	3
Immortal	Chance to prevents your armor from taking durability damage.	Armor	Fabled	4
Impact	Chance to double dealt damage.	Trident	Elite	4
Implants	Chance to restore food every few seconds.	Helmets	Ultimate	3
Infernal	Explosive fire effect.	Swords, Axes	Elite	3
Inflame	Set all players in radius on fire.	Axes	Legendary	3
Inquisitive	Chance to increase EXP drops from mobs.	Swords	Legendary	4
Interrupt	Chance to give your enemy mining fatigue.	Swords	Ultimate	2
Jelly Legs	Chance to negate fall damage.	Boots	Ultimate	3
Judgement	Chance of poisoning opponent and gaining regeneration.	Elytra	Legendary	5
Kill Aura	Chance to kill multiple\nmonsters in radius.	Swords	Legendary	5
Launch	Launch yourself by right-clicking.	Swords	Legendary	3
Lava Walker	Walk on Lava.	Boots	Legendary	1
Lifesteal	A chance to steal health when attacking.	Swords	Legendary	5
Longbow	Greatly increases damage dealt to enemy players that have a bow in their hands.	Bow	Ultimate	4
Lucid	Chance to cure blindness and gain night vision when hit.	Armor	Legendary	3
Magnet	Your attack pulls players towards you.	Swords	Elite	3
Marksman	Increases damage dealt with Crossbows.	Crossbow	Elite	4
Missile	Arrows turn into fireballs.	Crossbow	Elite	5
Molten	Chance of setting your attacker ablaze.	Armor	Unique	4
Momentum	Chance to gain speed boost with fireworks.	Elytra	Elite	3
Multiplication	Chance to multiply ore drops. Costs 5 souls / activation.	Pickaxe	Fabled	5
Nether Slayer	Increases damage dealt to nether mobs.	Weapons	Elite	5
Netherling	Double damage to mobs in Nether.	Swords	Ultimate	3
Neutralize	Chance to disarm opponent.	Bow, Crossbow	Fabled	2
Night Owl	Deal more damage to mobs at night.	Swords	Ultimate	1
Nightwalker	Freeze mobs at night.	Swords	Elite	3
Nulify	Chance to reflect attack and multiply damage. Costs 40 souls / activation.	Leggings	Fabled	3
Obsidianshield	Gives permanent fire resistance.	Armor	Ultimate	1
Overload	Unlocks additional hearts.	Armor	Legendary	3
Paralyze	Gives lightning effect and a chance for slowness and slow swinging.	Swords, Axes	Elite	4
Patch	Chance to recover durability when damaged by mobs.	Armor	Legendary	3
Perish	A chance to give the wither effect.	Bow, Crossbow, Trident	Unique	5
Permafrost	Chance slow and bleed opponents.	Swords	Ultimate	5
Phoenix	Chance to revive yourself when killed.	Chestplates	Fabled	3
Piercing	Inflicts more damage.	Bows	Ultimate	5
Planter	Plant seeds in a 3x3 area by shift+right-clicking.	Hoes	Ultimate	3
Plummet	Deal damage to nearby mobs when taking fall damage.	Boots	Ultimate	3
Poison	A chance of giving poison effect.	Swords, Axes	Elite	3
Poisoned Hook	Poisons the hook.	Fishing Rod	Elite	3
Poisoned	Chance to give poison to your attacker.	Armor	Elite	4
Poseidon	Increases damage dealt with Tridents.	Trident	Elite	4
Potato Planter	Plant potatoes in a 3x3 area by shift+right-clicking.	Hoes	Simple	3
Ragdoll	Chance to be pushed back when getting hit.	Armor	Ultimate	4
Ravenous	Chance to regain hunger while fighting.	Swords, Axes	Unique	4
Reaper	A chance to give your opponent the Wither and Blindness effects while dealing damage	Axe	Elite	4
Rebound	Gain some health back after kills.	Weapons	Legendary	3
Rebreather	Chance to regain air when mining under water.	Pickaxe	Simple	2
Reflect	Absorb enemy damage and reflect it back.	Armor	Unique	5
Reforged	Protects weapons and tools durability, items will be take longer to break.	Weapons and tools	Elite	10
Reinforced	Reduces damage dealt to you.	Elytra	Ultimate	4
Replanter	Replants crops when harvested	Hoes	Unique	1
Replenish	Chance to restore food while mining.	Pickaxes	Elite	3
Restore	Upon breaking, item has a chance to lose this enchantment and repair half of its durability.	Tools	Fabled	4
Rocket Escape	Blast off into the air at low HP.	Boots	Elite	3
Rush	Chance of speed boost when taking off with elytra. Costs 10 souls / activation.	Elytra	Fabled	3
Safeguard	Chance to gain Damage Resistance when defending.	Armor	Ultimate	2
Scare	Chance to replace your opponents helmet\nto a pumpkin for a short time.	Weapons	Fabled	5
Shatter	Chance to deal extra durability damage to all enemy armor with every attack.	Axes	Ultimate	4
Sharpness Hook	Deal damage with the hook.	Fishing Rod	Ultimate	1
Shockwave	Chance to push back your attacker when your health is low.	Chestplates	Elite	5
Slayer	Increases damage dealt to Passive Mobs.	Swords, Axes	Unique	4
Slingshot	Boost yourself into flight by right-clicking.	Elytra	Legendary	3
Smelting	Chance to smelt mined blocks.	Pickaxes	Simple	3
Smoke Bomb	When you are near death, you will spawn a smoke bomb to distract your enemies.	Helmet	Elite	8
Snap	Pull hit entity towards you.	Fishing Rod	Elite	3
Snare	Chance to slow and fatigue enemies with projectiles.	Bows	Elite	4
Sniper	Headshots with bows deal double damage.	Bow	Ultimate	5
Soulbound	A chance to keep item on death.	Weapons + Tools + Bows	Fabled	3
Soulgrind	Chance to get souls by killing mobs.	Swords	Fabled	3
Soulless	Increases damage dealt to Hostile Mobs.	Bow, Crossbow, Trident	Unique	4
Soulminer	Chance to get souls by mining.	Pickaxe	Fabled	3
Spark	Light opponents on fire.	Trident	Elite	3
Spiritmaster	Chance to get more souls from killing players.	Swords	Fabled	3
Spirits	Chance to spawn guard blazes.	Armor	Ultimate	10
Springs	Gives jump boost.	Boots	Elite	3
Strife	Increases Trident melee damage.	Trident	Legendary	3
Strike	Chance to strike lightning at the opponent.	Swords, Bow, Crossbow, Trident	Simple	3
Striker	Rain arrows over opponent.	Bow	Ultimate	3
Suspend	Chance to cause no knockback to mobs.	Swords	Elite	3
Swordsman	Chance to reduces incoming damage while wielding a sword by up to 22% at max level.	Armor	Ultimate	5
Tank	Chance to decreases damage from enemy axes by 2% per level.	Armor	Ultimate	4
Telepathy	Automatically places blocks broken by tools in your inventory.	Tools	Unique	4
Thunderlord	Strike monsters with lightning every 3 consecutive hits.	Weapons	Legendary	3
Timber	Chance to break a tree in one hit	Axes	Ultimate	3
Trench	Chance to break in 3x3 area.	Pickaxes, Shovels	Ultimate	9
Trickster	When hit you have a chance to teleport directly behind you opponent.	Armor	Elite	8
Turmoil	Chance to prevent opponents guards from spawning.	Armor	Legendary	3
Twinge	Make your enemy bleed, if hit using melee attack.	Trident	Legendary	4
Unbreakable	Tools with this enchant become unbreakable	Tools	Fabled	1
Undead Ruse	When hit you have a chance to spawn zombie hordes to distract and disorient your opponents.	Boots	Elite	10
Unholy	Defend with weakness and wither effects.	Armor	Legendary	5
Vampire	A chance to heal you for up to 3hp a few seconds after you strike.	Swords	Elite	3
Vein Miner	Mine entire vein of ores	Pickaxes	Elite	3
Virus	A chance of giving poison effect.	Bow, Crossbow, Trident	Unique	3
Voodoo	Gives a chance to deal weakness.	Armor	Elite	6
Ward	A chance to absorb enemy damage	Armor	Unique	4
Water Walker	Walk on Water.	Boots	Legendary	1
Wings	Allows flying when worn.	Boots	Legendary	1
Wither	A chance to give the wither effect.	Armor	Elite	5

# Cosmic Enchants (200+) 200+ PvP Oriented enchantments setup inspired by CosmicPvP How to install? Use the command `/ae premade` in-game to install this enchantment pack! Preview: ![](https://286155643-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MI09GrzCaIdY780LjYd%2F-MVu445IvdmjS2SlOfgd%2F-MVu49oBbg1JT7Xwh2Be%2FinstallPack2.gif?alt=media\&token=13e5f9d9-12b5-4f65-b632-20bf6aefd670) | Enchant Name | Description | Applies To | Group | Max Level | | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-----------: | :-------: | :-------: | | Strike | Chance to strike lightning at the opponent. | Trident | Simple | 3 | | Impact | Chance to double dealt damage. | Trident | Elite | 4 | | Twinge | Make your enemy bleed, if hit using melee attack. | Trident | Legendary | 4 | | Jelly Legs | Chance to negate fall damage. | Boots | Ultimate | 3 | | Restore | Upon breaking, item has a chance to lose this enchantment and repair half of its durability | Tools | Ultimate | 4 | | Shuffle | Shuffles opponent's hotbar. | Armor | Simple | 3 | | Take Off | Allows flying when worn. | Boots | Legendary | 1 | | Aquatic | Gives permanent water breathing. | Helmets | Simple | 1 | | Auto Smelt | Ores are automatically smelted when mined. | Pickaxes | Simple | 3 | | Confusion | A chance to deal nausea to your victim. | Axes | Simple | 3 | | Etheral | Gain haste upon killing mobs | Sword | Simple | 3 | | Experience | Chance to get experience from mining. | Tools | Simple | 5 | | Haste | Allows you to swing your tools faster. | Tools | Simple | 3 | | Insomnia | Gives slowness, slow swinging and confusion. | Swords | Simple | 7 | | Lightning | A chance to strike lightning at the opponent. | Bows | Simple | 3 | | Oxygenate | Refills oxygen levels when breaking blocks under water. | Pickaxe | Simple | 1 | | Thundering Blow | Can cause smite effect on your enemy. | Swords | Simple | 3 | | Glowing | Gives permanent night vision. | Helmet | Simple | 1 | | Decapitation | Victims have a chance of dropping their head on death. | Axes | Simple | 3 | | Headless | Victims have a chance of dropping their head on death. | Swords | Simple | 3 | | Obliterate | Extreme knockback. | Swords | Simple | 5 | | Epicness | Gives particles and sound effects. | Swords | Simple | 3 | | Lifebloom | Completely heals allies and truces on your death in 10 block radius. | Leggings | Unique | 5 | | Famine | A chance to give your opponent the hunger effect. | Weapons | Unique | 4 | | Berserk | A chance of strength and mining fatigue. | Axes | Unique | 5 | | Ward | A chance to absorb enemy damage and heal you | Armor | Unique | 4 | | Curse | Gives strength, slowness and resistance at low hp. | Chestplate | Unique | 5 | | EnderShift | Gives speed/health boost at low hp. | Helmet Boots | Unique | 3 | | Explosive | Explosive arrows. | Bows | Unique | 5 | | Featherweight | A chance to give a burst of haste. | Swords | Unique | 3 | | Molten | Chance of setting your attacker ablaze. | Armor | Unique | 4 | | Ravenous | Chance to regain hunger whilst in combat. | Axes | Unique | 4 | | Commander | Nearby allies are given haste. | Armor | Unique | 5 | | Self Destruct | When close to death, tnt spawns around you to end you and remove your dropped items. | Armor | Unique | 3 | | Telepathy | Automatically places blocks broken by tools in your inventory. | Tools | Unique | 4 | | Sustain | Chance to regain hunger when getting hit. | Armor | Unique | 4 | | Skill Swipe | A chance to steal some of your enemy's EXP every time you damage them. | Sword | Unique | 5 | | Plague Carrier | When near death summons creepers and debuffs to avenge you. | Leggings | Unique | 8 | | Virus | Multiplies all Wither and Poison damage the affected target recieves and has a chance to remove regeneration effects on hit. | Bow | Unique | 4 | | Anti Gravity | Super jump. | Boots | Elite | 3 | | Ender Slayer | Increases damage dealt to Enderman and Ender dragons. | Weapons | Elite | 5 | | Reaper | A chance to give your opponent the Wither and Blindness effects while dealing damage | Axe | Elite | 4 | | Nether Slayer | Increases damage dealt to Blazes and Zombie Pigmen. | Weapons | Elite | 5 | | Blind | A chance of causing blindness when attacking. | Swords | Elite | 3 | | Shackle | Prevents mobs from suffering from knockback from your attacks. | Swords | Elite | 3 | | Cactus | Injures your attacker but does not affect your durability. | Armor | Elite | 2 | | Execute | Damage buff when your target is at low HP. | Swords | Elite | 7 | | Frozen | Can cause slowness to attacker when defending. | Armor | Elite | 3 | | Paralyze | Gives lightning effect and a chance for slowness and slow swinging. | Swords | Elite | 4 | | Poison | A chance of giving poison effect. | Weapon | Elite | 3 | | Poisoned | Chance to give poison to your attacker. | Armor | Elite | 4 | | Reforged | Protects weapons durability, items will be take longer to break. | Weapons | Elite | 10 | | Snare | Chance to slow and fatigue enemies with projectiles. | Bows | Elite | 4 | | Springs | Gives jump boost. | Boots | Elite | 3 | | Stormcaller | Strikes lightning on attacking players. | Armor | Elite | 4 | | Demonforged | Increases durability loss on your enemy''s armor. | Sword | Elite | 4 | | Trap | Chance to give buffed slowness effect. | Sword | Elite | 3 | | Undead Ruse | When hit you have a chance to spawn zombie hordes to distract and disorient your opponents. | Boots | Elite | 10 | | Venom | A chance of dealing poison. | Bows | Elite | 3 | | Voodoo | Gives a chance to deal weakness. | Armor | Elite | 6 | | Wither | A chance to give the wither effect. | Armor | Elite | 5 | | Smoke Bomb | When you are near death, you will spawn a smoke bomb to distract your enemies. | Helmet | Elite | 8 | | Infernal | Explosive fire effect. | Bow | Elite | 3 | | Pummel | Chance to slow nearby enemy players for a short period. | Axe | Elite | 3 | | Shockwave | The chance to push back your attacker when your health is low. | Chestplate | Elite | 5 | | Vampire | A chance to heal you for up to 3hp a few seconds after you strike. | Sword | Elite | 3 | | Farcast | Chance to knockback melee attackers by a couple of blocks when they hit you. The lower your health, the higher the chance to proc. | Bow | Elite | 5 | | Greatsword | Multiplies damage against players who are wielding a BOW at the time they are hit. | Sword | Elite | 5 | | Hardened | Armor takes less durability damage. | Armor | Elite | 3 | | Rocket Escape | Blast off into the air at low HP. | Boots | Elite | 3 | | Trickster | When hit you have a chance to teleport directly behind your opponent and take them by surprise. | Armor | Elite | 8 | | Hijack | Chance to convert summoned enemy Guardians into your own when they are shot with an arrow. | Bow | Elite | 4 | | Pickpocket | Chance to steal in-game money whilst fighting. | Weapons | Ultimate | 3 | | Distance | Chance to distance yourself from your enemies and gain regeneration. | Weapons | Ultimate | 4 | | Reinforced | Take less damage when being hit from behind. | Armor | Ultimate | 4 | | Cleave | Damages players within a radius that increases with the level of enchant. | Axes | Ultimate | 7 | | Angelic | Heals health over time whenever damaged | Armor | Ultimate | 5 | | Arrow Lifesteal | Chance to steal health from opponent. | Bows | Ultimate | 5 | | Arrow Deflect | Prevents you from being damaged by enemy arrows more often than once every level x 400 milliseconds. | Armor | Ultimate | 4 | | Arrow Break | Chance for arrows to bounce off and do no damage to you whenever you are wielding an axe with this enchantment on it. | Axe | Ultimate | 6 | | Assassin | The closer you are to your enemy, the moredamage you deal (up to 1.25x). However, ifyou are more than 2 blocks away, you will deal LESS damage than normal. | Sword | Ultimate | 5 | | Blessed | A chance of removing debuffs. | Axes | Ultimate | 4 | | Corrupt | Damage with niche, this enchant deals damage over time. | Axe | Ultimate | 4 | | Ragdoll | Whenever you take damage you are pushed far back. | Armor | Ultimate | 4 | | Block | A chance to redirect an attack. | Sword | Ultimate | 3 | | Detonate | Chance to break in 3x3 area. | Pickaxes | Ultimate | 9 | | Dodge | Chance to dodge physical enemy attacks, increased chance if sneaking. | Armor | Ultimate | 5 | | Enrage | Deal more damage on low HP. | Swords | Ultimate | 3 | | Guardians | A chance to spawn iron golems to assist you and watch over you. | Armor | Ultimate | 10 | | Ice Aspect | A chance of causing the slowness effect on your enemy. | Swords | Ultimate | 3 | | Implants | Passively heals 1 health and restores 1 hunger every few seconds | Helmets | Ultimate | 3 | | Obsidianshield | Gives permanent fire resistance. | Armor | Ultimate | 1 | | Demonic | A chance to remove fire resistance from your enemy. | Armor | Ultimate | 3 | | Piercing | Inflicts more damage. | Bows | Ultimate | 5 | | Marksman | Increases damage dealt with bows. | Armor | Ultimate | 4 | | Disappear | Chance to become invisible when low on health. | Armor | Ultimate | 4 | | Disintegrate | Chance to deal double durability damage to all enemy armor with every attack. | Sword | Ultimate | 4 | | Dominate | Chance to weaken enemy players on hit, causing them to deal less damage. | Sword | Ultimate | 4 | | Arsonist | Chance to deal more damage whilst on fire | Sword | Ultimate | 3 | | Ender Walker | Wither and Poison do not injur and have a chance to heal at high levels. | Boots | Ultimate | 5 | | Eagle Eye | Chance to deal 1-4 durability damage to ALL armor pieces of enemy player. | Bow | Ultimate | 5 | | Annihilate | Demolish your opponent's armour quicker! | Axe | Ultimate | 6 | | Heavy | Decreases damage from enemy bows by 2% per level. | Armor | Ultimate | 5 | | Hellfire | All arrows shot by you turn into explosive fireballs. | Bow | Ultimate | 5 | | Longbow | Greatly increases damage dealt to enemy players that have a bow in their hands. | Bow | Ultimate | 4 | | Tank | Decreases damage from enemy axes by 1.85% per level. | Armor | Ultimate | 4 | | Unfocus | Chance to Unfocus target player, reducing their out going bow damage by 50% for up to 10 seconds. | Bow | Ultimate | 5 | | Valor | Reduces incoming damage while wielding a sword by up to 22.5%. | Armor | Ultimate | 5 | | Pacify | A chance to pacify your target, preventing them from building rage stacks for 1-3 seconds depending on level. | Bow | Ultimate | 4 | | Metaphysical | A chance to be immune of Slowness. At max level, you will only be affected approx. 10% of the time. | Boots | Ultimate | 4 | | Creeper Armor | Immune to explosive damage, at higher levels you take no knockback from them and they have a chance to heal you. | Armor | Ultimate | 3 | | Spirits | Chance to spawn blazes that heal yourself and your allies in combat. | Armor | Ultimate | 10 | | Bleed | Applies bleed stacks to enemies that decrease their movement speed. | Axe | Ultimate | 6 | | Kill Aura | Chance to kill multiple monsters in a stack each death event. | Swords | Legendary | 5 | | Lava Walker | Walk on Lava. | Boots | Legendary | 1 | | Impale | Deal HUGE amounts of damage to your opponent causing Slowness V for some time | Bow | Legendary | 4 | | Protection | Automatically heals and buffs all nearby faction allies. | Armor | Legendary | 5 | | Torrent | Deal increased damage while in water. | Boots | Legendary | 4 | | Judgement | Chance of dealing poison damage to your target or adding regeneration to yourself. | Armor | Legendary | 5 | | Surprise | Chance to teleport behind your opponent and take them by surprise. | Armor | Legendary | 4 | | Stun | Chance to slow opponent, make them feel weak, and remove slowness from you. | Weapon | Legendary | 3 | | Unholy | Chance to give weakness and wither to your attacker. | Armor | Legendary | 5 | | Quiver | Chance to fling your attackers into the air. | Boots | Legendary | 6 | | Fat | Wearer receives increased damage negation as well as absorption at higher levels. | Chestplate | Legendary | 6 | | Hex | Once a target is affected by Hex, a portion of all their outgoing damage is reflected back onto them. | Axes | Legendary | 4 | | Barbarian | Inflicts more axe damage. | Axes | Legendary | 4 | | Clarity | Immune to blindness. | Armor | Legendary | 3 | | Deathbringer | Chance to deal double damage. | Armor | Legendary | 3 | | Double Strike | A chance to strike twice. | Swords | Legendary | 3 | | Drunk | Slowness and slow swinging with a chance to get strength. | Helmet | Legendary | 4 | | Enlighted | Can heal hearts while taking damage. | Armor | Legendary | 3 | | Gears | Added speed when equipped. | Boots | Legendary | 3 | | Inquisitive | Increases EXP drops from mobs. | Swords | Legendary | 4 | | Inversion | Damage dealt to you has a chance to be blocked and heal you for 1-5 HP. | Swords | Legendary | 4 | | Lifesteal | A chance to regain health when attacking. | Swords | Legendary | 5 | | Overload | Permanent increase in hearts. | Armor | Legendary | 3 | | Rage | For every combo hit you land, you do 0.5 heart damage to your opponent Up to 5 max combo hits. | Weapon | Legendary | 6 | | Silence | Chance to stop activation of your enemy's custom enchants. | Sword | Legendary | 4 | | Armored | Decreases damage from enemy swords by 1.85% per level. | Armor | Legendary | 4 | | Exterminator | Temporarily disables enemy ability to use Undead Ruse, Gaurdians, and Spirits. | Leggings | Legendary | 3 | | Blacksmith | Chance to heal your most damaged piece of armor by 1-2 durability whenever you hit a player, but when it procs your attack will only deal 50% of the normal damage. | Axe | Legendary | 5 | | Abiding | Tools with this enchant become unbreakable | Tools | Legendary | 1 | | Devour | Multiplies damage dealt to players with active bleed stacks. | Axe | Legendary | 4 | | Diminish | When this effect procs, the next attack dealt to you cannot deal more than the (total amount of damage / 2) you took from the previous attack. | Chestplate | Legendary | 6 | | Disarmor | A slight chance of removing one piece of armor from your enemy when they are at low health. | Sword | Legendary | 8 | | Death God | Attacks that bring your HP to (level 4) hearts or lower have a chance to heal you for (level 5) hearts instead. | Helmet | Legendary | 3 | | Insanity | You swing your axe like a maniac. Multiplies damage against players who are wielding a SWORD at the time they are hit. | Axe | Legendary | 8 | | Sniper | Headshots with projectile deal up to 3.5x damage. | Bow | Legendary | 5 | | Destruction | Automatically damages and debuffs all nearby enemies. | Helmet | Legendary | 5 | | Insanity | You swing your sword like an extreme maniac. Multiplies damage against players who are wielding a SWORD at the time they are hit. Requires Instanity VIII to apply. | Axes | Heroic | 8 | | Mega Heavy | Decreases Damage from enemy bows by 10% plus an additional 2% per level. Requires Heavy V to apply. | Armor | Heroic | 5 | | Bewitched Hex | Once a target is affected with Bewitched Hex, a portion of all their outgoing damage is reflected back onto them. Requires Hex IV to apply. | Axes | Heroic | 4 | | Mighty Cleave | Deals up to 8 damage in up to a 4 block radius. Requires Cleave VII to apply. | Axes | Heroic | 5 | | Mighty Cactus | Heroic Enchantment. Injures your attacker but does not affect your durability. Requires Cactus II to apply. | Armor | Heroic | 2 | | Guided Rocket Escape | Blast off into the air and breifly gain flight for (level x 1s). Requires Rocket Escape III to apply. | Boots | Heroic | 3 | | Soul Hardened | Up to 50% chance to block enemy soul trap, armor takes less durability damage. Requires Hardened III to apply. | Armor | Heroic | 3 | | Polymorphic Metaphysical | A chance to be immune of Slowness. At max level, you will only be affected approx. 10% of the time. Requires Metaphysical IV to apply. | Boots | Heroic | 4 | | Soulbound | A chance to keep item on death. | Weapons Tools | Heroic | 3 | | Reinforced Tank | Decreases damage from enemy axes by 1.85% per level. Requires Tank IV to apply. | Armor | Heroic | 4 | | Epidemic Carrier | When near death summons creepers and debuffs to avenge you. Requires Plague Carrier VIII to apply. | Leggings | Heroic | 8 | | Godly Overload | Heroic Enchantment. A very large permanent increase in hearts. Requires Overload III enchant on item to apply. | Armor | Heroic | 3 | | Reflective Block | Heroic Enchantment. A chance to greatly or completely negate incoming damage while blocking, and to reflect an incoming attack back on the attacker whether you are blocking or not. Requires Block III to apply. | Sword | Heroic | 3 | | Master Inquisitive | Heroic Enchantment. Massively increases EXP drops from mobs. Requires Inquisitive IV enchant on item to apply. | Sword | Heroic | 4 | | Planetary Deathbringer | Heroic Enchantment. An increased chance to deal 1.5x damage. Requires Deathbringer III enchant on item to apply. | Armor | Heroic | 3 | | Divine Enlighted | Heroic Enchantment. High chance of healing lots of HP while taking damage. Requires Enlighted III enchant on item to apply. | Armor | Heroic | 3 | | Lethal Sniper | Heroic Enchantment. Increased headshotchance and multiplied damage up to 4.5x. Requires Sniper V enchant on item to apply. | Bow | Heroic | 5 | | Atomic Detonate | Heroic Enchantment. Summons up to a 7x7 explosion around any blocks you break. Requires Detonate IX enchant on item to apply. | Tools | Heroic | 9 | | Titan Trap | Heroic Enchantment. A chance to give a longer lasting buffed slowness effect. Requires Trap III to apply. | Sword | Heroic | 3 | | Bidirectional Teleportation | Heroic Enchantment. Chance to grapple an enemy towards you, or trap them for 1-2s. | Bows | Heroic | 4 | | Master Blacksmith | Chance to heal your most damaged piece of armor by 2-3 durability whenever you hit a player, but when it procs your attack will deal between 75%-100% damage. Requires Blacksmith V enchantment on item to apply. | Axe | Heroic | 5 | | Vengeful Diminish | Ensures that the next strike against you only deals 50% of the damage inflicted and any extra above that will be returned to the attacker. Requires Diminish VI enchant on item to apply. | Chestplate | Heroic | 6 | | Alien Implants | Automatically heal 2x the HP of normal Implants at 2x the rate, and at max level all hunger loss is disabled. Requires Implants III. | Helmets | Heroic | 3 | | Ethereal Dodge | Increased proc rate over normal Dodge, with a small chance to gain Speed V for a few seconds on successful dodge. Requires Dodge V. | Armor | Heroic | 5 | | Paladin Armored | Negates 150% more enemy sword damage than normal Armored per level. A chance to be Blessed every time you are struck by an enemy sword. Requires Armored IV. | Armor | Heroic | 4 | | Demonic Lifesteal | Heals much more HP at a greatly increased rate compared to normal Lifesteal. Requires Lifesteal V. | Swords | Heroic | 5 | | Deep Bleed | Heroic Enchantment. A chance to affect foes with increased slowness and inflict more damage. Requires Bleed VI. | Axe | Heroic | 6 | | Shadow Assassin | Heroic Enchantment. The closer you are to your enemy, the more damage you deal (up to 1.875x). However, if you are more than 2 blocks away, you will deal LESS damage than normal. Requires Assassin V. | Sword | Heroic | 5 | | Rogue | Active soul enchant. Deal up to 2.0x damage if hitting your enemy from behind | Axes | Soul | 3 | | Sabotage | An active soul enchantment that gives a chance to block an enemy players Rocket Escape and Guided Rocket Escape from activating. | Swords | Soul | 5 | | Natures Wrath | Temporarily freeze all enemies in a massive area around you, pushing them back and dealing massive nature damage. 75 souls per use. | Armor | Soul | 4 | | Phoenix | An attack that would normally kill you will instead heal you to full HP. Can only be activated once every couple minutes. 500 souls per use. | Armor | Soul | 3 | | Teleblock | Active soul enchant. Your bow is enchanted with enderpearl blocking magic damaged players will be unable to use enderpearls for up to 20 seconds and will lose up to 15 enderpearls from their inventory. | Bows | Soul | 5 | | Soul Trap | Active soul enchant. Your axe is imbued with sealing magic, and has a chance to disable/negate all soul enchantments of your enemies on hit for (level x 4) seconds. 2 souls per second. | Weapon | Soul | 3 | | Immortal | Passive soul enchant. Prevents your armor from taking durability damage in exchange for souls. 5 souls per use. | Armor | Soul | 4 | | Divine Immolation | Active soul enchant. Your weapons are imbued with divine fire, turning all your physical attacks into Area of Effect spells and igniting divine fire upon all nearby enemies. 75 souls per use. | Sword | Soul | 4 | | Paradox | Passive soul enchantment. Heals all nearby allies in a massive area around you for a portion of all damage dealt to you. | Sword | Soul | 5 | | SoulGrind | Random chance to get a souls for killing mobs. | Swords | Mastery | 3 | | Neutralize | Negate all enemy defensive enchantment's for on the damage event that neutralize activates for This effect can stack with silence | Swords | Mastery | 5 | | Halloweenify | Replace your opponents helmet to a pumpkin for a short time. | Weapon | Mastery | 5 | | Mark of the Beast | Once an enemy is afflicted with the mark all incoming damage is increased by 2x for up to 5 seconds | Armor | Mastery | 6 | | Horrify | Chance to inflict enemies within a 32x32 radius with Horror. | Armor | Mastery | 4 | | Chain Lifesteal | A chance to regain health from multiple enemies near you damaged target based on level | Chestplate | Mastery | 5 | | Poltergeist | Immune to Nature's Wrath snare. | Boots | Mastery | 3 | | Feign Death | Chance to fake death and vanish for up to 6 seconds or until you have damaged a player (levelx) times | Armor | Mastery | 4 | | Soul Siphone | Proc'ing on outgoing damage events this enchant siphons souls and durability from enemies in large quantities!. | Armor | Mastery | 4 | | Death Pact | Take less damage for every 10% of missing HP while also dealing slightly less damage (based on level) | Armor | Mastery | 3 | | Web Walker | Depth Strider, but for Spider Webs. | Boots | Mastery | 1 | # Vanilla+ Custom Enchants (60+) 60+ Enchants for Vanilla+ servers, Survival and SMPs! How to install? Use the command `/ae premade` in-game to install this enchantment pack! * No complicated systems - just enhanced vanilla * Works with vanilla XP system * Integrated with vanilla enchantment table, anvil, villagers, random world loot & more! * Perfect for Vanilla+ servers, Survival and SMPs!

### Get AdvancedEnchantments On [SpigotMC ](https://www.spigotmc.org/resources/1-17-1-21-4-⭕-advancedenchantments-⭐-450-custom-enchants-⭐create-custom-enchantments-✅.43058/)/ [AdvancedPlugins.net](https://advancedplugins.net/item/AdvancedEnchantments.1)! | Enchant Name | Description | Applies To | Max Level | | ---------------------- | -------------------------------------------------------------------------------- | ------------------------------ | --------- | | Abrasion | Damages the opponents armor. | Weapons | 3 | | Adrenaline | Gain Strength when defending mob attacks. | Armors | 3 | | Alacrity | Enables you to use your tools at a quicker speed. | Tools | 3 | | Allurement | Grants a chance to catch double loot while fishing. | Fishing Rod | 3 | | Arctic freeze | Chance to inflict slowness and cause bleeding on opponents. | Swords | 3 | | Ascend | Levitate. Right-Click to activate | Swords | 3 | | Aura | Reduce damage taken by nearby players. | Armor | 3 | | Blackout | Blind your opponent. | Swords | 5 | | Blast Mining | Mine blocks in a 3x3 area. | Pickaxes | 3 | | Blaze Reaper | Boosts damage against Nether creatures. | Weapons | 3 | | Brightness | Chance to cause more damage to warden in the dark. | Swords | 3 | | Caffeinated | Chance to increase attack speed while sprinting. | Swords | 3 | | Carve | Give damage to entities within \&a3 blocks when you swing. | Swords | 3 | | Charge | Launch yourself forward. | Swords | 2 | | Contagion | Give chance to spawn a cloud of void where your Arrow lands. | Bows | 3 | | Criticals | Increase damage done with critical hit. | Swords | 3 | | Cubism | Deal more damage to slimes and magma cubes. | Weapons, Bows | 3 | | Curse of Breaklessness | Gives 40% chance to fail to break blocks. | Pickaxes,Shovels,Axes | 3 | | Curse of Harmlessness | Gives a chance for attacks to do nothing. | Swords | 3 | | Double Blow | Chance to deal double damage. | Trident | 4 | | Drain | Cause your opponent to drain. | Swords | 7 | | End Affinity | Reduces damages dealt in the end world. | Armors | 3 | | Enderbane | Increases damage dealt to Enderman and Ender dragons. | Weapons | 5 | | Escape | Gain a short burst of speed after taking damage. | Boots | 2 | | Experience | Chance to get more experience from ores. | Tools | 5 | | Explosive | Chance for arrows to explode. | Bow | 5 | | Feather Step | Chance to cancel fall damage. | Boots | 5 | | Finishing | Increases damage dealt to low-health enemies. | Weapons | 3 | | Fire Hook | The hook is on fire. | Fishing Rod | 3 | | First Strike | Deal more damage to enemies at full health. | Weapons | 3 | | Flashbang | Blind your opponent on hit. | Bows | 3 | | Foraging | Chance to multiply drops from leaves. | Tools | 3 | | Frost | Chance to freeze your opponent. | Bows | 3 | | Getaway | Chance to gain more movement speed below ┬ºa20%┬º7 health when dealt with damage | Armor | 3 | | Haste | Allows you to swing your tools faster. | Tools | 3 | | Incinerate | Boosts damage inflicted on Spiders. | Swords, Axes | 3 | | Infernal Touch | Chance to smelt mined blocks. | Pickaxes,Shovels | 3 | | Multi-Shot | Rain arrows over opponent. | Bow | 3 | | Nether Affinity | Reduces damages recieved in the nether world. | Armors | 3 | | Nether Prospector | Chance to multiply ancient debris drops. | Pickaxes | 3 | | Ninja | Chance to deal more damage to enemy while sneaking | Swords | 3 | | Poisoned Hook | Poisons the hook. | Fishing Rod | 3 | | Postpone | Chance to cause no knockback to mobs. | Swords | 3 | | Ravenous | Chance to regain hunger while fighting. | Swords, Axes | 4 | | Rebounding | Rebounds incoming damage back at your attacker. | Armors | 3 | | Repel | Chance to drive your opponent backward. | Swords | 3 | | Replenish | Restores crops back when you break them. | Hoes | 1 | | Resonate | Take in enemy damage and send it back at them. | Armor | 3 | | Rumble | Chance to damage back to all entities in a 3 block radius | Armors | 3 | | Scorching | Chance to ignite the attacker in flames. | Armor | 3 | | Sharpness Hook | Deal damage with the hook. | Fishing Rod | 9 | | Shura | Gives a bonus to critical damage when under half health | Swords | 3 | | Skullcrusher | Boosts damage inflicted on Skeletons. | Swords, Axes | 3 | | Starvation | A chance to inflict the hunger effect on your opponent.. | Weapons | 3 | | Thor | Chance to strike lightning at the opponent. | Swords, Bow, Crossbow, Trident | 3 | | Vanish | Chance to disappear for 3 seconds after taking damage | Armors | 3 | | Waterborne | Helps ya get some air underwater. | Helmets | 1 | | Zombie Crusher | Boosts damage inflicted on Zombies. | Swords, Axes | 3 | | fuddle | Disorganize opponent's hotbar. | Swords | 3 | # Creating Enchantments Detailed Guide on Creating Enchantments *** The enchantment creation process may seem difficult at first, but once you get the hang of it, it becomes much easier. Start by practicing with simple enchants before moving on to more complex creations. ### Starting Out To begin creating enchantments, you need a basic understanding of the enchantment template. Here's a rundown of the simple formatting: {% hint style="warning" %} enchantment\_system\_name must be in latin alphabet (a-z), and in lower-case. {% endhint %}

<enchantment_system_name>:
  display: "<enchantment_display>"
  description: "<enchantment_description>"
  applies-to: "<applies_to>"
  type: "<triggers>"
  group: "<group>"
  applies:
    - <material>
  levels:
    <level_number>:
      effects:
        - "<effects>"

### Example Enchantment: ```yaml berserk: display: '%group-color%Berserk' description: |- Chance of strength and mining fatigue. applies-to: Swords, Axes type: ATTACK;ATTACK_MOB group: UNIQUE applies: - ALL_SWORD - ALL_AXE levels: '1': chance: 4 cooldown: 8 effects: - POTION:SLOW_DIGGING:0:60 @Attacker - POTION:INCREASE_DAMAGE:0:60 @Attacker '2': chance: 8 cooldown: 7 effects: - POTION:SLOW_DIGGING:0:80 @Attacker - POTION:INCREASE_DAMAGE:0:80 @Attacker ``` This is the basic template for creating enchantments. Let's go over each setting: #### `` This is the "backend" enchantment name, used in all commands and admin processes. The enchantment name must be written in lowercase. #### `display` This is the enchantment display, which appears in item lore, chat messages, and book formats. Color codes can be used with the display. Special placeholders include: * `%group-color%`: Use the group's global color code. #### `description` This is the enchantment's description, used in various menus and book formats. It supports the "\n" character for splitting to a new line, and requires double-quotes (") instead of single ('). Color codes can also be used with the display. #### `applies-to` This is used in menus, book formats, and chat messages. It tells users which item category the enchantment can be applied to (e.g., 'Armour', 'Weapons', etc.). Note that `applies-to` is visual only and does not affect which items the enchantment can actually be added to. #### `type` This defines what triggers the enchantment. Enchantment triggers can be found [here](https://wiki.advancedplugins.net/abilities/triggers) #### `group` This sorts enchantments into specified groups from the `groups.yml` file. It also hints at which global color should be used for display. Group names should be in UPPER-CASE. #### `applies` This sets a specified list of items that the enchantment can be added to. It supports plugin shortcuts such as: * `ALL_[material]`: Sets all specified material items (e.g., `ALL_SWORD` allows all types of swords). * `[material]_ARMOR`: Supports all types of specified armor (can be used with the previous shortcut to create `ALL_ARMOR`, allowing all possible armor pieces). **`effects`** Effects are the abilities which enchantment has. You can read more about effects and see effects list [here](https://wiki.advancedplugins.net/abilities/effects) ### Other Options There are a few other options for further customization when creating enchantments. These options are not required for basic enchantments: ```yaml : display: "" description: "" applies-to: "" type: "" group: "" applies: - settings: : levels: : cooldown: chance: conditions: - "" effects: - "" ``` ### Example Enchantment: ```yaml explosive: display: '%group-color%Explosive' description: Chance for arrows to explode. applies-to: Bow type: SHOOT;SHOOT_MOB settings: showActionBar: true group: UNIQUE applies: - BOW levels: '1': chance: 20 cooldown: 7 effects: - TNT @Victim ``` #### `settings` This is used to dictate special settings for specific enchantments. A full list of settings can be found [here](https://ae.advancedplugins.net/enchantments/creating-enchantments/settings). #### `cooldown` This is the length of time (in seconds) between enchantment activations. The default value is 0 seconds if no cooldown is specified. #### `chance` This is the chance (0-100) of the enchantment activating when the trigger is activated. The default value is 100 **`conditions`** * Require a certain placeholder to be parsed for enchant to activate * Supports PAPI placeholders * Have as many conditions as you want * In depth guide on conditions can be found [here](https://wiki.advancedplugins.net/abilities/conditions) [^1]: Must be in latin alphabet (a-z), and lower-case. # Settings List of enchantment settings for enchantment creation Settings are enchant specific toggles where you can define special things {% hint style="info" %} Settings are for that enchant only, letting you have different settings for each and every enchant {% endhint %} ``` superspeed: display: '%group-color%Super Speed' description: 'Gives super speed' applies-to: 'Boots' type: 'EFFECT_STATIC' group: 'RARE' applies: - ALL_BOOTS settings: required-enchants: - 'speed:3' - 'strongboots' not-applyable-with: - 'highjump' - 'superhighjump' removed-enchants: - 'speed' removeable: true disable-in-enchanter: true disabled-worlds: - 'parkour' - 'parkour2' showActionBar: true levels: 1: effects: - 'POTION:SPEED:3' ``` ### **required-enchants** * Here you can list enchantments that are needed to be already on the item before this enchant can be added on * You can have multiple required enchants * You can put a :\ after the name to require a specific level, otherwise any level will count\ Example: `- 'gears:10'` ### **not-applyable-with** * A list of enchants that if are already on the item, this enchant can't be added to it * You can have multiple incompatible enchants ### **removed-enchants** * A list of enchants that will be automatically removed when this enchant is added onto the item {% hint style="info" %} Pair this with `require-enchants` to make a higher enchant rarity for an enchant {% endhint %} ### **removeable** * Accepts `true` or `false` * Makes enchantment non-removeable with blackscrolls ### **disable-in-enchanter** * Accepts `true` or `false` * Makes enchantment not obtainable from Enchanter ### **disabled-worlds** * A list of worlds which the enchantment will not activate {% hint style="warning" %} `disabled-worlds` is cAsE sEnSiTiVe {% endhint %} ### **showActionBar** * Whether this enchantment should be showedcased in player's action bar upon activation, example gif: * It has a hard-coded 1s cooldown to prevent spam showcases # Effect Info Miscellaneous info about effects. ## Custom Locations AE allows you to define custom locations for most effects. To do this, add ``` location=x|y|z ``` to the end of the effect line (after %victim%/%attacker% if you use them). It supports exact coordinates and relative coordinates. To use relative coordinates, put `~` between the `x` and the `=`. Some effects also have custom placeholders for locations. All placeholders include the `X`, `Y`, & `Z` so using them will look like `location=%placeholder%`. All location placeholders are as follows: | Type | Location Placeholder | | ---------- | -------------------- | | MINING | %block location% | | SWING | %block location% | | ARROW\_HIT | %hit location% | Examples: `TELEPORT location=~0|0|-8` to teleport you -8 blocks in the `z` direction\ `TELEPORT location=%hit location%` to teleport you where an arrow lands\ `LIGHTNING location=%hit location%` to strike lightning where a trident lands ## Boost Arguments The `BOOST` effect propels a player or mob in an direction and velocity ``` BOOST:(direction):(speed) ``` The acceptable values for direction are as follows: | Direction | Argument | | ---------------------------------------------- | -------- | | Direction the entity is facing | FORWARD | | Opposite of the direction the entity is facing | BACKWARD | | Positive Y \| Upwards | UP | | Negative Y \| Downwards | DOWN | Example: `BOOST:FORWARD:5`\ Ideas: Item that propels you when using gliding with Elytra ## Explode Arguments The `EXPLODE` effect creates an explosion at a location, and you can specify the power, if it will create fire and break blocks. ``` EXPLODE:(power):(create fire):(break blocks) ``` The `create fire` and `break blocks` arguments accepts the values `true` or `false`\ \ Example: `Explode:3:false:true`\ Ideas: Bow that explodes blocks ## Plant Seeds Types The `PLANT_SEEDS` effect allows you to specify a specific crop to plant after the radius argument ``` PLANT_SEEDS:(radius):[type] ``` All available crops are as follows: | Crop Type | Argument | | -------------- | -------- | | Wheat Seeds | SEEDS | | Potatoes | POTATO | | Carrots | CARROT | | Beetroot Seeds | BEETROOT | Example: `PLANT_SEEDS:3:POTATO` {% hint style="info" %} If a crop is not specified, Wheat Seeds are used by default {% endhint %} # Complex Enchantments Guide on creating extremely advanced custom enchantments ## Overview Using [Placeholders](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders) from [PAPI](https://www.spigotmc.org/resources/placeholderapi.6245/), your able to make extremely complex enchantments that have 1 thing happen when a condition is met and a different thing happen when another condition is met all within one enchant level Some examples of what you can make: * Enchant that teleports you in the direction your facing * Enchant that "marks" a player and deals extra damage to them * Deal more damage the higher the grade of the opponents armor * The possibilities are endless ### Placeholders The main placeholders you'll be using are | Placeholder | Description | | ----------------------------------------------------------------------------------------------- | ---------------------------------------------------- | | [ChangeOutput](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders#changeoutput) | Gives you an output depending on another placeholder | | [Player](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders#player) | Various statistics about a player | | [CheckItem](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders#checkitem) | Checks Items in a players inventory | ### Getting Started First step is to have an idea of what you want to make, in this example we will be making an enchant that increases how much damage you do depending on the type of armor the enemy is wearing.\ Create your basic enchant with the correct information: ``` rampage: display: "%group-color%Rampage" description: "Deal more damage the higher the grade of enemy armor" applies-to: "Weapons" type: "ATTACK" group: "LEGENDARY" applies: - ALL_SWORD - ALL_AXE levels: 1: effects: - "INCREASE_DAMAGE:100 @Attacker" ``` ### Figure out how to make it You need to have an idea on how to make it, as in which placeholders to use, how to use it, and where to put it. In this enchant the damage increases depending on the enemy armor, so we'll need to check for the armor of the enemy. To do that we'll use the [CheckItem](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders#checkitem) placeholder. We use the [ChangeOutput](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders#changeoutput) placeholder so if the enemy is wearing Diamond Armor, we get an output, such as increase damage by 100%, otherwise 0%. ### Placeholders Most Complex Enchants will need the [ChangeOutput](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders#changeoutput) placeholder, so it's recommended to learn how it works.\ Adding a victim before the checkitem placeholder checks the victim's helmet slot, and we can put that result in the ChangeOutput placeholder and compare it to see if it equals `DIAMOND_HELMET`, and if it does, have the ouput as 100%, and if it doesn't, have the ouput as 0% increased damage. ``` rampage: display: "%group-color%Rampage" description: "Deal more damage the higher the grade of enemy armor" applies-to: "Weapons" type: "ATTACK" group: "LEGENDARY" applies: - ALL_SWORD - ALL_AXE levels: 1: effects: - "INCREASE_DAMAGE:%changeoutput_equals_{victim checkitem_getinfo:39_mat:}_DIAMOND\_HELMET_100_0% @Attacker" ``` {% hint style="warning" %} The DIAMOND\_HELMET has an underscore, which would interfere with the changeoutput placeholder, so we add an `\` to escape that {% endhint %} ### Adding each possibility Now you have to add each armor piece that the enemy could be wearing and how much increased damage you want to have for those pieces. Also be sure to change anything else such as the slot of the inventory that your checking ``` rampage: display: "%group-color%Rampage" description: "Deal more damage the higher the grade of enemy armor" applies-to: "Weapons" type: "ATTACK" group: "LEGENDARY" applies: - ALL_SWORD - ALL_AXE levels: 1: effects: - "INCREASE_DAMAGE:%changeoutput_equals_{victim checkitem_getinfo:39_mat:}_LEATHER\_HELMET_10_0% @Attacker" - "INCREASE_DAMAGE:%changeoutput_equals_{victim checkitem_getinfo:38_mat:}_LEATHER\_CHESTPLATE_30_0% @Attacker" - "INCREASE_DAMAGE:%changeoutput_equals_{victim checkitem_getinfo:37_mat:}_LEATHER\_LEGGINGS_20_0% @Attacker" - "INCREASE_DAMAGE:%changeoutput_equals_{victim checkitem_getinfo:36_mat:}_LEATHER\_BOOTS_10_0% @Attacker" - "INCREASE_DAMAGE:%changeoutput_equals_{victim checkitem_getinfo:39_mat:}_IRON\_HELMET_20_0% @Attacker" - "INCREASE_DAMAGE:%changeoutput_equals_{victim checkitem_getinfo:38_mat:}_IRON\_CHESTPLATE_50_0% @Attacker" - "INCREASE_DAMAGE:%changeoutput_equals_{victim checkitem_getinfo:37_mat:}_IRON\_LEGGINGS_30_0% @Attacker" - "INCREASE_DAMAGE:%changeoutput_equals_{victim checkitem_getinfo:36_mat:}_IRON\_BOOTS_20_0% @Attacker" - "INCREASE_DAMAGE:%changeoutput_equals_{victim checkitem_getinfo:39_mat:}_DIAMOND\_HELMET_30_0% @Attacker" - "INCREASE_DAMAGE:%changeoutput_equals_{victim checkitem_getinfo:38_mat:}_DIAMOND\_CHESTPLATE_70_0% @Attacker" - "INCREASE_DAMAGE:%changeoutput_equals_{victim checkitem_getinfo:37_mat:}_DIAMOND\_LEGGINGS_50_0% @Attacker" - "INCREASE_DAMAGE:%changeoutput_equals_{victim checkitem_getinfo:36_mat:}_DIAMOND\_BOOTS_30_0% @Attacker" - "INCREASE_DAMAGE:%changeoutput_equals_{victim checkitem_getinfo:39_mat:}_NETHERITE\_HELMET_40_0% @Attacker" - "INCREASE_DAMAGE:%changeoutput_equals_{victim checkitem_getinfo:38_mat:}_NETHERITE\_CHESTPLATE_100_0% @Attacker" - "INCREASE_DAMAGE:%changeoutput_equals_{victim checkitem_getinfo:37_mat:}_NETHERITE\_LEGGINGS_80_0% @Attacker" - "INCREASE_DAMAGE:%changeoutput_equals_{victim checkitem_getinfo:36_mat:}_NETHERITE\_BOOTS_40_0% @Attacker" ``` And thats it! Of course, theres a lot more you can do such as adding more checks and other things, but thats the basic structure. ### Other Examples Here are some other examples made by us: ``` teleport: display: '%group-color%Teleport' description: 'Teleport 8 blocks into the direction you''re facing' applies-to: 'Swords' group: 'ULTRA' type: 'RIGHT_CLICK' applies: - ALL_SWORD levels: 1: chance: 100 cooldown: 0 effects: - '%changeoutput_equals_{player_direction}_N_TELEPORT location=~0|0|-8_WAIT:0%' - '%changeoutput_equals_{player_direction}_NE_TELEPORT location=~6|0|-6_WAIT:0%' - '%changeoutput_equals_{player_direction}_E_TELEPORT location=~8|0|0_WAIT:0%' - '%changeoutput_equals_{player_direction}_SE_TELEPORT location=~6|0|6_WAIT:0%' - '%changeoutput_equals_{player_direction}_S_TELEPORT location=~0|0|8_WAIT:0%' - '%changeoutput_equals_{player_direction}_SW_TELEPORT location=~-6|0|6_WAIT:0%' - '%changeoutput_equals_{player_direction}_W_TELEPORT location=~-8|0|0_WAIT:0%' - '%changeoutput_equals_{player_direction}_NW_TELEPORT location=~-6|0|-6_WAIT:0%' ``` {% hint style="info" %} Teleport can be further advanced by checking the players Yaw and Pitch, and teleporting the player upwards {% endhint %} Have your own enchantment you want to be showcased here? Let us know on our discord and we'll take a look at it.\ If your interested in having someone make custom enchants for you, contact DuneSciFye on the discord support server # Repeating Enchantments {% hint style="info" %} #### Repeating Enchantments only works for Worn Armor and held item {% endhint %} Setting enchantment type to '**REPEATING**', you unlock access to another flag for each level '**time: (seconds)**', which allows a set period in-between each enchantment activation: ``` feed: display: '%group-color%Feed' description: 'Chance to feed 1 bar of food every few seconds.' applies-to: 'Helmets' type: 'REPEATING' group: 'SIMPLE' applies: - ALL_HELMET levels: 1: chance: 30 cooldown: 10 time: 5 effects: - 'MESSAGE:&aYou have been fed!' - 'ADD_FOOD:1' ``` This also allows setting **chances for activation** as shown in this example: ``` chance: 30 ``` each time it runs (in this case, every 5 seconds), it has 30/100 chance (30%) to activate and run. The REPEATING type allows setting `cooldown` as well, so in case the timer activated it and chance allowed it to run, it will not be ran for the next (*in this case 10 seconds*). # Commands & Permissions All plugin commands ### Commands & Permissions To access any `/ae` command, you will need to add `ae.help` permission as well. | Command | Explanation | Permission | | ----------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ----------------------------------- | | /aegive (player) (material) (amount) \[adition args] | Gives a player an item | aegive.permission | | /alchemist | Open alchemist | ae.alchemist | | /asets | Access armor sets and custom weapons | advancedenchants.sets | | /enchanter | Open Enchanter | ae.enchanter | | /gkits | Open GKits | N/A | | /tinkerer | Open Tinkerer | ae.tinkerer | | /withdrawsouls (amount) | Takes a number of souls from an item | N/A | | /ae | Main plugin command | N/A | | /ae about | Information about the current build | N/A | | /ae admin \[page]/\[search string] | Open a menu with all possible enchantments (100% success rate) | ae.admin | | /ae enchant (enchantment) (level) | Apply an enchant to the currently held item | ae.enchant | | /ae give (player) (enchantment) (level) | Give a custom enchanted book | ae.givercbook | | /ae givebook (player) (enchantment) (level) (count) (success) (destroy) | Give book with specific rates | ae.givebook | | /ae givegkit (player) (gkit) | Give player gkit items | ae.givegkit | | /ae giveitem (player) (item) \[amount] | Give various plugin items | ae.giveitem | | /ae giverandombook (player) (group) \[amount] | Gives random book(s) from a group | ae.giverandombook | | /ae givercbook (type) (player) (amount) | Give right-clickable book | ae.givercbook | | /ae greset (player) (gkit) | Resets a GKit for a player | ae.gkits | | /ae info (enchantment) | Information about custom enchantment | ae.info | | /ae lastchanged | Shows all enchants that were added/ removed the last time /ae reload was run | ae.lastchanged | | /ae list | List all custom enchantments | ae.list | | /ae magicdust (group) (rate) (player) | Give magic dust with a specific rate | ae.givedust | | /ae market | Opens menu to download community made enchants | ae.market | | /ae open (player) (enchanter/tinkerer/alchemist) | Force open a GUI for a player | ae.open | | /ae pasteenchants | Creates a pastebin with all enchants | ae.pasteenchants | | /ae plinfo | Creates a bin with info about the plugin and server | ae.plinfo | | /ae premade | View premade plugin configurations | ae.premade | | /ae reload | Reload all configurations | ae.reload | | /ae setSouls (amount) | Sets amount of souls on held item | ae.setsouls | | /ae tinkererItem (player) (amount) | Give tinkerers reward item to a player | ae.givetinkerer | | /ae unenchant (enchant) | Remove an enchant from the currently held item | ae.unenchant | | /ae view (enchant) | Opens a menu containing info about the enchant | Same as enchantment-info permission | | /ae zip | Creates a zip file with all plugin folder contents | ae.zip | ### Other Permissions | Permission | Description | | ------------------ | ---------------------------------------------------------------------------- | | ae.limit.(count) | Sets a custom limit for the number of enchantments a player can put on items | | ae.bypass.souls | Bypasses enchantment's soul requirements | | ae.bypass.cooldown | Bypasses enchantment's cooldowns | # AEGive How to use the "/aegive" command. ### Basic Command Usage ``` /aegive (player) (material) (amount) [args] ``` * **`(player)`**- Name of the player to receive the item. * **`(material)`**- The type of item to give the player. * **`(amount)`**- A number 1-64 representing the number of items to give. * **`[args]`**- Arguments defined below. ### Args * **`color:(red);(green);(blue)`**- The color of the item. Each parameter is a number from 0-255. Only for leather armor/fireworks. * **`itemflag:(flag)`**- An ItemFlag to apply to the item. All flags can be found [here](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/inventory/ItemFlag.html). * **`name:(name)`**- The name of the item. Add spaces with **`_`**. Supports normal colors and HEX. * **`lore:(lore)`**- The lore of the item. Split lines with **`|`**. Add spaces with **`_`**. Supports normal colors and HEX. * **`unbreakable:(true/false)`**- Sets whether or not the item is unbreakable. * **`glowing:(true/false)`**- Sets whether or not the item should glow or not. * **`custommodeldata:(data)`**- (1.14+) Sets the Custom Model Data for the item. * **`attribute:(attribute);(amount)`** - (1.9+) Adds an Item Attribute to the item. ### Enchantments To add enchantments to the item, add **`enchantment:level`** to the args, where **`enchantment`** is the name of the enchantment, and **`level`** is the level of the enchantment. Vanilla enchantments support up to level 32767, custom enchantments only support up to what you have configured. You can have as many enchantments as you like. If there are multiple enchantments with the same name, the most right one will take priority. ### Example Usage ``` /aegive Insprill netherite_pickaxe 1 name:&2&lSuper_Pick lore:&7This_pickaxe_mines_a_lot|&7of_blocks_extremely_fast. unbreakable:true itemflag:HIDE_UNBREAKABLE unbreaking:3 trench:9 telepathy:4 ``` # Languages and Localization Read about built-in translations for the plugin. Starting v8.0.3, AdvancedEnchantments introduces localization by default. Most messages are now available in the `locale` folder of the `AdvancedEnchantments` plugin folder. ## **Included Languages** * **English** en-us * **German** de-de * **Spanish** es-es * **French** fr-fr * **Indonesian** id * **Dutch** nl-nl * **Polish** pl-pl * **Japanese** ja-jp * **Swedish** sv-se * **Turkish** tr-tr * **Arabic** ar * **Russian** ru-ru * **Portuguese** pt-br * **Romanian** ro * **Italian** it * **Chinese** (Simplified) zh-cn * **Chinese** (Traditional) zh-tw * **Hungarian** hu * **Vietnamese** vi * **Korean** ko ## Switching between languages Switching the default plugin language is a very simple process. Simply, change the `language` setting in the `config.yml` to any of language included codes ([**Included Languages**](https://ae.advancedplugins.net/general-information/languages#included-languages), e.g. `en-us`, `id`, `nl-nl`) and restart your server. ```yaml # Change default messages language. You can modify all messages in AdvancedEnchantments `locale` folder. # Read more here: https://ae.advancedplugins.net/general-information/languages language: 'en-us' ``` ## Editing locale file messages Editing the default messages from locale files is very easy. Open the `locale` folder in the `AdvancedEnchantments` folder, then find your assigned language file (default `en-us.yml`) and start editing there. ## Creating custom locale files AE also supports creating your own language files. To do so, simply copy-paste one of the default locale files, rename it to the LCID string of the language you're translating to ([List of LCID strings](https://www.science.co.il/language/Locale-codes.php)). Then, follow the step above, inserting the LCID string of the language you just translated. If you would like to submit your translation to be included in the plugin, join our [Discord server](https://discord.gg/GzdQdMw), create a ticket, and send a [Pastebin](https://pastebin.com/) link containing the contents of your file. # Plugin Items How to give plugin items? Here's an example of how to give admin items to players. ## Plugin items list **All plugin items:** whitescroll, slotincreaser, mystery, secret, magic, blackscroll, randomizer, renametag, blocktrak, stattrak, soultracker, mobtrak, soulgem, transmog, holywhitescroll, orb ## How to Disable/Remove Items It is not possible toemove the AdvancedEnchantments items from the config but if you'd like to make these items unobtainable, ensure you set `chance: 0` in the `lootsConfiguration.yml` file ## Methods of Obtaining There are a few methods for players to obtain AE Items: * Adding them to [Enchanter](/configuration/enchanter) in config * Making [Mobs](/configuration/random-loot-villager-trades-and-mob-drops#mob-drops) drop them * Automatically generating AE Items in [loot](/configuration/random-loot-villager-trades-and-mob-drops#generating-random-loot-from-plugin-into-world) * Having [Villagers](/configuration/random-loot-villager-trades-and-mob-drops#villager-trades) trade them * Selling the items in a shop via another shop plugin * Run `ae giveitem` command from below * Giving them in Crates from another crate plugin ## How to give items ### White scroll **Command Usage**: `/ae giveitem whitescroll `\ **Example Usage**: `/ae giveitem Steve whitescroll 1` ### Slot Increaser **Command Usage**: `/ae giveitem slotincreaser `\ **Example Usage**: `/ae giveitem Steve slotincreaser 1 SIMPLE` ### Mystery Dust **Command Usage**: `/ae giveitem mystery `\ **Example Usage**: `/ae giveitem Steve mystery 1` ### Secret Dust **Command Usage**: `/ae giveitem secret `\ **Example Usage**: `/ae giveitem Steve secret 1 SIMPLE` ### Magic Dust **Command Usage**: `/ae giveitem magic `\ **Example Usage**: `/ae giveitem Steve magic 1 SIMPLE` ### Black Scroll **Command Usage**: `/ae giveitem blackscroll `\ *\* Value of 0 means success chance will be random*\ **Example Usage**: `/ae giveitem Steve blackscroll 1 55` ### Randomization Scroll **Command Usage**: `/ae giveitem randomizer `\ **Example Usage**: `/ae giveitem Steve randomizer 1 SIMPLE` ### Rename Tag **Command Usage**: `/ae giveitem renametag `\ **Example Usage**: `/ae giveitem Steve renametag 1` {% hint style="warning" %} Some people may have issues with using color codes when renaming, if so, check your chat provider, such as DeluxeChat and give players the permission to use color codes. {% endhint %} ### Blocktrak **Command Usage**: `/ae giveitem blocktrak `\ **Example Usage**: `/ae giveitem Steve blocktrak 1` ### Stattrak **Command Usage**: `/ae giveitem stattrak `\ **Example Usage**: `/ae giveitem Steve stattrak 1` ### Mobtrak **Command Usage**: `/ae giveitem mobtrak `\ **Example Usage**: `/ae giveitem Steve mobtrak 1` ### Soulgem **Command Usage**: `/ae giveitem soulgem `\ **Example Usage**: `/ae giveitem Steve soulgem 1 1250` ### Transmog Scroll **Command Usage**: `/ae giveitem transmog `\ **Example Usage**: `/ae giveitem Steve transmog 1` ### Holy White Scroll **Command Usage**: `/ae giveitem holywhitescroll `\ **Example Usage**: `/ae giveitem Steve holywhitescroll 1` ### Enchantment Orbs **Command Usage**: `/ae giveitem orb `\ *\* Types: ARMOR, WEAPON, TOOL*\ **Example Usage**: `/ae giveitem Steve orb 1 ARMOR 15 100` ### Heroic Upgrade **Command Usage**: `/asets giveHeroicUpgrade` \ \ \`[amount]`\ **Example Usage**: /ae giveHeroicUpgrade Steve Yijki 50 1 # All plugin items ### **Slot Increaser** ### ![](https://i.imgur.com/sEsn5Kv.png) * Applying will increase number of slots available on item. * Boundaries can be set to limit number of total slots, or how many increaser can be applied. ### **Enchantment Orbs** ![](https://i.thick.at/TouchedMonteIberiaEleuth.png) * Enchantment orbs can be applied to armor/weapons and will increase the amount of enchants you can apply on that item by number specified in the orb command ### **White Scroll** ![](https://i.imgur.com/caJK2EP.png) * Applying one of these to your item will protect it from being destroyed from a failed enchantment ### **Secret, Mystery and Magic Dust** ![](https://i.imgur.com/xCFSOxe.png) ![](https://i.imgur.com/v8qgzOp.png) ![](https://i.imgur.com/BuPZs6X.png) * Increase book(s) success rate, while decreasing failure. The higher success rate is, the higher chance of enchantment applying on item. ### **Black Scroll** ![](https://i.imgur.com/YbQV40y.png) * Applying this item will take away one random custom enchantment from item, and give a book of it with certain success & destroy rates \[can be changed in config] ### **Randomization Scrolls** ![](https://i.imgur.com/2oE05zD.png) * Applying one of these to the given custom enchant book will randomize the success and destroy rates ### **Item Nametags** ![](https://i.imgur.com/j6BeNkQ.png) * Using one will let you rename items. Word blacklist and other settings (such as colors) can be toggled in config.yml ### **BlockTrak** ![](https://i.imgur.com/lRdZMkV.png) * Apply a tracker on tools to track number of blocks mined using the item. ### **StatTrak** ![](https://i.imgur.com/M48hjUm.png) * Applyable on weapons, to track kills done with the item. ### **Soul Tracker** ![](https://i.imgur.com/cDKpw4V.png) * "Stack" souls on items as fuel, then use for enchantments. ### **Transmog Scroll** ![](https://i.imgur.com/zJP3yeK.png) * Organize enchantments on item in order ### **Holy White Scroll** ![](https://i.imgur.com/FCX9uHj.png) * Save items after death. ### **Mob Trak** ![](https://i.imgur.com/FPfzpuV.png) * Track how many mobs have been killed with an item. # Item Configuration ## World Blacklist #### How to disable custom items in certain worlds? Simply add settings.world-blacklist list of worlds item should be disabled in, this is per-item and you must configure this for each item you want to disable. E.g.: {% code fullWidth="true" %} ```yaml white-scroll: # Obtain white scroll by giving it with command "/ae giveitem whitescroll" # Should the white scroll be removed once applied enchantment fails? delete: true # Display in item lore lore-display: "&f&lPROTECTED" item: type: EMPTY_MAP id: 0 custom-model-data: 0 force-glow: false name: "&fWhite Scroll" lore: - "&fPrevents an item from being destroyed" - "&fdue to a failed Enchantment Book." - "&ePlace scroll on item to apply." settings: world-blacklist: - 'MyWorld' ``` {% endcode %} # Slot Increasers The Slot Increaser is an integral feature of AdvancedEnchantments, offering a way to increase item slots. ### Functionality and Features #### Core Purpose * **Enhancing Capacity**: The Slot Increaser's primary function is to increase the enchantment slots on items, allowing players to apply more enchantments than the standard item limits. #### Enchantment Groups * **Categorization**: Similar to enchantments, Slot Increasers are grouped (e.g., ELITE, UNIQUE), with each group indicating the number of additional slots added. The group does not restrict the type of enchantments that can be added. #### Command Interface * **Command Usage**: `/ae giveitem slotincreaser ` **Example** * **Command Execution**: Executing `/ae giveitem Steve slotincreaser 1 SIMPLE` would provide the player 'Steve' with a Slot Increaser from the SIMPLE category, which would add a specific number of slots to an item. # Toggling Features Guide on how to toggle certain plugin features. ## Disable **Enchante**r, **Tinkerer, or Alchemist** Change **enabled** to false to any specific command in config.yml file, located in AdvancedEnchantments folder and restart the server ```yaml # Manage plugin commands commands: advancedenchantments: # Should 'no permission' message be shown when # user does not have 'ae.help' permission permissionMessageEnabled: true permissionMessage: - '&6&lAdvancedEnchantments &cYou do not have permission to use this command.' enchanter: # Is command enabled? enabled: true # Main command to open Enchanter command: /enchanter # List of commands that will act as the command aliases: - 'e' - 'ce' tinkerer: enabled: true command: /tinkerer aliases: - 'tinker' alchemist: enabled: true command: /alchemist aliases: - 'alchem' ``` ## Disable enchantment table Change **enabled** to false in enchantmentTable.yml file, located in AdvancedEnchantments folder and restart the server. # Random Loot, Villager Trades and Mob Drops Guide on enabling and configuring random loot generation and custom villager trades. ## Generating random loot from plugin into world AdvancedEnchantments supports spawning random loot into any chests generated in wild, e.g. mob spawner rooms, mineshaft etc. To enable it, simply go into \/plugins/AdvancedEnchantments/lootConfiguration.yml file, set `randomLootEnabled` to true {% code title="lootConfiguration.yml" %} ```yaml # ------ Random Loot Section ------ # randomLoot: # Should random loot be generated in world? randomLootEnabled: true # <--- set here to true # Blacklisted groups, these group books cannot generate in random loot blacklisted-groups: - 'STAFF' # <--- set here groups you dont want generate in random loot ``` {% endcode %} And restart your server! Now Random loot will spawn in vanilla generated chests / containers - just like default vanilla loot. Below this, in configuration file, you can configure chances for each item to spawn. ## Villager Trades Villagers can trade custom enchantment books and admin items, e.g. white scrolls, orbs, dusts. To enable it, simply go into \/plugins/AdvancedEnchantments/lootConfiguration.yml file, set `villagerTradesEnabled` to true {% code title="lootConfiguration.yml" %} ```yaml # ------ Villager Trades Section ------ # villagerTrades: # Should villagers be able to trade custom books / items? villagerTradesEnabled: true # <--- set here to true # Blacklisted groups, these group books cannot generate in villager trades blacklisted-groups: - 'STAFF' # <--- set here groups you dont want to be available in villager trades ``` {% endcode %} And restart your server! Now new villager trades will include custom items from plugin. Below this setting, in configuration file, you can configure chances for each item to be included in trades. Prices are based on vanilla pricing and are random. ## Mob Drops Mobs can drop any AE Plugin Item from [here](/general-information/giving-plugin-items) To enable it, simply go into \/plugins/AdvancedEnchantments/mobs.yml file, add mobs, chances, items {% code title="mobs.yml" %} ```yaml # You can give custom AE items when mobs are killed # Item names must be same as from '/ae giveitem' command (for future references). # Current items: whitescroll, renametag, blocktrak, stattrak, soultracker, mobtrak, transmog, randomenchantmentbook, secret:: # Format: ":" mobs: ZOMBIE: chance: 75 items: - "randomenchantmentbook:1" SKELETON: chance: 50 items: - "whitescroll:1" ``` {% endcode %} And restart your server! Now when a mob is killed it will drop the various items you've configured {% hint style="warning" %} Note: These items will only drop from active player kills, and not passive deaths {% endhint %} # Enchanter Enchanter configuration, economy and how to sell not only enchantments but other items - it's all explained here. #### Enchanter's configuration is located in `plugins/AdvancedPlugins/menus/Enchanter.yml` ### Available economy types You can use any of these economy types when it comes to enchanter. Simply, changing between price configuration (explained further below [Charge players for clicking items](https://ae.advancedplugins.net/configuration/enchanter#charge-players-for-clicking-item) you can learn where to change prices) * exp * money * level * souls (works with items that are held when opening inventory) * diamonds * gold (gold ingots) * emeralds ### Configure Basic Items To set up custom items in the enchanter that have no functionality is very simple and uses basic item formatting from all AE items: ``` '3': item: type: ANVIL id: 0 force-glow: false name: '&aOpen Tinkerer' lore: - '&7Open Tinkerer' ``` ### Run commands with items The item will have no functionality, but in the previous case, you might want to add item some functionality. We can do this by adding new settings to run a command: ``` '3': item: type: ANVIL id: 0 force-glow: false name: '&aOpen Tinkerer' lore: - '&7Open Tinkerer' player-command: - 'tinkerer' ``` ### Charge players for clicking item player-command will make the player run specified commands when clicked. You can as well use console-command to run commands from the servers console when the player clicks - this is especially useful when selling products in enchanter: ``` '2': item: type: PAPER id: 0 force-glow: false price: money:400 name: '&f&lWhitescroll &7(Click to buy)' lore: - '&fPrevents an item from being destroyed' - '&fdue to a failed Enchantment Book.' - '&ePlace scroll on items to apply.' - '' - '&b&lCOSTS &f$400' console-command: - 'ae giveitem %player% whitescroll 1' ``` ### Sell custom enchantments To simply sell custom enchantment books define the group to which it should target: ``` '4': item: type: STAINED_GLASS_PANE id: 3 force-glow: false enchant-group: ELITE price: exp:2500 name: '&b&lElite Enchantment &7(Right Click)' lore: - '&7Examine to recieve a random' - '&belite &7enchantment book.' - '' - '&b&lCOST &f2500 EXP' ``` # Souls Explanation of what Souls are, how to obtain them and how to use them. Souls are a special built-in currency, designed to balance powerful enchantments by charging Souls per enchant activation. They can be very simply added to any enchantment, e.g.: ```yaml levels: 1: souls: 100 effects: - 'MESSAGE:This will only activate if player had enough souls!' ``` ## How to obtain souls? Souls can be gathered by killing players using weapons with Soul Trackers applied on them. \ The Soul Tracker item is given with a command: > /ae giveitem \ soultracker 1 For every player kill with an item that has a soul tracker, they will gain **1 soul on the item.** This can be changed to a different amount in **config.yml**: ```yaml settings: # Amount of souls given per kill souls-per-kill: 1 ``` Souls from mobs can be gathered by enabling this setting in **config.yml:** ```yaml settings: # Should souls be collected from mobs? collect-souls-from-mobs: true ``` Souls from mining blocks can be enabled by changing these settings in the **config.yml**. ```yaml settings: # Collecting souls from mining # This can be used as a "tokens" currency for prison servers miningSouls: enabled: false # Chance to gain a soul from mining chance: 20 ``` You can also give players **Soul Gems** which can be drag & dropped onto items that have Soul Trackers applied to them. These will increase Souls on items by the specified amount, obtain these items through this command: > /ae giveitem \ soulgem 1 \ # Unsuccessful enchants Enchantment books have success and destroy rates. Here you can learn how to toggle parts of it. ## Change book chances Enable / Disable chances: [Link to config.yml setting](https://github.com/GC-spigot/AdvancedEnchantments/blob/333e70371108237b490c8fefe49d3c8fa34d9310/config.yml#L636) Change default chances: [Link to config.yml setting](https://github.com/GC-spigot/AdvancedEnchantments/blob/333e70371108237b490c8fefe49d3c8fa34d9310/config.yml#L639) \ To enable default pre-set chances, you will need to disable random chances as well. ## Disable items from breaking when enchantment fails Disable breaking when applied enchantment book fails: [Link to config.yml setting](https://github.com/GC-spigot/AdvancedEnchantments/blob/333e70371108237b490c8fefe49d3c8fa34d9310/config.yml#L629) Disable breaking when the enchantment is being upgraded: [Link to config.yml setting ](https://github.com/GC-spigot/AdvancedEnchantments/blob/333e70371108237b490c8fefe49d3c8fa34d9310/config.yml#L185) # Per-Level Descriptions Learn how to add per-level description for enchantments Starting 9.5.0, it is possible to add per-level descriptions for enchantments. It's very simple to do: Here is an example with `hasten` enchantment, where you can describle per-level descriptions better: {% code title="enchantments.yml" overflow="wrap" fullWidth="true" %} ```yaml hasten: display: '%group-color%Hasten' applies-to: Tools type: MINING group: SIMPLE applies: - ALL_PICKAXE - ALL_SPADE - ALL_AXE levels: '1': chance: 15 cooldown: 3 description: Chance to gain Haste 1 after breaking blocks. effects: - POTION:FAST_DIGGING:0:40 '2': chance: 25 cooldown: 3 description: Chance to gain Haste 2 after breaking blocks. effects: - POTION:FAST_DIGGING:1:60 ``` {% endcode %} It's as simple as adding a `description` value under each level, just like `chance` or `cooldown` would be added for enchantments! In config.yml, you must also change for items and books to utilize %level-description% instead of %description%. This will be located at the bottom of config.yml file, under `settings` (full path: `settings.lore-descriptions.enabled`)

# Should enchantment descriptions be added under enchant names in lores?
#   for per level descriptions use %level-description%. (will default to %description% if level description is not setup)
#   if level description is set, but here it's still still to %description%, the placeholder won't parse!
lore-descriptions:
  enabled: false
  display: "%group-color%* &8%description%"

and under `enchantment-book` (full path: `enchantment-book.lore`)

enchantment-book:
  lore:
  - '&a%success%% Success Rate'
  - '&c%destroy%% Destroy Rate'
  - '&e%description%'
  - '&7%applies-to% Enchantment'
  - '&7Drag n'' drop onto item to enchant'

# Per-Level Books Learn how to change book item on each enchantment and each level Starting 9.17.0, it is possible to change items on each level of a specific enchantment. Similar to how [groups can change this](/configuration/groups#per-group-enchantment-books). It's very simple to do: Here is an example with `hasten` enchantment, where you can for example just change the `custom-model-data` or you can even change the whole item: {% code title="enchantments.yml" overflow="wrap" fullWidth="true" %} ```yaml hasten: display: '%group-color%Hasten' applies-to: Tools type: MINING group: SIMPLE applies: - ALL_PICKAXE - ALL_SPADE - ALL_AXE levels: '1': # WE CAN SEE HERE THAT ONLY CUSTOM MODEL DATA IS CHANGED item: custom-model-data: 99 chance: 15 cooldown: 3 effects: - POTION:FAST_DIGGING:0:40 '2': # HERE, MORE PARAMETERS OF THE ITEM ARE BEING CHANGED item: type: ENCHANTED_BOOK name: '&6Harvest II' lore: |- &7Harvest in a 3x3 area. &7Chance to harvest in a 3x3 area. chance: 25 cooldown: 3 effects: - POTION:FAST_DIGGING:1:60 ``` {% endcode %} Any value that is not present here will be taken from the `config.yml` in the `enchantment-book` section {% code title="config.yml" overflow="wrap" lineNumbers="true" fullWidth="true" %} ```yaml enchantment-book: # If true, books can be applied to items in anvils. anvil-application: false # If true, books can be applied to items by dragging and dropping them on the item in an inventory. drag-drop-application: true item: type: ENCHANTED_BOOK id: 0 custom-model-data: 0 force-glow: false # Variables: %enchant%, %enchant-no-color%, %description%, %level-description%, %applies%, %success%, %destroy%, %color%, %max-level% name: "%group-color%&l&n%enchant-no-color% %level%" lore: - "&a%success%% Success Rate" - "&c%destroy%% Destroy Rate" - "&e%description%" - "&7%applies-to% Enchantment" - "&7Drag n' drop onto item to enchant" ``` {% endcode %} # Enchantments In Essentials Kits Including Custom Enchantments in EssentialsX Kits Enchantments are based on NBT data, therefore adding enchantments in lore will not work. Solution is to have commands in kits which give out items with custom enchants: {% hint style="info" %} **/aegive \ \ \ \**\ **Example Usage:**`/aegive GC 1 diamond_helmet name:&d&lName protection:5 glowing:1 lore:&&7cLore_line#1|&&7cSecond_Line` {% endhint %} Using this command, custom enchanted items can be given using similar to Essentials Kits (and the /give command) formatting. [EssentialsX ](https://www.spigotmc.org/resources/essentialsx.9089/)is required for further steps. It's an improvement and continuation of the legacy Essentials plugin. Essentials Kits are located in `plugins/Essentials` `Kits.yml` file. Example Kits with Custom enchanted items: ```yaml items: delay: 6000 items: - GOLDEN_APPLE 64 - DIAMOND_PICKAXE efficiency: 5 - /aegive {player} DIAMOND_SWORD 1 sharpness:5 unbreaking:5 customenchant:2 anotherenchant:6 name:&cDiamond&d_Chestplate - /aegive {player} DIAMOND_CHESTPLATE 1 protection:4 unbreaking:5 customenchant:2 anotherenchant:6 name:&cDiamond&d_Chestplate ``` Here's a kit with 2 items that have custom enchants. By listing commands in kits, it's possible to give out custom enchanted items with Essentials kits. # GKits #### Example ![](https://camo.githubusercontent.com/eb8d573b4c92d4c7db6dd848dcdb4bc0c6c184f1/68747470733a2f2f692e696d6775722e636f6d2f413370377646302e706e67) #### Explanation It's now possible to put a `customization:` block in your `plugins/AdvancedEnchantments/menus/gkits.yml` to provide additional customization to the GKits inventory. ``` customization: 27: material: STAINED_GLASS_PANE damage: 15 amount: 1 name: " " lore: [] ``` Full gkits.yml with this customization enabled: # GKit Permissions ### GKIT Permissions In the AdvancedEnchantments plugin, GKITs are customizable kits that can be used by players on the server. Each GKIT has its own unique permission that allows players to access and use it. The following is a list of GKITs and their corresponding permissions: * Spooky GKIT: `gkit.spooky` * Hyperdrive GKIT: `gkit.hyperdrive` * Destroyer GKIT: `gkit.destroyer` * Guardian GKIT: `gkit.guardian` * Diablo GKIT: `gkit.diablo` * Valentines GKIT: `gkit.valentines` * Arcane GKIT: `gkit.arcane` * Gladiator GKIT: `gkit.gladiator` * Trickster GKIT: `gkit.trickster` * Templar GKIT: `gkit.templar` * Viking GKIT: `gkit.viking` * Tinkermaster GKIT: `gkit.tinkermaster` * Admiral GKIT: `gkit.admiral` * PartyAnimal GKIT: `gkit.partyanimal` * Enchantment GKIT: `gkit.enchantment` * Grandmaster GKIT: `gkit.grandmaster` * Voidwalker GKIT: `gkit.voidwalker` * MasterBuilder GKIT: `gkit.masterbuilder` * Independence GKIT: `gkit.independence` * ArenaChampion GKIT: `gkit.arenachampion` * Butcher GKIT: `gkit.butcher` * Cannoner GKIT: `gkit.cannoner` * Cosmonaut GKIT: `gkit.cosmonaut` * Paladin GKIT: `gkit.paladin` * Warlock GKIT: `gkit.warlock` * Loki GKIT: `gkit.loki` * GrimReaper GKIT: `gkit.grimreaper` # Colored Leather Armor Colored leather armor for GKits How-to: Set leather armor color using `color: ;;` * RGB is a color variant, you can find color numbers here: Example: ``` items: helmet: name: '&c&lPhantom Hood' customModelData: 0 color: 255;0;0 itemFlags: []` ``` # Armor Sets ## Overview AdvancedEnchantments offers the capability to create custom armor sets with unique effects. Players must equip all four pieces of armor to activate the full set bonus. You can apply any desired effect to the armor, ranging from beneficial potion effects to dramatic lightning strikes. Given the support for all enchantment effects, the opportunities for customizing armor sets are virtually limitless. ## Utilizing the ItemsAdder Plugin For server owners using the ItemsAdder plugin, there's a special setting in the AdvancedEnchantments configuration to enhance the armor set even further: `items..itemsadder` By setting the item name from the ItemsAdder plugin here, you can leverage custom textures for your armor. This will be included in the example configuration below. ## Configuration **Example Configuration:** {% code title="armorSets/Lava.yml" lineNumbers="true" fullWidth="true" %} ```yaml name: '&b&lLava Set' material: LEATHER settings: equipped: - '&a&l(!) &aYou have activated the Lava set!' unequipped: - '&c&l(!) &cYou have deactivated the Lava set!' items: helmet: name: '&b&lLava Helmet' itemsadder: lava_helmet lore: - '&cTest lore!' itemFlags: [] events: ATTACK: chance: 100 effects: - INCREASE_DAMAGE:10 cooldown: 0 DEFENSE: chance: 100 effects: - DECREASE_DAMAGE:10 cooldown: 0 ``` {% endcode %} The above example showcases the Lava Set, which is made of leather and comes with a unique helmet with custom lore. When equipped, the set provides an increased damage effect during attacks and a decreased damage effect during defense. The configuration is versatile, allowing for numerous effects and events to be tied to different armor sets. # Drag\&Drop books onto Player Heads **Steps to Enable Drag & Drop for PLAYER\_HEAD** To allow custom enchantment books to be applied onto PLAYER\_HEAD items through a drag-and-drop action, you need to modify the `enchantments.yml` file. Here's how to do it: * **1. Locate the Enchantment Entry:** Find the specific enchantment entry in the `enchantments.yml` file. This file contains all the custom enchantments available on your server. * **2. Modify the 'Applies' Section:** In the enchantment entry, look for the `applies` section. This section determines which items the enchantment can be applied to. * **3. Add PLAYER\_HEAD to the Applies Section:** Under the `applies` section, add `- PLAYER_HEAD` to allow the enchantment to be applied to PLAYER\_HEAD items. Here's an example for the `glowing` enchantment: ```yaml glowing: display: '%group-color%Glowing' description: Gives permanent night vision. applies-to: Helmet type: EFFECT_STATIC group: SIMPLE applies: - ALL_HELMET - PLAYER_HEAD levels: '1': effects: - POTION:NIGHT_VISION:0 ``` * **4. Save Changes and Reload:** After making the changes, save the `enchantments.yml` file. Then, reload the plugin configurations on your server to apply the changes.
# Groups Configuration of groups.yml file In making. More documentation soon ## Per Group Enchantment Books You can also set different books items for specific groups. Here is an example how: ```yaml groups: SIMPLE: global-color: "&7" group-name: "Simple" enchant-book-item: item: type: PAPER id: 0 custom-model-data: 0 force-glow: false name: "%group-color%&l&n%enchant-no-color% %level%" lore: - "&a%success%% Success Rate" - "&c%destroy%% Destroy Rate" - "&e%description%" - "&7%applies-to% Enchantment" - "&7Drag n' drop onto item to enchant" ``` # Plugin API Download API at: https\://www\.spigotmc.org/resources/advancedenchantments-api.76819/ AEAPI class functions: ![AEAPI](https://camo.githubusercontent.com/f01933d8a3682f5cfb4e65a7869860b9a7723b2e/68747470733a2f2f692e696d6775722e636f6d2f455863797949352e706e67) ### Apply custom enchants Applying custom enchants is simple. Do remember, that the `AEAPI.applyEnchant` method also returns a modified ItemStack, which you will need to override with your current ItemStack object. Example: ```java ItemStack item = your item; item = AEAPI.applyEnchant("enchantName", enchantLevel, item); ``` ### Listen to events We run normal Bukkit extended events. You can listen to those like you do with any other event. The package where events are is `net.advancedplugins.ae.impl.effects.api` and `net.advancedplugins.ae.api` Don't use deprecated events! These might not be called at all at times!
@EventHandler public void onEnchantActivate(EffectsActivateEvent e) { // Do as you wish or cancel the event }
# Create Custom Effects ### Using AE's API for Effect Registration To integrate custom effects into the AdvancedEnchantments system, developers must utilize the `AEAPI` class from the `net.advancedplugins.ae.api` package. The crucial method in this process is `registerEffect`, defined in the `AEAPI` class. #### `registerEffect` Method {% code fullWidth="false" %} ```java /** * Register a new effect. * * @param plugin Plugin that is registering the effect. * @param effect Effect to register. * @return true if the effect was registered, false if not. */ public static boolean registerEffect(JavaPlugin plugin, AdvancedEffect effect) { } ``` {% endcode %} This method is pivotal for registering new effects. It requires the plugin instance and the custom effect as arguments. The method returns a boolean indicating the success or failure of the registration process. ### The `AdvancedEffect` Class To create a custom effect, developers must extend the `AdvancedEffect` class. This class serves as the base for all custom effects and provides several constructors and methods to define the effect's behavior. #### Constructors The `AdvancedEffect` class offers multiple constructors, allowing developers to define various aspects of their custom effect: 1. **Basic Constructor:**
public AdvancedEffect(JavaPlugin plugin, String effectName)
This constructor initializes the effect with a name. 2. **Extended Constructor:**
public AdvancedEffect(JavaPlugin plugin, String effectName, String description, String usage)
This variant allows adding a description and usage information. 3. **Weighted Constructor:**
public AdvancedEffect(JavaPlugin plugin, String effectName, String description, String usage, int weight)
Adds an additional parameter for weight, which can influence how the effect is handled or prioritized. #### Methods The `AdvancedEffect` class contains methods to execute the effect: 1. **executeEffect (LivingEntity target):**
public boolean executeEffect(ExecutionTask task, LivingEntity target, String[] args) { return false; }
Triggers the effect for a living entity target. 2. **executeEffect (Location target):**
public boolean executeEffect(ExecutionTask task, Location target, String[] args) { return false; }
Activates the effect at a specific location. # Create Custom Triggers ### Using AE's API for Trigger Registration To integrate custom triggers into the AdvancedEnchantments system, developers must utilize the `AEAPI` class from the `net.advancedplugins.ae.api` package. The crucial method in this process is `registerTrigger`, defined in the `AEAPI` class. #### `registerTrigger` Method {% code fullWidth="false" %} ```java /** * Register a new trigger. * * @param plugin Plugin that is registering the trigger. * @param trigger Trigger to register. * @return true if the trigger was registered, false if not. */ public static boolean registerTrigger(JavaPlugin plugin, AdvancedTrigger trigger) { } ``` {% endcode %} This method is pivotal for registering new triggers. It requires the plugin instance and the custom trigger as arguments. The method returns a boolean indicating the success or failure of the registration process. ### The `AdvancedTrigger` Class To create a custom trigger, developers must extend the `AdvancedTrigger` class. This class serves as the base for all custom triggers and provides several constructors and methods to define the triggers's behavior. The `AdvancedTrigger` class implements a bukkit Listener interface and is automatically registered in the super constructor. All you need to do is build the execution when the trigger should be triggered. This is how an `EAT` trigger would look: ```java @EventHandler(priority = EventPriority.HIGHEST, ignoreCancelled = true) public void onConsume(PlayerItemConsumeEvent e) { Player p = e.getPlayer(); if (p.isDead() || !p.isValid()) return; for (StackItem si: GetAllRollItems.getMainItems(p)) { executionBuilder() .setAttacker(p) .setAttackerMain(true) .processVariables( "%food type%;" + ASManager.getMaterial(e.getItem()) ) .setEvent(e) .setStackItem(si) .setItemType(si.getRollItemType()) .setItem(si.getItem()) .buildAndExecute(); } } ``` # Create Custom Targets ### Using AE's API for Target Registration To integrate custom targets into the AdvancedEnchantments system, developers must utilize the `AEAPI` class from the `net.advancedplugins.ae.api` package. The crucial method in this process is `registerTarget`, defined in the `AEAPI` class. #### `registerTarget` Method {% code fullWidth="false" %} ```java /** * Register a new target type. * * @param plugin Plugin that is registering the target type. * @param type Target type to register. * @return true if the target type was registered, false if not. */ public static boolean registerTarget(JavaPlugin plugin, TargetType type) { } ``` {% endcode %} This method is pivotal for registering new targets. It requires the plugin instance and the custom target as arguments. The method returns a boolean indicating the success or failure of the registration process. ### The `TargetType` Class To create a custom target, developers must extend the `TargetType` class. This class serves as the base for all custom targets and provides several constructors and methods to define the targets' behavior. All you need to do is return the target list. This is how an `ADD` target would look: ```java public class AddTarget extends TargetType { public AddTarget() { super("Add"); } @Override public TargetResults getTargets(String effect, String target, ExecutionTask task) { double x = Double.parseDouble(classifyTarget(target).getOrDefault(TargetArgument.X, "0.0")); double y = Double.parseDouble(classifyTarget(target).getOrDefault(TargetArgument.Y, "0.0")); double z = Double.parseDouble(classifyTarget(target).getOrDefault(TargetArgument.Z, "0.0")); Location loc = task.getBuilder().getMain().getLocation().clone().add(x, y, z); return TargetResults.builder().targetLocations(Collections.singletonList(loc)).build(); } } ``` Do note tht the classifyTarget method will work only for internal parameters. If you want any custom one's you will need to parse the arguments yourself # Plugin Compatiblity issues Issues you might encounter with other plugins conflicting with AE and how to fix them ## Multiple Blocks Break / Performance on block break The most common issue is two plugins calling new BlockBreakEvents in loop and both breaking the blocks. With Auxilor plugins (Eco plugins) and Veinminer plugin author Choco we have decided to mark blocks which are involved in these operations with same metadata. If your plugin also calls events and breaks blocks, you might need to check this metadata and ignore the block event if present The metadata is `blockbreakevent-ignore` You can also check for these blocks using AEAPI method ```java AEAPI.ignoreBlockEvent(block); ``` ## TP\_DROPS duplicating drops to multiple inventories This issue occurs when two or more plugins handle adding the drop to some inventory. You can stop us from adding the drops to player inventory by flagging the block with any metadata and adding this metadata in our config.yml ```yaml # Will ignore items drops from blocks with the following meta. Their drops will be ignored and won't be handled by us. # No need to add anything here unless you have compatibility issues with other plugins producing multiple drops. # https://ae.advancedplugins.net/for-developers/plugin-compatiblity-issues#tp_drops-duplicating-drops-to-multiple-inventories ignored-metadata-block-drops: - "some-random-metadata" ``` Or by using our API method inside AEAPI class ```java AEAPI.addIgnoreBlockWithMeta("some-random-metadata"); ``` Then on BlockBreakEvent, you need to set the metadata before us. We are currently running our checks on priority `HIGH`, so anything lower than that will work. ```java @EventHandler(priority = EventPriority.LOW, ignoreCancelled = true) private void onBlockBreak(BlockBreakEvent event) { event.getBlock().setMetadata("some-random-metadata", new FixedMetadataValue(EffectsHandler.getInstance(), true)); } ``` To avoid memory leaks, after you are done with the block, remove the metadata ```java block.removeMetadata("some-random-metadata", plugin); ``` # PlaceholderAPI placeholders Available placeholders for PAPI
Placeholder
%advancedenchantments_total% Total number of enchants available on server (number)
%advancedenchantments_total_<group>% Total enchants in a group (number)
%advancedenchantments_item_enchants_total% Number of enchants on held item
%advancedenchantments_item_enchants_total_<group>% Number of enchants from specific group on held item
# FAQ & Other Plugin Support Answers to a lot of frequently asked questions ## How can I merge premade configurations? There is no way to automatically merge premade configurations. It is also not recommended as there is a lot of overlap between packs. However, it is possible to achieve this by manually comparing and copy/ pasting each enchantment, but note that a lot of enchants are very similar/ the same just with different names. Groups would also need to be changed to ensure they match the groups you have. ## How can I disable an enchantment? There are two ways to disable an enchantment. You can either delete it from the `enchantments.yml` file or you can add `enabled: false` to the enchantments like so: ``` my-enchant: enabled: false ``` ## Specified group does not exist! If you're getting a warning in your server's console that looks like `Failed to load the "x" enchantment! Reason: specified group "y" does not exist!`, it means the group assigned to the enchantment does not exist. This is most common when downloading pre-made enchantments from the marketplace. All you need to do is open the `enchantments.yml`, navigate to the enchantment in question, and change the `group:` string to a group that exists. All groups can be found in the `groups.yml`. ## Non-English languages garbled in-game Add `-Dfile.encoding=UTF-8` to your server's startup flags. ## Hex Colors To use Hex Colors Here is an Example of the Format needed {#88b94b}Planter ## Skript 'on break' By default skript's `on break:` does not work with AdvancedEnchantments. You need to use `on break with priority lowest:` to use lower priority, so Skript event runs before AE.

Placeholder
%advancedenchantments_total%	Total number of enchants available on server (number)
%advancedenchantments_total_<group>%	Total enchants in a group (number)
%advancedenchantments_item_enchants_total%	Number of enchants on held item
%advancedenchantments_item_enchants_total_<group>%	Number of enchants from specific group on held item