EnchantsPlus config.yml file

# ====================================================
# This is the main config to the plugin.
# Edit this to Your heart's content ,but if You mess something up ,its unpredictable what will happen!
# Its wise to keep config file backups after doing major editings
# ~~~~
# NOTE: I recommend to setup the configuration before first time launching this plug, as some options
# might change the whole gameplay and might take a long time to take effect after custom enchants already
# exist in the world.
# --
# NOTE #2: BE CAREFUL with some options! they might ruin the gameplay for people.
# ~~~~
# ====================================================

Misc:
  messages-prefix: "&b&lEnchants&9&l+&3&l > &b"

Enchants:

# This will enable/disable enchants in enchanting table.
# NOTE: those enchants can still be got from command /en enchant!
  enabled-enchants:
    Auto-Speed: true
    Nightvision: true
    Venom: true
    Auto-Smelting: true
    Regain: true
    Rejuvination: true
    Waterbreathing: true
    Reinforced: true
    Slowness: true
    Regeneration: true
    Flight: true
    Auto-Jump: true
    Blindness: true
    Withering: true
    Quake: true
    Excavation: true
    LifeLeech: true
    'Poison Arrows': true
    'Withered Arrows': true
    'Flashing Arrows': true
    Soulbound: true
    'Ice Aspect': true
    Lucky: true
    Beheading: true
    Life: true
    Electrocute: true
    'Exploding Arrows': true
    Multishoot: false
    'Well Fed': true
    Plasma: true
    Agility: true
    Insulation: true
    Harvesting: true
    Bash: true

# These are the chances that each of these enchants will appear. The higher the number ,the higher the chance.
  enchant-chances:
    Auto-Speed: 30
    Nightvision: 40
    Venom: 50
    Auto-Smelting: 20
    Regain: 60
    Rejuvination: 25
    Waterbreathing: 40
    Reinforced: 30
    Slowness: 45
    Regeneration: 30
    Flight: 10
    Auto-Jump: 30
    Blindness: 30
    Withering: 20
    Quake: 20
    Excavation: 25
    LifeLeech: 15
    'Flashing Arrows': 35
    'Withered Arrows': 25
    'Exploding Arrows': 15
    'Poison Arrows': 40
    Soulbound: 15
    'Ice Aspect': 15
    Lucky: 20
    Beheading: 25
    Life: 8
    Electrocute: 20
    Multishoot: 10
    'Well Fed': 20
    Plasma: 15
    Agility: 13
    Insulation: 21
    Harvesting: 25
    Bash: 20

# Entity damage enchants - are they for pvp or pve? [PVP,PVE,BOTH]
  fight-enchant-use:
    Venom: 'BOTH'
    Blindness: 'BOTH'
    Slowness: 'BOTH'
    Withering: 'BOTH'
    Quake: 'BOTH'
    Bash: 'BOTH'
    LifeLeech: 'BOTH'
    'Flashing Arrows': 'BOTH'
    'Withered Arrows': 'BOTH'
    'Poison Arrows': 'BOTH'
    'Exploding Arrows': 'BOTH'
    'Ice Aspect': 'BOTH'
    Beheading: 'BOTH'
    Lucky: 'BOTH'
    Electrocute: 'BOTH'
    Plasma: 'BOTH'

  Excavation:
# If this is false ,it will take away the same amount of durability as it broke blocks
    excavation-uses-random-durability: true

# For every block broken by excavation enchant, what is the % chance that it will use 1 durability?
    excavation-durability-rate: 50

# Sets the excavation max level to either 1 or 2 (level 1 digs 3x3, level 2 digs 3x3x2)
    excavation-has-2-levels: true

# Blocks excavating obsidian blocks.
    no-obsidian: true

  Beheading:
# What are the chances for each level of beheading for a mob to drop its head?
    level-1-chance: 2
    level-2-chance: 4
    level-3-chance: 7

# Should the beheading enchant drop (basically) every animal/monster's head that is available from Marc_IRL's (MHF) accounts?
    enable-MHF-heads: false

  Life:
    max-level: 1
# if You set health per level to 1, player will get 0.5 extra hearts. 2 means they will get 1 heart per level ,and so on.
    health-per-level: 1
# if You set this to true ,player wearing 3 armor pieces with Life I enchant will have 1.5 extra hearts (if health-per-level is 1).
# Setting this to false means that no matter how much armor pieces with Life I player has equipped, they will always have only 0.5 extra hearts.
    enchant-stacks-up: true

  Quake:
    quake-launches-players: false
    quake-falldamage-affects-players: false
    quake-falldamage: 10
    quake-durability-cost: 20
    quake-launches-other-entities: true

    quake-has-cooldown: true
    quake-cooldown: 20

# Settings this to true means that if a player right clicks on a chest with a Quake equipped item, it'll open the chest instead of doing the quake.
    quake-world-interaction-priority: false

# Size in blocks to each side of quake's effectivity.
    quake-level-1-explosion-size: 5
    quake-level-2-explosion-size: 8
    quake-level-3-explosion-size: 11

# Base velocity a player will get for quake. In english - how fast and far will player fly away when affected with quake. Feel free to play around with the numbers, but don't go too big!
    quake-level-1-velocity: 1.25
    quake-level-2-velocity: 1.5
    quake-level-3-velocity: 1.65

  Bash:
    cooldown: 12.0
    base-damage: 4.0
    shield-durability-usage: 3

# Base velocity of the enchant - how strongly will entities get pushed away from the user
    base-velocity: 0.75

# How many seconds randomly can a player get additionally to their base cooldown for the enchant use
    cooldown-random-factor: 3

# By how many seconds is the cooldown reduced if the enchant level is 2
    level-2-cooldown-reduction: 3

# By how much will the velocity get increased if the enchant is level 2
    level-2-velocity-increase: 0.2

# How much will the damage be increased if the enchant is level 2
    level-2-damage-increase: 2

  Regeneration:

# This is the chance that a player will heal every 1 second.
# If a player has ,let's say, a chestplate and boots with Regeneration II and a helmet with Regeneration III,
# the overall chance would be regeneration-heal-rate * sum of the enchant levels (4.0 * 7 = 28% by default)
# If a player has a full set of Regen III armor, the default chance is 48%.
    regeneration-heal-rate: 4.0

# This is the amount of extra HP You heal with Regeneration enchant.
# This being 1 means it will heal half-a-heart. 2 means one full heart, and so on.
    regeneration-heal-amount: 1

  Electrocute:

# This is the base time of the nausea potion effect for electrocute enchant in seconds.
# It can cause nausea for electrocute-base-time + electrocute-time-increment * (electrocute enchant level - 1) seconds.
    base-time: 7
    time-increment: 1

# NOTE: 1.00 here equals half a heart!
# Here You can define the damage for each piece of armor worn by the living entity. (1.00 = half a heart of damage)
    iron-damage: 0.25
    gold-damage: 0.3
    chain-damage: 0.1

  Plasma:

# NOTE 1: 1.00 here equals half a heart!
# Here You can define the damage for each piece of armor worn by the living entity. (1.00 = half a heart of damage)
    leather-damage: 0.2
    diamond-damage: 0.45

# By how much the damage addition will be multiplied if enchant is level 2?
    level-2-multiplier: 1.15

  Exploding-Arrows:
# This option defines the base strength of the explosion.
# This number calculates how strong the hit will be to a player and how much blocks will it break (if that one's enabled.)
    explosion-strength: 1.0
    explodes-blocks: false

# This defines a chance to explode everytime an arrow is fired.
# This is used in this formula - if a random number between 1 and (chance-to-explode - 4 * [enchant level]) equals to 1, arrow will explode.
    chance-to-explode: 16

# If this is true, not only the chance for an explosion to occur will rise, it will rise its strength too.
    explosion-strength-rises-with-level: true
# If [explosion-strength-rises-with-level] is true, how much does it rise each level?
    strength-rise-multiplier: 1.2

  Multishoot:
# What is the maximum level for that enchant? (Requires /reload or server restart after editing this option)
    multishoot-max-level: 2
# How accurate are the additional arrows? Higher the number, bigger the accuracy.
    multishoot-accuracy: 7.0
# Check if the amount of arrows fired is random from 1 to 1 + multishoot level
    multishoot-random: true

  Well-fed-and-Hunger:
# Well fed works by randomly giving half a food bar.
# Hunger is the opposite - sometimes reduces half a food bar randomly

# What is the rate for each level on the whole player equipment's set (x*well-fed-rate/100, where x is combined enchant level from the whole armor set)
    well-fed-rate: 3.0

# Same as above: What is the rate for each level on the whole player equipment's set (x*hunger-rate/100, where x is combined enchant level from the whole armor set)
    hunger-rate: 4.0

  Beastmaster:
    # Beastmaster increases a tamed wolf's damage and decreases the damage it receives

    # This is how much damage will be increased with the 'Beastmaster I' enchant. (By default, a quarter of a heart - 0.5)
    base-damage-increase: 0.5
    # This multiplies the base-damage-increase with this amount times the enchant level
    # For example if base-damage-increase is 0.5, and this is set to 3, a level II enchant will deal 1.5 damage, level III 3.0 damage and so on.
    base-damage-increase-multiplier: 2.0

    # Same logics as base-damage-increase, but for damage reduction for the wolf
    base-damage-decrease: 0.5

    base-damage-decrease-multiplier: 2.0

    # Maximum for this is 10!
    max-enchant-level: 2

#
#                         ================ Misc configs below here ================
#

# If You set this to true, anvils will be disabled for items that have any custom enchants present on them.
  disable-anvils: false

# Setting this to true disables using anvils to combine levels of custom enchants.
  disable-level-combining: false

# Set this to false if You want to disable the particle effects server-wide.
  particles-enabled: true

# Set this to false if You want to disable the sounds from the plugin.
# This will auto-set to false inside the plugin if the server version is 1.8.
  sounds-enabled: true

# This basically disables all notification messages like 'You've poisoned the enemy!' no matter if player has /en tn enabled or not.
  disable-notifications-globally: false

# If sounds are enabled, what should be their main volume? (Edit this value and keep testing until You're satisfied with it)
  sound-volume: 0.7

# Set this to false to disable custom enchants working in off-hand (excludes bow - check below for that option)
  off-hand-support: true

# Set this to false to disable custom enchants working in off-hand whilst using a bow
  off-hand-bow-support: true

# This setting defines how many times SLOWER the enchant calculations will be done. Change this if You have terrible performance issues with the plugin.
# This number must be natural - minimum 1, 2, 3 and so on.
# Whatever number You will set here, all potion effect enchants, effects like rejuvination will optimize themselves automatically - rejuvination will give the same amount of durability as the misc-timer-interval number, potion effects will be longer, etc
# Max value is set to be 5, but it's not recommended to give it values above 3.
# WARNING: /en reload won't help for this function! Must at least /reload or restart the server.
  misc-timer-interval: 1

# This is the minimum XP level required to get a custom enchant whilst enchanting.
# The lower the level when enchanting an item, the less chances that a player will get it (max chances at level 30)
# Default is 20 (it's best to keep it at that, except if You wish to make it higher)
  required-level: 20

# This is the general chance of getting a custom enchant.
# Default is 45 (45% rate at level 30 enchanting)
# For the curious ones: item will get a custom enchant when a random number with a cap of [130 - level used for enchanting] < or = enchanting-rate
  enchanting-rate: 45

# This is the ratio/chance of more custom enchants appearing when enchanting the item.
# The higher the number is, the more chances You get and more enchants will appear on the item.
  another-enchant-rate: 25

# This being false means that armor enchants like nightvision, autospeed ,etc, will NOT work while a player is holding it in hand.
  armor-enchants-work-in-hand: false

# This is the maximum number of custom enchants appearing on one item from an enchanting table.
# If any of the two numbers below is less or equal 0, You won't get custom enchants for either items or books.
  max-custom-enchants: 4
  max-custom-enchants-on-book: 2

# This value, unlike the one above this option, defines an ABSOLUTE amount of max enchants.
# This defines the maximum allowed enchants on an item overally, You won't be able to add more in anvils and such.
  absolute-max-enchants: 5
  ignores-enchant-command: true
  vanilla-enchants-included: false

# To make the plugin seem not so OP, You can enable bad enchants here. (eg. instability, heavy, hunger)
# The bad enchant ratio is a x/100 chance that a bad enchant will appear with each enchanting.
# NOTE: A bad enchant won't appear to items without at least one 'good' custom enchant.
  enabled-bad-enchants: false
  bad-enchant-ratio: 40

# If set to true, when enchanting an item, it will have a tooltip briefly defining what the enchant does.
# You can edit them in the config file enchant-tooltips.yml
  helpful-tooltips-enabled: true

# This is the RARITY of some enchant effects - smaller the number, higher the chance an enchant effect will be applied.
# Having 10 on venom III enchant (poison-rarity) will make every ~4th hit poison somebody
  poison-rarity: 20
  blindness-rarity: 30
  withering-rarity: 30
  slowness-rarity: 20
  lifeleech-rarity: 30
  arrow-poison-rarity: 18
  arrow-withered-rarity: 28
  arrow-flashing-rarity: 28
  ice-aspect-freeze-rarity: 20
  electrocute-rarity: 20

# How many seconds will the poison from poison arrows stay around on a player.
  arrow-poison-time: 2.75

# How many LESS seconds with each level will the potion effect from poison arrows stay around?
# If this is set to 0.5 (by default), the resulting potion effect time will be arrow-poison-time - 0.5 (by default, level I enchant will give a poison potion effect with 2.25 seconds,
# level II - 1.75 seconds, level III - only 1.25 seconds).
# This function is here because by default with each higher enchant level, the potion effect will be accordingly stronger (you can edit that just below this function).
# If you want the potion effect time to always stay like 'arrow-poison-time' is defined, set this to 0.
  arrow-poison-level-time-decrease: 0.5

# Basically, what enchant level will give what poison potion effect level.
# arrow-poison-level-<enchant level>: <the poison potion effect level>
  arrow-poison-level-1: 1
  arrow-poison-level-2: 2
  arrow-poison-level-3: 3

# Duration is in seconds ,how much You will be frozen in place.
# Multiplier is how much times longer is the duration when enchant's level 2
  ice-aspect-freeze-duration: 2
  ice-aspect-freeze-level-multiplier: 2

# lucky-amount is the max amount of extra XP a player can get from killed entity with Lucky enchant.
# Multiplier is how much times more XP a player can get with level II Lucky enchant
  lucky-amount: 10
  lucky-level-multiplier: 1.5

# This number defines the maximum level for Agility a player can get.
# Setting this to a number below 1 or above 10 will have no effect, it will internally set itself to its default value - 3.
  agility-max-level: 3

# Each amount is a half-a-heart
  lifeleech-heal-amount: 1

# NOTE 1: 1.00 here equals half a heart!
# NOTE 2: Insulation stacks up - for every armor with insulation, the damage multiplier from electrocute/plasma will be multiplied by the amounts defined below.
# By how much will the electrocute/plasma DAMAGE ADDITION will be multiplied if the player has insulation?
# Example, a player with Plasma II attacks a full diamond player. normally, they should do about an extra heart of damage, but if the victim has a full Insulation III set, it will change that value to a bit more than half a heart.
# Where x is, change that to diamond/leather.
  insulation-multiplier-electrocute: 0.65
  insulation-multiplier-plasma: 0.7

# By how much will the multiplication number (they're defined just above this option for electrocute/plasma) decrease with each level of insulation?
  insulation-level-2-decrement: 0.07
  insulation-level-3-decrement: 0.13

# If this is set to false, fortune + autosmelting won't give more ingots from smelted ores.
  autosmelt-plus-fortune-enabled: true

# Change if Soulbound enchant dissapears off of an item when a player dies and regains the item from death.
  soulbound-enchant-dissapears-after-death: true

# Setting this to true will allow PvP enchants to apply to axes too
  pvp-enchants-on-axes: false

# Rate at which durability decays when equipped item with flight enchant. 100 = every 0.5 seconds -1 durability on an item
  flight-durability-decay: 30

# ---------------

# If this is true, whenever any type of PvP is started, a player will lose their ability to fly.
  disable-flight-when-pvp-starts: false

# The following option will work only if the above one is set to 'true':
# What is the PvP cooldown?
  no-flight-pvp-cooldown: 15

# ---------------

# If this is true, whenever any type of PvE is started, a player will lose their ability to fly.
  disable-flight-when-pve-starts: false

# The following option will work only if the above one is set to 'true':
# What is the PvE cooldown?
  no-flight-pve-cooldown: 10

# ---------------

# Does a player recieve falldamage when they lose their flight when initiating PvP/PvE?
  falldamage-flight: false


# This option changes the maximum rejuvination level.
# See 'rejuvination-durability-rate' for more information.
  rejuvination-max-level: 3

# This number edits the rate of the durability regen rate with this formula:
# After every 0.5 seconds, there is a chance of (rejuvination level/rejuvination-durability-rate) to heal 1 durability.
# So if you have rejuv level 3 and this is set to 6, the chance to regen would be about 3/6=50% every 0.5 seconds
  rejuvination-durability-rate: 10

# Same logics as above, but for Unstable enchant.
  instability-durability-rate: 9

# This edits the Harvesting enchant's max level. Take note, that this value can only be 1, 2 or 3.
# Any other values won't work and will set it back to default internally, which is 3.
  harvesting-max-level: 3

# Setting this to false will make it so that people cant damage other people with poison, withering ,etc., only other living entities.
  can-enchants-affect-people: true

  heavy-causes-mining-fatigue: true

# This enables old enchant name support.
# Basically, if You at some point changed Your enchant name and dont want players to lose those enchants,
# in enchant-names.yml, the 'old-enchant-names' section, add the old enchant names there and the enchant will still work.
# if this is set to false, the plugin won't look into that section.
# Enabling this causes more lag!
  old-name-support: false

# by default, bow enchants will be enabled. Set this to false to disable them.
  bow-enchants-work: true

# Same as above, but for crossbows.
  crossbow-enchants-work: true

# Usually you would never want to set this to true, except if you want to block or otherwise edit how the Grindstones work via other plugins.
# Added by request
  disable-grindstone-removing-custom-enchants: false

# ---END OF CONFIGS---