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
| Key | Meaning |
|---|---|
isEnabled | Whether the enchantment exists at all |
name | Display name used in item lore |
maxLevelV2 | The level cap used when rolling and displaying the enchantment |
value | How much one level contributes to an item worth calculation (used by shops and selling) |
isEnabledForProcedurallyGeneratedItems | Whether procedurally generated loot can roll this enchantment |
maxEnchantmentLevel | Hard ceiling the plugin will never exceed, even through enchanting |
Some files add extra keys, listed in the sections below.
Enchantment Summary
| Enchantment | Description | Item Type |
|---|---|---|
| Critical Strikes | Chance for a 1.5x damage critical hit on Elite Mobs | Weapons |
| Drilling | Mine blocks in a radius | Pickaxes, Shovels |
| Elite Protection/Sharpness/etc. | Extends vanilla enchantments beyond normal limits | All applicable |
| Flamethrower | Fire a jet of flames | Any |
| Hunter | Increases Elite Mob spawn rate | Any |
| Ice Breaker | Freezes water on hit | Pickaxes |
| Earthquake | Knockback jump attack | Boots |
| Grappling Hook | Grapple to target blocks | Bows |
| Lightning | Chance to strike lightning | Weapons |
| Loud Strikes | Increases aggro for tanking | Weapons |
| Meteor Shower | Spawns fireballs from the sky | Any |
| Plasma Boots | Damage dealing particle jump | Boots |
| Repair | Convert items to scrap materials | Any |
| Summon Merchant | Summons Jeeves the merchant | Paper |
| Summon Wolf | Summons a friendly wolf | Any |
| Unbind | Removes soulbind from items | Scrolls |
| Soulbind | Binds items to players | Any |
| Lucky Source | Marks an item as a lucky ticket | Internal |
| Enchanted Source | Marks an item as an elite enchantment book | Internal |
Shipped values for the EliteMobs-only enchantments
| File | maxLevelV2 | maxEnchantmentLevel | value | Rolls on procedural loot |
|---|---|---|---|---|
critical_strikes.yml | 2 | 3 | 13 | yes |
drilling.yml | 4 | 4 | 15 | no |
earthquake.yml | 5 | 5 | 50 | no |
flamethrower.yml | 1 | 1 | 20 | no |
grappling_hook.yml | 1 | 1 | 10 | no |
hunter.yml | 3 | 3 | 10 | yes |
ice_breaker.yml | 2 | 2 | 10 | no |
lightning.yml | 5 | 5 | 15 | yes |
loud_strikes.yml | 3 | 10 | 6 | no |
meteor_shower.yml | 1 | 1 | 130 | no |
plasma_boots.yml | 3 | 3 | 20 | no |
repair.yml | 5 | 5 | 15 | no |
soulbind.yml | 1 | 1 | 10 | yes |
summon_merchant.yml | 1 | 1 | 10 | no |
summon_wolf.yml | 1 | 1 | 20 | no |
unbind.yml | 1 | 1 | 10000 | no |
lucky_source.yml | 1 | 1 | 20 | no |
enchanted_source.yml | 1 | 1 | 10 | yes |
mending.yml ships with isEnabled: false -- Mending is off by default on EliteMobs items.
Critical Strikes
| Key | Details |
|---|---|
| Effect | Chance to land a critical hit dealing 1.5x damage to Elite Mobs |
| Chance per Level | 10% (Level 1 = 10%, Level 2 = 20%, etc.) |
Procedural Cap (maxLevelV2) | Level 2 |
| Absolute Max Level | Level 3 |
| Total chance cap across all gear | 40% (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%.
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:
| Key | Default | Purpose |
|---|---|---|
criticalHitPopup | &5Critical Hit! | Text of the extra popup shown on a critical strike |
criticalHitColor | &5 | Colour prefix applied to the critical damage number |
Drilling
| Key | Details |
|---|---|
| Effect | Mine blocks in a radius |
| Level Range | 1-4 (maxLevelV2 and maxEnchantmentLevel are both 4) |
| Blocks per Level | Level 1 = 1 extra block straight ahead, Level 2 = a 4-block cross, Level 3+ = stacked 3x3 layers going deeper |
| Valid Items | Pickaxes, Shovels |
| Procedural loot | No -- 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
| Key | Details |
|---|---|
| Effect | Extends vanilla enchantments beyond normal limits |
| Activation | Only against EliteMobs |
| Requirement | Item 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
| Category | Enchantments |
|---|---|
| Armor | Protection, Fire Protection, Blast Protection, Projectile Protection, Feather Falling, Thorns, Respiration, Depth Strider, Frost Walker, Soul Speed, Swift Sneak |
| Weapon | Sharpness, Smite, Bane of Arthropods, Knockback, Fire Aspect, Looting, Sweeping Edge |
| Bow | Power, Punch, Flame, Infinity |
| Tool | Efficiency, Fortune, Silk Touch |
| Fishing | Luck of the Sea, Lure |
| Trident | Impaling, Loyalty, Riptide, Channeling |
| Crossbow | Quick Charge, Piercing, Multishot |
| Mace | Density, Breach, Wind Burst |
| Spear | Lunge |
| Other | Mending, 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.ymladdsearthquakeActivationMessage(default&8[EliteMobs] &aEarthquake triggered! &c2 min cooldown!) andearthquakeAvailableMessage(default&8[EliteMobs] &2Earthquake cooldown over!).- Caps at level 5,
value50, 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 / 3to your total bonus, summed across all 6 equipment slots. - Threat generated per hit is
damage x (1 + total bonus). maxLevelV2is 3 butmaxEnchantmentLevelis 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— whentrue(default), the player's chat message is sent as if they typed it, so chat plugins and other listeners see it. Set tofalseif 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.