Skip to main content

Custom Enchantments List

EliteMobs adds custom enchantments to enhance gameplay. Every enchantment -- custom and vanilla-extending alike -- has its own file in the enchantments configuration folder.

Enchantment config fields

KeyMeaning
isEnabledWhether the enchantment exists at all
nameDisplay name used in item lore
maxLevelV2The level cap used when rolling and displaying the enchantment
valueHow much one level contributes to an item worth calculation (used by shops and selling)
isEnabledForProcedurallyGeneratedItemsWhether procedurally generated loot can roll this enchantment
maxEnchantmentLevelHard ceiling the plugin will never exceed, even through enchanting

Some files add extra keys, listed in the sections below.

Enchantment Summary

EnchantmentDescriptionItem Type
Critical StrikesChance for a 1.5x damage critical hit on Elite MobsWeapons
DrillingMine blocks in a radiusPickaxes, Shovels
Elite Protection/Sharpness/etc.Extends vanilla enchantments beyond normal limitsAll applicable
FlamethrowerFire a jet of flamesAny
HunterIncreases Elite Mob spawn rateAny
Ice BreakerFreezes water on hitPickaxes
EarthquakeKnockback jump attackBoots
Grappling HookGrapple to target blocksBows
LightningChance to strike lightningWeapons
Loud StrikesIncreases aggro for tankingWeapons
Meteor ShowerSpawns fireballs from the skyAny
Plasma BootsDamage dealing particle jumpBoots
RepairConvert items to scrap materialsAny
Summon MerchantSummons Jeeves the merchantPaper
Summon WolfSummons a friendly wolfAny
UnbindRemoves soulbind from itemsScrolls
SoulbindBinds items to playersAny
Lucky SourceMarks an item as a lucky ticketInternal
Enchanted SourceMarks an item as an elite enchantment bookInternal

Shipped values for the EliteMobs-only enchantments

FilemaxLevelV2maxEnchantmentLevelvalueRolls on procedural loot
critical_strikes.yml2313yes
drilling.yml4415no
earthquake.yml5550no
flamethrower.yml1120no
grappling_hook.yml1110no
hunter.yml3310yes
ice_breaker.yml2210no
lightning.yml5515yes
loud_strikes.yml3106no
meteor_shower.yml11130no
plasma_boots.yml3320no
repair.yml5515no
soulbind.yml1110yes
summon_merchant.yml1110no
summon_wolf.yml1120no
unbind.yml1110000no
lucky_source.yml1120no
enchanted_source.yml1110yes

mending.yml ships with isEnabled: false -- Mending is off by default on EliteMobs items.


Critical Strikes

KeyDetails
EffectChance to land a critical hit dealing 1.5x damage to Elite Mobs
Chance per Level10% (Level 1 = 10%, Level 2 = 20%, etc.)
Procedural Cap (maxLevelV2)Level 2
Absolute Max LevelLevel 3
Total chance cap across all gear40% (configurable)

Critical Strikes give a chance to land a critical hit that deals 1.5x the damage to an Elite Mob. Each level of Critical Strike increases the critical strike chance by 10%.

There is a hard cap on total crit chance

Critical strike chance is added up across all six equipment slots -- 4 armor pieces plus mainhand and offhand. Without a ceiling that easily reaches 100%, at which point every hit is a "critical" hit: the crit stops standing out as an event while still paying out the full 1.5x multiplier.

The total is therefore capped by maximumCriticalStrikeChance in MobCombatSettings.yml, which defaults to 0.40 (40%). The value is clamped into the [0.0, 1.0] range. Anything above 0.5 is not recommended, for the reason above.

This means stacking Critical Strikes on every piece of gear stops paying off well before the enchantment's own level cap does.

critical_strikes.yml adds two display keys on top of the standard enchantment fields:

KeyDefaultPurpose
criticalHitPopup&5Critical Hit!Text of the extra popup shown on a critical strike
criticalHitColor&5Colour prefix applied to the critical damage number

Drilling

KeyDetails
EffectMine blocks in a radius
Level Range1-4 (maxLevelV2 and maxEnchantmentLevel are both 4)
Blocks per LevelLevel 1 = 1 extra block straight ahead, Level 2 = a 4-block cross, Level 3+ = stacked 3x3 layers going deeper
Valid ItemsPickaxes, Shovels
Procedural lootNo -- isEnabledForProcedurallyGeneratedItems: false

The drilling enchantment allows pickaxes and shovels to mine blocks in a radius around the target block. The higher the level, the larger the area and depth mined. Only blocks of the same type will be mined. Sneaking while mining disables the enchantment effect.


Elite Enchantments

KeyDetails
EffectExtends vanilla enchantments beyond normal limits
ActivationOnly against EliteMobs
RequirementItem must exceed vanilla enchantment cap

Elite enchantments extend vanilla Minecraft enchantments beyond their normal level limits and apply these enhanced values when fighting against Elite Mobs.

Items only start gaining Elite enchantments once they have gone over the vanilla limits of the enchantment level. For example, vanilla Protection caps at level 4. An item with Protection 5 and Elite Protection 10 will count as Protection 15 armor for Elite Mobs, but only Protection 5 for other mobs.

Supported Enchantments
CategoryEnchantments
ArmorProtection, Fire Protection, Blast Protection, Projectile Protection, Feather Falling, Thorns, Respiration, Depth Strider, Frost Walker, Soul Speed, Swift Sneak
WeaponSharpness, Smite, Bane of Arthropods, Knockback, Fire Aspect, Looting, Sweeping Edge
BowPower, Punch, Flame, Infinity
ToolEfficiency, Fortune, Silk Touch
FishingLuck of the Sea, Lure
TridentImpaling, Loyalty, Riptide, Channeling
CrossbowQuick Charge, Piercing, Multishot
MaceDensity, Breach, Wind Burst
SpearLunge
OtherMending, Unbreaking, Curse of Binding, Curse of Vanishing, Aqua Affinity

Flamethrower

Flamethrower fires a jet of flames from enchanted gear. It is a single-level enchantment: flamethrower.yml ships with maxLevelV2: 1 and maxEnchantmentLevel: 1, a value of 20, and does not roll on procedurally generated loot, so it only reaches players through custom items and enchanted books.


Hunter

Hunter increases the Elite Mob spawn bonus provided by the enchanted gear. hunter.yml adds one extra key, hunterSpawnBonus (default 0.05), which is the spawn-chance bonus contributed per enchantment level. The enchantment caps at level 3 and does roll on procedurally generated loot.

This is one of the enchantments that directly affects progression pace rather than combat stats.


Ice Breaker

Ice Breaker is the pickaxe-focused custom enchantment that turns water into ice when you break ice-family blocks (Ice, Blue Ice, Frosted Ice, Packed Ice). It caps at level 2 and does not roll on procedurally generated loot.


Earthquake

Earthquake is the boots-based knockback attack. It triggers on a double sneak while not flying, and the strength scales with the summed Earthquake level across your gear.

  • Cooldown: 2 minutes, hardcoded.
  • earthquake.yml adds earthquakeActivationMessage (default &8[EliteMobs] &aEarthquake triggered! &c2 min cooldown!) and earthquakeAvailableMessage (default &8[EliteMobs] &2Earthquake cooldown over!).
  • Caps at level 5, value 50, and does not roll on procedurally generated loot.

Grappling Hook

Grappling Hook is the bow-focused mobility enchantment. It is a single-level enchantment (maxLevelV2: 1, maxEnchantmentLevel: 1, value 10) and does not roll on procedurally generated loot, so it only appears on custom items and enchanted books.


Lightning

Lightning adds a chance-based lightning strike to enchanted combat gear. lightning.yml adds one extra key, minimumCooldownSeconds (default 120), which is the minimum time between strikes. It caps at level 5, has a value of 15, and does roll on procedurally generated loot.


Loud Strikes

Loud Strikes is the threat-control enchantment used for tank-style play, and it is live: EliteMobs targets the nearby player with the highest accumulated threat, and Loud Strikes is what multiplies your threat gain.

  • Each item contributes level / 3 to your total bonus, summed across all 6 equipment slots.
  • Threat generated per hit is damage x (1 + total bonus).
  • maxLevelV2 is 3 but maxEnchantmentLevel is 10, so enchanting can push a single item past the display cap.
  • It does not roll on procedurally generated loot, so it only appears on custom items -- which is why it is the signature enchantment of instanced-dungeon tank gear.

For the full targeting rules and range, see Advanced Aggro System.


Meteor Shower

Meteor Shower calls down fireballs from the sky. It is a single-level enchantment and carries by far the highest item-worth value in the plugin (130), reflecting how strong it is. It does not roll on procedurally generated loot.


Plasma Boots

Plasma Boots creates a damaging particle jump effect. The number of projectile rings on landing scales with the summed Plasma Boots level, each hit deals 2 damage, and the effect runs for 3 seconds. Like Earthquake, it uses a hardcoded 2 minute cooldown. It caps at level 3, has a value of 20, and does not roll on procedurally generated loot.


Repair

Repair is the marker enchantment carried by scrap items. Its level is the scrap tier (1 = Tiny through 5 = Huge), and the Repairman restores 100 durability per tier -- so Tiny repairs 100 and Huge repairs 500. It caps at level 5, has a value of 15, and does not roll on procedurally generated loot.

See Item Upgrade System for the full scrap and repair flow.


Summon Merchant

Summon Merchant is the enchantment/scroll effect that summons Jeeves the merchant. It exists in the current codebase as a dedicated custom enchantment and as premade custom item content.

Use it when documenting utility scrolls or portable service items.

summon_merchant.yml exposes two options:

  • message — the chat line the player says when summoning the merchant. Default "Jeeves!".
  • playersSayMessage — when true (default), the player's chat message is sent as if they typed it, so chat plugins and other listeners see it. Set to false if you only want the merchant to spawn without the player vocalising the call.

Summon Wolf

Summon Wolf summons a friendly wolf. It is a single-level enchantment with a value of 20 and does not roll on procedurally generated loot.


Unbind

Unbind is the enchantment used by unbind scrolls and related item-upgrade workflows. In the current codebase, the broader unbind flow is also exposed through /em unbind and the Adventurer's Guild unbinder service.

For the player-facing system, see Item Upgrade System.


Soulbind

Soulbind is the ownership-locking enchantment used by EliteMobs items. The current codebase still includes dedicated Soulbind config, event registration, and utility checks for reading and removing soulbind from item metadata.

For the player-facing removal flow, see Item Upgrade System.


Lucky Source

Lucky Source is an internal enchantment used to mark items as elite lucky tickets. It is used by the item upgrade system to identify lucky ticket items.

This enchantment is not intended to be applied manually to custom items. It is managed automatically by the plugin.


Enchanted Source

Enchanted Source is an internal enchantment used to mark items as elite enchantment books. The upgrade system uses this marker to identify enchanted books that can be applied to elite items.

This enchantment is not intended to be applied manually to custom items. It is managed automatically by the plugin.