EnchantmentBookTool 4.23.2
let player have randomised unopened EnchantmentBooks!
NOTE: You would need EnchantmentBook plugin.
This plugin provides a utility function for EnchantmentBook. Its "get" command will allow a player to get/purchase an unopened EnchantmentBook using his/her EXPs.
When "get" command is executed, randomly crafted unopened EnchantmentBook will be issued. The player then can click it (right-click) to discover the actual EnchantmentBook. The level of enchantment, Success rate, Destroy rate is randomly computed to generate the EnchantmentBook.
As a server owner, you can predefine a pool of possible books with a predefined range of enchantment levels, success rates and destroy rates.
You can let your player to use
/ebtool get
command or map that command with predefined enchantment book type (such as Common, Rare, Legendary) to a GUI plugin of your choice.
Video:
Commands:
Permissions:
Installation:
First, you need to install EnchantmentBook.jar into the plugins folder. Once you've installed EB, you can put EnchantmentBookTool.jar in the plugins folder.
Configuration:
You can have full customisation in what sort of EnchantmentBooks are randomly generated and what sort of groups you wish to have (such as Common, Rare, Legendary, etc.)
Messages:
ErrorMsg : "&c[EBTool] : Some error occured."
NoSuchBookType : "&c[EBTool] : No such book type (%type%) is available."
NotEnoughExp : "&c[EBTool] : You need at least %exp% to get this type of a\
enchantment book."
UsedExp : "&a[EBTool] : You've used &e%exp% &aexp to get a book of &e%type\
%&a. You now have %left% exp left."
PlayerOffline : "&c[EBTool] : Player (&e%player%&c) is offline."
NoPermission : "&c[EBTool] : You don't have a permission to use this book (&e%type%&c)."
BookGiven: "&a[EBTool] : You've given a book of &e%type%&a."
BookOpened: "&a[EBTool] : You've opened a book of &e%type%&a, and got &e%booktitle%."
HelpMessages:
banner:
msg: "=== &e[&aEnchantmentBookTool Commands List (%version%)&e] &r==="
help:
msg: "&a/ebtool help : displays this help menu."
reload:
msg: "&a/ebtool reload : reloads config file."
permission: "enchantmentbooktool.reload"
debug:
msg: "&a/ebtool debug : turn on / off the debug mode."
permission: "enchantmentbooktool.debug"
get:
msg: "&a/ebtool get : give an EBook randomly configured and \
selected from a list of enchantments list under ."
permission: "enchantmentbooktool.get"
issue:
msg: "&a/ebtool issue [random|book_name]: issue an EBook to without EXP cost."
permission: "enchantmentbooktool.admin"
# whether players need to use exp to get book or not.
UseEXP: true
# UnOpenedBook's name MUST start with %type%
# UnOpenedBook's lore MUST have at least one line without %type%
UnOpenedBook:
title: "%type% Enchantmetn Book &r(Right Click)"
lore:
- "&7Examine to receive a random"
- "%type% &7enchantment book."
FireWorkEffect:
Color:
- GREEN
- RED
Type: STAR
Power: 0
EnchantmentSets:
Common:
Name: "&aCommon"
Exp: 30
Books:
Common_Amor:
Name: "&aCommon Armour"
Targets:
- DiaArmour
Enchantments:
Sharpness:
name: "&6Sharpness"
mode: +
min: 1
max: 3
Jump:
min: 2
max: 5
Success:
min: 60
max: 90
Destroy:
min: 2
max: 10
Common_Tool:
Name: "&aCommon Tool"
Targets:
- DiaArmour
- DiaTool
Enchantments:
Nightvision:
name: "&eNightvision"
min: 1
max: 3
Jump:
mode: +
min: 2
max: 5
Success:
min: 60
max: 90
Destroy:
min: 2
max: 10
Rare:
Name: "&bRare"
Exp: 300
Books:
Rare_Weapon:
Name: "&bRare Weapon"
Targets:
- DiaWeapon
Enchantments:
Guardian:
min: 1
max: 3
Lightning:
min: 2
max: 5
Success:
min: 50
max: 80
Destroy:
min: 2
max: 10
Rare_Tool:
Name: "&bRare Tool"
Targets:
- DiaWeapon
- DiaTool
Enchantments:
FireProtection:
min: 1
max: 3
Jump:
min: 2
max: 5
Success:
min: 50
max: 80
Destroy:
min: 2
max: 10
Sample config to use DeluxeMenu to create /eb, /enchanter like GUI:
[dropdown=sample DeluxeMenu config]
gui_menus:[/dropdown][dropdown=sample DeluxeMenu config]
ebtool:
menu_title: '&aEnchantmentBook menu'
open_command: enchanter
size: 9
items:
'1':
material: 160
data: 3
amount: 1
slot: 0
display_name: '&aGet more EXP!'
lore:
- '&aclick to add more exp!'
left_click_commands:
- '[console] exp give %player_name% 1000'
- '[close]'
right_click_commands:
- '[console] exp give %player_name% 1000'
- '[close]'
'2':
material: 160
data: 1
amount: 1
slot: 3
display_name: '&aCommon Book'
lore:
- '&acost: 30 exp'
left_click_commands:
- '[player] ebtool get Common'
- '[close]'
right_click_commands:
- '[player] ebtool get Common'
- '[close]'
'3':
material: 160
data: 2
amount: 1
slot: 4
display_name: '&aRare Book'
lore:
- '&acost: 300 exp'
left_click_commands:
- '[player] ebtool get Rare'
- '[close]'
right_click_commands:
- '[player] ebtool get Rare'
- '[close]'
[/dropdown]
This plugin provides a utility function for EnchantmentBook. Its "get" command will allow a player to get/purchase an unopened EnchantmentBook using his/her EXPs.
When "get" command is executed, randomly crafted unopened EnchantmentBook will be issued. The player then can click it (right-click) to discover the actual EnchantmentBook. The level of enchantment, Success rate, Destroy rate is randomly computed to generate the EnchantmentBook.
As a server owner, you can predefine a pool of possible books with a predefined range of enchantment levels, success rates and destroy rates.
You can let your player to use
/ebtool get
command or map that command with predefined enchantment book type (such as Common, Rare, Legendary) to a GUI plugin of your choice.
Video:
Commands:
- /ebtool help : displays the help menu
- /ebtool reload : reloads config file.
- /ebtool get [amount] : give an EnchantmentBook item, which is randomly selected and crafted from a list of enchantments list under
- /ebtool issue [random|book_name] [amount]: issues an EBook to without EXP cost." If you specify the book name, make sure to replace a space (' ') with an underscore ('_').
Permissions:
- enchantmentbooktool.reload : allows you to use /ebtool reload command
- enchantmentbooktool.get : allows you to use /ebtool get command
Installation:
First, you need to install EnchantmentBook.jar into the plugins folder. Once you've installed EB, you can put EnchantmentBookTool.jar in the plugins folder.
Configuration:
You can have full customisation in what sort of EnchantmentBooks are randomly generated and what sort of groups you wish to have (such as Common, Rare, Legendary, etc.)
Messages:
ErrorMsg : "&c[EBTool] : Some error occured."
NoSuchBookType : "&c[EBTool] : No such book type (%type%) is available."
NotEnoughExp : "&c[EBTool] : You need at least %exp% to get this type of a\
enchantment book."
UsedExp : "&a[EBTool] : You've used &e%exp% &aexp to get a book of &e%type\
%&a. You now have %left% exp left."
PlayerOffline : "&c[EBTool] : Player (&e%player%&c) is offline."
NoPermission : "&c[EBTool] : You don't have a permission to use this book (&e%type%&c)."
BookGiven: "&a[EBTool] : You've given a book of &e%type%&a."
BookOpened: "&a[EBTool] : You've opened a book of &e%type%&a, and got &e%booktitle%."
HelpMessages:
banner:
msg: "=== &e[&aEnchantmentBookTool Commands List (%version%)&e] &r==="
help:
msg: "&a/ebtool help : displays this help menu."
reload:
msg: "&a/ebtool reload : reloads config file."
permission: "enchantmentbooktool.reload"
debug:
msg: "&a/ebtool debug : turn on / off the debug mode."
permission: "enchantmentbooktool.debug"
get:
msg: "&a/ebtool get : give an EBook randomly configured and \
selected from a list of enchantments list under ."
permission: "enchantmentbooktool.get"
issue:
msg: "&a/ebtool issue [random|book_name]: issue an EBook to without EXP cost."
permission: "enchantmentbooktool.admin"
# whether players need to use exp to get book or not.
UseEXP: true
# UnOpenedBook's name MUST start with %type%
# UnOpenedBook's lore MUST have at least one line without %type%
UnOpenedBook:
title: "%type% Enchantmetn Book &r(Right Click)"
lore:
- "&7Examine to receive a random"
- "%type% &7enchantment book."
FireWorkEffect:
Color:
- GREEN
- RED
Type: STAR
Power: 0
EnchantmentSets:
Common:
Name: "&aCommon"
Exp: 30
Books:
Common_Amor:
Name: "&aCommon Armour"
Targets:
- DiaArmour
Enchantments:
Sharpness:
name: "&6Sharpness"
mode: +
min: 1
max: 3
Jump:
min: 2
max: 5
Success:
min: 60
max: 90
Destroy:
min: 2
max: 10
Common_Tool:
Name: "&aCommon Tool"
Targets:
- DiaArmour
- DiaTool
Enchantments:
Nightvision:
name: "&eNightvision"
min: 1
max: 3
Jump:
mode: +
min: 2
max: 5
Success:
min: 60
max: 90
Destroy:
min: 2
max: 10
Rare:
Name: "&bRare"
Exp: 300
Books:
Rare_Weapon:
Name: "&bRare Weapon"
Targets:
- DiaWeapon
Enchantments:
Guardian:
min: 1
max: 3
Lightning:
min: 2
max: 5
Success:
min: 50
max: 80
Destroy:
min: 2
max: 10
Rare_Tool:
Name: "&bRare Tool"
Targets:
- DiaWeapon
- DiaTool
Enchantments:
FireProtection:
min: 1
max: 3
Jump:
min: 2
max: 5
Success:
min: 50
max: 80
Destroy:
min: 2
max: 10
Sample config to use DeluxeMenu to create /eb, /enchanter like GUI:
[dropdown=sample DeluxeMenu config]
gui_menus:[/dropdown][dropdown=sample DeluxeMenu config]
ebtool:
menu_title: '&aEnchantmentBook menu'
open_command: enchanter
size: 9
items:
'1':
material: 160
data: 3
amount: 1
slot: 0
display_name: '&aGet more EXP!'
lore:
- '&aclick to add more exp!'
left_click_commands:
- '[console] exp give %player_name% 1000'
- '[close]'
right_click_commands:
- '[console] exp give %player_name% 1000'
- '[close]'
'2':
material: 160
data: 1
amount: 1
slot: 3
display_name: '&aCommon Book'
lore:
- '&acost: 30 exp'
left_click_commands:
- '[player] ebtool get Common'
- '[close]'
right_click_commands:
- '[player] ebtool get Common'
- '[close]'
'3':
material: 160
data: 2
amount: 1
slot: 4
display_name: '&aRare Book'
lore:
- '&acost: 300 exp'
left_click_commands:
- '[player] ebtool get Rare'
- '[close]'
right_click_commands:
- '[player] ebtool get Rare'
- '[close]'
[/dropdown]
