SpigotVIP EBChance (aka dust for EnchantmentBook) 6.1.0

NOTE: You would need EnchantmentBook plugin. (please make sure to have the latest EnchantmentBook for EBChance)

This plugin provides a utility function for EnchantmentBook. EnchantmentBook Chance Item (EBChance Item) can

• increase
• decrease

the chance of

• success rate
• destroy rate

on a EnchantmentBook.

Types of EBChance Items (dusts):
There are three types of EBChance Items:

• INCREASE
• DECREASE
• MAGIC

If you have a MAGIC item, you can right click it to turn it into either INCREASE or DECREASE items.

You can use "/ebchance give" command to issue one of these three EBChance Items.

How to use EBChance Item (dust):
To use INCREASE and DECREASE item, you just drag and drop it onto the EnchantmentBook item. It will increase or decrease the success/destroy rate accordingly.

To use MAGIC item, you simply right click AIR/Block while you're holding the MAGIC item. The Magic item will turn into either INCREASE or DECREASE item.

As a server owner, you can use "/ebchance give" command as a voting reward, mining reward, mystery crate rewards in order to issue different EBChance items.

Video:


Test server: testserver.vk2gpz.com

Commands:

• /ebchance help : displays the help menu
• /ebchance reload : reloads config file.
• /ebchance give <player> [name:name] [type:+|-|*] [apply:success|destroy] [[rate:rate] | [min:min_rate] [max:max_rate]] : gives an EBChance item. Type '+' will generate "INCREASE" item, '-' will generate "DECREASE" item and '*' will generate "MAGIC item. You can specify the value of chance using either
  • [rate:rate], or
  • [min:min_rate] [max:max_rate]
• if min and max are specified, the value of chance will randomly selected between these two values
• /ebchance convert: converts an EnchantmentBook into an EBChance MAGIC Item.
  
  The chance value of the converted EBChance Item will be calculated as:
  Code (Text):
  success_rate : success rate of the EnchantmentBook,
  destroy_rate : destroy rate of the EnchantmentBook,
  max = max(success_rate, destroy_rate),
  min = min(success_rate, destroy_rate),
  
  chance = (min + rand(max - min)) * Chance.Factor

Permissions:

• ebchance.reload : allows you to use reload command
• ebchance.give : allows you to use /ebchance give command
• ebchance.convert : allows you to use /ebchance convert command
  
• ebchance.use : allows you to use EBChance Item.

Installation:
First, you need to install EnchantmentBook.jar into the plugins folder. Once you've installed EB, you can put EBChance.jar in the plugins folder.

Configuration:
You can have full customisation in how EBChance item is displayed.

Code (Text):

Messages:
ErrorMsg : "&c[EBChance] : Some error occured."
EBCGiven: "&e[EBChance] : You've given EBChance Item %name% to %type% the chance by %value%!"
EBCApplied: "&e[EBChance] : You've applied %name% EBChance item to %type% the chance by %value%.!"
NoPlayerFound: "&c[EBChance] : %player% is not found"
NoPermission: "&c[EBChance] : You don't have a permission to use EBChance!"
NoSuchEBChance: "&c[EBChancek] : The EBChance Item %type% is not found."


HelpMessages:
banner:
msg: "=== &e[&aEBChance Commands List (%version%)&e] &r==="
help:
msg: "&a/ebchance help : displays this help menu."
reload:
msg: "&a/ebchance reload : reloads config file."
permission: "ebchance.reload"
debug:
msg: "&a/ebchance debug <true|false> : turn on / off the debug mode."
permission: "ebchance.debug"
give:
msg: "&a/ebchance give <player> [name:name] [type:+|-|*] [apply:success|destroy] [min:min_rate] [max:max_rate]"
permission: "ebchance.give"

AppliedSound: LEVEL_UP
GivenSound: SUCCESSFUL_HIT

IncreaseMaterial: SUGAR
DecreaseMaterial: SULPHUR
MagicMaterial: FIREBALL

FireWorkEffect:
Color: GREEN
Type: STAR
Power: 0

EBChanceFormat:
Lore: "&aClick an EnchantmentBook with\nthis item to %type%\nthe chance by %value%."
ApplyLore: "&bApplied to: %apply%"
TypeLore: "&bType: %type%"
ChanceLore: "&bChance: %value%"

# when Enchantment Book is converted into MAGIC dust
# resulting chance for the MAGIC dust will be picked randomly between
# resulting rate = Random(rate on the book * ConvertFactor);
# for instance, if EBook has success rate of 80%, the resulting chance for magic dust will be
# Random(0.8 * 0.1) (random number between 1 - 8 %)
ConvertFactor: 0.1


License: Please read this prior to your purchase.