EnchantmentBookTool 4.23.3

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:

• /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]