metrics: true
clean_old_enchantments: false # Some older enchantments used to apply an attribute on an item, but this caused some issues
# with other plugins. Mainly plugins that interacted with or gave items custom attributes of their own.
# If you have no such plugins, a cleanup is recommended and you should set this to "true". If you do have such plugins
# it is likely you can attempt this cleanup, but you should know what happens then:
# Setting this to true will remove the Max Health attribute from items enchanted with Vigorous, Knockback Resistance from
# item with Steady, and Armor from items with Plating. If you have item that may have these attributes, but are also capable
# of having these custom enchantments, your own custom attributes may be removed.
# Level minimum in the enchantment table before custom enchants start appearing
level_minimum: 30
# If true, custom enchanted items will also receive a cosmetic glint enchantment. This causes items to glow as if they are
# enchanted. With this enchantment, though, they cannot be put in the enchantment table any more since they are technically
# now enchanted.
enable_cosmetic_glint: true
# If true, levels will be displayed as roman numerals, otherwise regular numbers will be used
level_as_roman: true
# If true, instead of consuming 1-3 levels on enchanting, an equal amount of levels as the enchantment strength will be consumed
# (level 30 enchants will consume 30 levels)
consume_all_levels: false
# The amount of times the enchantment table will attempt to roll for custom enchantments
# This means that the higher this number, the generally more enchantments will appear on an item
# This also makes this amount the max amount of custom enchants that can appear on an item at once in an enchantment table
enchantment_table_rolls: 3
# The additional levels it'll cost to combine items with custom enchants in an anvil
enchantment_extra_cost: 2
# Disable certain core features of the plugin in case they severely clash with other plugins, or you just don't want to use them.
disable_anvil: false # Disables custom enchantments from being able to be combined in an anvil
disable_enchanting: false # Disables custom enchantments from appearing in the enchantment table
disable_trading: false # Disables villagers from trading custom enchantments
disable_fishing: false # Disables enchanted books obtained by fishing from receiving custom enchants
disable_dungeonlootgen: false # Disables enchanted books obtained from dungeon generated chests from receiving custom enchants
# The maximum amount of enchantments you're allowed to put on a tool
max_enchants: 5
# The chance for custom enchantments to appear on an item while enchanting, in %
custom_enchant_rate: 50
# The chance for an enchanted book in a librarian trade to instead be of a random custom enchantment, in %
# The enchantments appearing will appear at the same rate they would when enchanting a normal enchanted book, except
# there will always be just 1 enchantment.
custom_enchant_trade_rate_book: 33
# The same as for librarians, but for armorers, toolsmiths, or weaponsmiths. Since these villagers sell items that
# can contain several enchantments here you can configure the chance and how many custom enchants they may get.
custom_enchant_trade_rate_other: 33 # Chance for a trade to contain custom enchants in %
custom_enchant_trade_rolls_other: 2 # Max amount of times it will roll for enchants, will be at least 1.
# You get the deal, when you fish up an enchanted book it may have enchants. Here you can decide if they should also have
# custom enchants.
custom_enchant_fish_rate: 33 # Chance for a fished up enchanted book to contain custom enchants
custom_enchant_fish_rolls: 2 # Max amount of times it will roll for enchants, will be at least 1
# Same deal but with dungeon generated enchanted books
custom_enchant_dungeon_rate: 33 # Chance for a dungeon-generated enchanted book to also contain custom enchants
custom_enchant_dungeon_rolls: 3 # Max amount of times it will roll for enchants, will be at least 1
# If true, players require permissions for each individual enchant to be able to obtain them while enchanting.
# The permission for each of these will be es.enchant.(enchantment name)
# The enchantment name will be the name as written down in the config. Example: Curse of burdening will be es.enchant.curse_burden
permission_required: false
# Include rarity(weight) in /es list enchant descriptions
eslist_include_weight: true
# Include max level in /es list enchant descriptions
eslist_include_max_level: true
# Include compatible items in /es list enchant descriptions
eslist_include_compatible_items: true
# To save on performance, a player's equipment and enchantments are cached every x amount of time.
# The shorter this time, the potentially more performance heavy the plugin becomes. The longer the time,
# the less accurate equipment detection becomes. This means that with a time of, say, 10 seconds,
# a player could potentially take off an armor piece with an enchantment and the plugin would still consider them
# having said enchantment equipped for up to 10 seconds (depending on current cycle).
# This cache pretty much exclusively applies to enchantments that trigger very frequently, which mainly excludes
# held item enchantments.
cache_refresh_time: 1950 # Time is in milliseconds, default little under 2 seconds
# The cache also saves non-player entities, so if they die or despawn with equipment on the cache may get cluttered.
# Every x amount of time, the cache will be cleaned up to get rid of all invalid entities in it
cache_cleanup_delay: 600000 # Time is in milliseconds, default 10 minutes
allow_grindstone_removal: true # If false, grindstones no longer remove custom enchantments
# You may add the following properties to enchantments in case you want them to conflict with other enchantments
# incompatible_vanilla_enchantments
# incompatible_custom_enchantments
# Some enchantments already have this property, look at sunforged or crushing for examples
enchantment_configuration:
excavation:
description: '&8> Mines a &e2x1&8 - &e+ shaped&8 - &e3x3 area&8 instead of 1x1x1. Sneak while mining to stop this effect.'
enchant_name: '&7Excavation %lv_roman%' # The lore applied on items, which is also used for determining item enchants
max_level: 1 # Maximum level for this enchantment, players will be able to reach this level through the anvil
max_level_table: 1 # Maximum level attainable through the enchantment table
enabled: true # If disabled, enchant will not be registered at all.
weight: 20 # The rarity of the item in weight, lower values mean less common
book_only: false # If true, enchant will only appear on books
sneak_disable: true # If true, players will be able to sneak to disable the excavation effect
nerf_excavation_speed: false # If true, players will be given mining fatigue when mining with excavation.
# This is to prevent the player from instant-mining stone with Haste II and Efficiency V
fatigue_amplifier: 0 # The strength of mining fatigue applied to the player if nerf_excavation_speed is true
fatigue_duration: 20 # The duration of mining fatigue applied to the player if nerf_excavation_speed is true
area_leveling: true # If true, the area excavation clears out will scale according to level. Otherwise, excavation mines a 3x3 area
# Level I will mine 2 blocks 1 additional block below the mined block
# Level II will mine 5 blocks in a + shaped area
# Level III will mine 9 blocks in a 3x3 area
# Any level higher than this will add a row around the 3x3 area (5x5, 7x7, 9x9, etc.)
durability_leveling: true # If true, the chance to consume durability will scale according to levels as defined below.
# Otherwise, only durability_decay will be considered.
# IF YOU ARE CHANGING THIS TO TRUE, ADJUST THE VALUE OF durability_decay TO 1.0
durability_decay: 0.33 # Chance to consume 1 durability per block broken.
durability_decay_lv: 0 # Additional chance per level to consume 1 durability per block broken IF durability_leveling is enabled
# Note: Excavation is severely unbalanced with a durability_decay value of less than 1.
# This is because lower values make the tool last significantly longer relatively speaking, being able to break
# a lot more blocks a lot faster than it normally would. However, from my experience, players tend to complain their
# tools break too fast if this value is set at 1, hence why it's set at 0.33 by default. If you have an economy on your
# server it is recommended to keep excavation in mind when balancing it, because players WILL get a LOT of resources.
trade_enabled: true # If true, custom enchantments will appear in villager trades
trade_cost_base_lower: 32 # Lowest emerald cost value for a level 1 enchantment, cost is random between lower and upper value
trade_cost_base_upper: 64 # Highest emerald cost value for a level 1 enchantment
trade_cost_lv_lower: 8
trade_cost_lv_upper: 16
# Example: If an enchant is configured as so:
# trade_cost_base_lower: 8
# trade_cost_base_upper: 16
# trade_cost_lv_lower: 4
# trade_cost_lv_upper: 8
# A level 1 enchant of this type would cost between 8-16 emeralds, a level 2 would cost 12-24, level 3 16-32, etc.
icon: TNT
is_treasure: false # If true, treasure enchantments cannot appear naturally during enchanting and only in loot, trades, and fishing.
compatible_with:
- AXES
- PICKAXES
- SHOVELS
- HOES
incompatible_custom_enchantments:
- tree_feller
telekinesis:
description: '&8> Any drops from mined blocks are transferred directly to your inventory'
enchant_name: '&7Telekinesis'
prevent_item_ownership: false # If false, dropped items will only be able to be picked up by the person who mined the block. If true, they can be picked up by everyone
enabled: true
weight: 20
book_only: false
trade_enabled: true
trade_cost_base_lower: 32
trade_cost_base_upper: 64
icon: ENDER_PEARL
is_treasure: false
compatible_with:
- AXES
- PICKAXES
- SHOVELS
- HOES
tree_feller:
description: '&8> Mining a tree, while sneaking, destroys the whole tree instantly'
enchant_name: '&7Deforestation'
enabled: true
weight: 20
damage_multiplier: 0.5 # Durability damage multiplier while using tree feller
log_limit: 128 # Max amount of logs that can be broken
break_leaves: true
leaf_limit: 128 # Max amount of leaves that can be broken
book_only: false
trade_enabled: true
trade_cost_base_lower: 32
trade_cost_base_upper: 64
icon: ENDER_PEARL
is_treasure: false
incompatible_custom_enchantments:
- excavation
rejuvenation:
description: '&8> Slowly regenerates durability'
enchant_name: '&7Rejuvenation %lv_roman%' # For enchantments that have a max level higher than 0 you can use either
# %lv_roman% for roman numeral levels or %lv_number% for regular number levels, if you prefer lame virgin arabic numbers over epic chad roman numerals
enabled: true
weight: 80
book_only: false
max_level: 3
max_level_table: 3
durability_regeneration_base: 0.1 # Average durability regenerated per second at lv 1
durability_regeneration_lv: 0.1 # Additional average durability regenerated per second per level above 1
trade_enabled: true
trade_cost_base_lower: 12
trade_cost_base_upper: 24
trade_cost_lv_lower: 6 # Additional emerald cost per extra level added to the lower base cost of an enchant
trade_cost_lv_upper: 12 # Additional emerald cost per extra level added to the upper base cost of an enchant
icon: ANVIL
is_treasure: false
compatible_with:
- ALL
incompatible_vanilla_enchantments:
- mending
lava_walker:
description: '&8> Transforms lava under you within a radius of &e0&8-&e1&8-&e2&8 blocks into magma, at the cost of durability.'
enchant_name: '&7Lava Walker %lv_roman%'
enabled: true
weight: 20
book_only: false
max_level: 2
max_level_table: 2
durability_degeneration: 0.1 # Chance per block of lava transformed to reduce 1 durability
duration: 5000 # converted blocks last for this amount of time (in milliseconds), or -1 if infinite
transform_into: 'MAGMA_BLOCK' # The block lava will turn into when walked over
trade_enabled: true
trade_cost_base_lower: 16
trade_cost_base_upper: 32
trade_cost_lv_lower: 8
trade_cost_lv_upper: 16
icon: LAVA_BUCKET
is_treasure: false
compatible_with:
- BOOTS
incompatible_vanilla_enchantments:
- frost_walker
shielding:
description: '&8> Has a &e20&8-&e40%&8 chance to deflect projectiles that would normally hit you'
enchant_name: '&7Shielding %lv_roman%'
enabled: true
weight: 40
book_only: false
max_level: 3
max_level_table: 3
deflect_chance_base: 0.2
deflect_chance_lv: 0.1 # Chance per level to deflect a projectile
trade_enabled: true
trade_cost_base_lower: 16
trade_cost_base_upper: 32
trade_cost_lv_lower: 8
trade_cost_lv_upper: 16
icon: SHIELD
is_treasure: false
compatible_with:
- CHESTPLATES
chemical_shield:
description: '&8> While blocking, splash potions and potion effect clouds don''t affect you. Careful, as this also blocks beneficial effects.'
enchant_name: '&7Neutralizer'
enabled: true
weight: 40
book_only: false
trade_enabled: true
trade_cost_base_lower: 16
trade_cost_base_upper: 32
is_treasure: false
icon: MILK_BUCKET
potion_potency_buff:
description: '&8> Most potions you drink will have their duration reduced by &e20&8-&e40%&8, but have their amplifiers increased by &e50&8-&e100%'
enchant_name: '&7Potency %lv_roman%'
enabled: true
weight: 10
book_only: false
max_level: 2
max_level_table: 2
amplifier_buff_base: 1.5 # The base multiplier of the amplifier of the potion effects applied on the wearer. Amplifiers are rounded downwards
amplifier_buff_lv: 0.5 # Additional multiplier added to the base per level (I = 1.5x, II = 2x, III = 2.5x)
duration_buff_base: 0.8 # The base duration bonus added onto the potion effect duration
duration_buff_lv: -0.2 # Additional duration per level added onto the potion effect duration
duration_minimum: 0.2 # Minimum fraction of the original potion duration. No matter how high the level, it can never go below this.
# Both duration_buff_base and duration_buff_lv can be decimal numbers, if whole numbers are used it will add this
# number onto the duration in game ticks (20 = 1 second). If decimal numbers are used it will multiply the potion
# effect duration with this number and round downwards. Ex: duration_buff_base of 1.5 will increase a buff
# duration from 6 seconds to 9 seconds with an enchant strength of I.
# With a duration_buff_lv of 0.5 this is added on top of 1.5 and will double the duration from 6 seconds to 12
# seconds with an enchant strength of II.
# If duration_buff_base is set to 40, it will add a flat 2 seconds to the potion effect duration.
# Both values have to be either decimals or whole numbers, if you use a mix of both an error will be shown on startup.
exceptions: # The following potion effects cannot be amplified
- RESISTANCE
trade_enabled: true
trade_cost_base_lower: 16
trade_cost_base_upper: 32
trade_cost_lv_lower: 16
trade_cost_lv_upper: 32
icon: GLOWSTONE_DUST
is_treasure: false
compatible_with:
- CHESTPLATES
- ELYTRA
steady:
description: '&8> Reduces knockback taken by &e20&8-&e40%'
enchant_name: '&7Steady %lv_roman%'
enabled: true
weight: 40
book_only: false
max_level: 2
max_level_table: 2
knockback_reduction_lv: 0.2 # Knockback reduced per level
trade_enabled: true
trade_cost_base_lower: 12
trade_cost_base_upper: 24
trade_cost_lv_lower: 6
trade_cost_lv_upper: 12
icon: IRON_BOOTS
is_treasure: false
compatible_with:
- LEGGINGS
illuminated:
description: '&8> Shift-Right click with a pickaxe on an empty surface to place a torch at the cost of &e3 &8durability'
enchant_name: '&7Illuminated'
enabled: true
weight: 40
book_only: false
durability_cost: 9 # Durability consumed when a torch is placed
use_unbreaking: false # If false, the durability cost will always be deducted. If true, the chance to use durability
# is reduced.
cooldown: 100 # Cooldown in ticks
cooldown_message: '&cCooldown: {cooldown}s' # Message sent to player if torch placement is on cooldown
trade_enabled: true
trade_cost_base_lower: 16
trade_cost_base_upper: 32
is_treasure: false
icon: TORCH
auto_replant:
description: '&8> Right click with a hoe on a fully grown crop to instantly harvest and replant it'
enchant_name: '&7Harvesting'
enabled: true
weight: 80
ignore_break_permission: false # If true, the player will not need break permissions to harvest a crop with this enchantment.
# Doing so may not produce accurate drops if you have plugins interacting with crop loot
book_only: false
trade_enabled: true
trade_cost_base_lower: 16
trade_cost_base_upper: 48
is_treasure: false
icon: DIAMOND_HOE
kinship:
description: '&8> If the pickaxe matches the material of the ore you''re mining, some durability is restored. &estone:0.05-0.1-0.15&8, &eiron:1-2-3&8, &ediamond:10-20-30&8, &enetherite:50-100-150'
enchant_name: '&7Kinship %lv_roman%'
enabled: true
weight: 80
book_only: false
max_level: 3
max_level_table: 3
durability_regen_netherite: 50 # Durability regenerated when mining netherite ore with a netherite pickaxe per level
durability_regen_diamond: 10 # Durability regenerated when mining diamond ore with a diamond pickaxe per level
durability_regen_iron: 1 # Durability regenerated when mining iron ore with a iron pickaxe per level
durability_regen_gold: 3 # Durability regenerated when mining (probably nether) gold ore with a gold pickaxe per level
durability_regen_stone: 0.05 # Durability regenerated when mining stone with a stone pickaxe per level
fraction_regen: false # If true, kinship will repair a fraction of the durability instead of a flat amount
trade_enabled: true
trade_cost_base_lower: 8
trade_cost_base_upper: 16
trade_cost_lv_lower: 4
trade_cost_lv_upper: 8
is_treasure: false
icon: DIAMOND_PICKAXE
metabolism:
description: '&8> Slowly regenerates hunger points while moving'
enchant_name: '&7Metabolism %lv_roman%'
enabled: true
weight: 80
book_only: false
max_level: 2
max_level_table: 2
saturation_limit: 5 # Maximum amount of saturation points regenerated if player has 10 full hunger bars
hunger_regeneration_base: 0.04 # chance per second to regenerate 1 hunger
hunger_regeneration_lv: 0.03 # additional chance per second to regenerate 1 hunger per level
trade_enabled: true
trade_cost_base_lower: 16
trade_cost_base_upper: 32
trade_cost_lv_lower: 8
trade_cost_lv_upper: 16
icon: GOLDEN_CARROT
is_treasure: false
compatible_with:
- HELMETS
- CHESTPLATES
- LEGGINGS
- BOOTS
vigorous:
reset_health: false # Vigorous recently went through a signifi
