Description and Installation

EpicBuckets is an outstanding GUI genbucket plugin and the perfect solution for any server. It allows you to create genbuckets exactly as you want them to be. Perfect for factions!

Download EpicBuckets on our Marketplace. Make sure to select the correct download for your server version.

Stop your server, drag and drop EpicBuckets.jar in your plugins folder and restart the server. The plugin should now be loaded and the files should have been created.

EpicBuckets requires Vault and an economy manager to utilize all features.


Features

  • Shops: Allow your player to purchase genbuckets through a built-in shop.
  • Speed: Change how fast the genbucket works.
  • Blacklist: Block specific blocks from getting replaced.
  • Regions: Worldguard, factions and griefprevention regions are supported.
  • Sponge: Stop generation with a sponge.
  • Customization: Customize how the shop and the GUI looks exactly to your liking.

Supported plugins:

  • Worldguard
  • Griefprevention
  • Factions / FactionsUUID

If you would like more plugins to be supported please create a feature request on our service desk.

Frequently asked questions


 How do I hook into regions?

You can hook into supported plugins by adding them to the hooks.yml file. An example is shown below.

hooks.yml
hooks:
  WorldGuard: true
  Example: true
  Example2: false
 How do I generate in different directions?

In EpicBuckets you have different genbuckets you can use. These can be found in the EpicBuckets shop. These are the following types of EpicBuckets.

  • Vertical buckets: These can only be used on the top and bottom of a block. Placing the bucket on the bottom of a block generates the blocks downwards, placing the bucket on the top, generates the blocks on top.
  • Horizontal Buckets: These can only be used on the side of a block. The blocks will be generated in the direction of the side where the bucket is placed.

Commands + Permissions

 Click here to expand...
CommandsPermissionsDescription
/eb helpDefaultDisplays the plugin information and help menu.
/eb reloadOperatorReloads the plugin and it's configurations.
/ebepicbuckets.shopOpens the EpicBuckets shop menu.
/eb admin toggleepicbuckets.adminToggles your status to recieve gen bucket placement notifications.
/eb admin panelepicbuckets.adminOpens up an admin panel with all active genbuckets.

epicbuckets.placeAllows the user to use/place EpicBuckets.

epicbuckets.adminGrants access to all admin commands.

Plugin files

config.yml
###############################################
#                 EpicBuckets                 #
#               Made by Songoda               #
###############################################


# All default configuration files can be found on
# https://www.spigotmc.org/resources/epicbuckets-the-most-powerful-genbucket-plugin.50944/
# Please use 1.13+ material names, the plugin auto converts them to your server version

ENABLE-GENS-IN-WILDERNESS: true

CLOSE-GUI-AFTER-PURCHASE: false # Close the inventory after purchase

INFINITE-USE: false # If enabled, you won't lose a genbucket when you place it down

CHARGE-FOR-INFINITE-USE: false # This requires infinite use to be enabled and will charge the player when placing a genbucket

# Money charged for placing a genbucket when the above is enabled, put 0 if you want no charge
# Use 1.13 material names, they will be auto converted to whatever your server version is
COST-FOR-INFINITE-USE:
  HORIZONTAL:
    COBBLESTONE: 0
    SAND: 0
    OBSIDIAN: 0
  VERTICAL:
    COBBLESTONE: 0
    SAND: 0
    OBSIDIAN: 0
  PSUEDO:
    COBBLESTONE: 0
    SAND: 0
    OBSIDIAN: 0
  INFUSED:
    COBBLESTONE: 0
    OBSIDIAN: 0
    NETHERRACK: 0

GENBUCKET-DELAY: 10 # Ticks delay between genbucket placements, 20 ticks = 1 second, set to 0 for no delay

USE-SPONGE-SUPPORT: false # If a sponge is found it will stop the genbucket
SPONGE-RADIUS: 3 # <- SPONGE-RADIUS 3 == 3x3. I do not recommending putting this higher than 3

MAX-ACTIVE-GEN-PER-PLAYER: 10 # Amount of gens a player can have active at time

PLACE-UNLIMTED-GENS: true # This will override MAX-ACTIVE-GEN-PER-PLAYER and let them place unlimted gens

MAX-VERTICAL-HEIGHT: 50 # Vertical gen height, the gen will stop if y > value

MAX-HORIZONTAL-LENGTH: 50 # Horizontal height

DELAY: 5 # If delay is set to 20 it will place one block every second. 10 will place two blocks each second

DISABLE-GENBUCKETS: false # If enabled placing any genbuckets wont be placeable

CUSTOM-ACTIVE-GEN-PER-PLAY: # Put the highest first
# Everyone with the permission genbucket.limit.god
# will be able to place 30 instead of the default value (MAX-ACTIVE-GEN-PER-PLAYER)
  GOD: "30:genbucket.limit.god"
  VETERAN: "25:genbucket.limit.veteran"
  VIP: "20:genbucket.limit.vip"

# Valid values are: UP, DOWN, SOUTH, NORTH, EAST, WEST
# Whitelist means what faces the genbucket will work on
# Default means when, for example, you allow a vertical genbucket to work on a side that is different from
# UP or DOWN, the plugin will then get this value to allow the genbucket to work. Please make sure this value
# is logical. For the vertical genbucket, that would be either UP or DOWN. Any other value just makes it
# act like a horizontal genbucket, which ofcourse isnt going to work

VALID-FACES:
  HORIZONTAL:
    WHITELIST:
      - "EAST"
      - "WEST"
      - "NORTH"
      - "SOUTH"
    DEFAULT: "NORTH"
  VERTICAL:
    WHITELIST:
      - "UP"
      - "DOWN"
    DEFAULT: "UP"
  PSUEDO:
    WHITELIST:
      - "UP"
      - "DOWN"
    DEFAULT: "UP"
  INFUSED:
    WHITELIST:
      - "EAST"
      - "WEST"
      - "NORTH"
      - "SOUTH"
    DEFAULT: "NORTH"

# All genbuckets will run over these materials
# except the psuedo.
# Make all words capital!

IGNORE-MATERIALS:
  - "AIR" # <- Don't remove unless you know what you're doing

PSUEDO-MATERIALS: # Which materials should the psuedo genbucket work on?
  - "cobblestone"
  - "sand"
  - "obsidian"

FILL-ITEM:

  name: " "

  material: WHITE_STAINED_GLASS_PANE

BACK-BUTTON:

  name: " &c&lReturn back to categories"

  material: BARRIER


BULK-SHOP-INVENTORY:

  inventory-name: "Bulk shop for {player}"

  size: 6 # Number of lines in inventory

  fill: false # recommended off

  return-back-slot: 49

  main-item-slot: 22

  increase-item:

    material: GREEN_STAINED_GLASS_PANE

    slots: "24,25,26" # Put only three integers and separate with commas

  decrease-item:

    material: RED_STAINED_GLASS_PANE

    slots: "18,19,20" # Put only three integers and separate with commas

  purchase-item:

    name: "&a&lConfirm"

    material: YELLOW_STAINED_GLASS

    slot: 40


# All material names can be found @ https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html

MENU-ITEMS:

  size: 3

  fill: true # Fill inventory ?

  inventory-name: "Select a category"

  '1': # Must be unique

    item: # Item configuration

      material: WATER_BUCKET # material name

      name: "&eVertical genbuckets" # Name of the item

      lore: # Lore of the item
        - ""
        - "&7&o(( Click to open shop ))"
        - ""
        - "&7Use vertical genbuckets to create"
        - "&7vertical walls fast and efficient"
        - ""

    shop: "vertical" # make a shop in shops.yml

    slot: 10 # slot in the gui

  '2':

    item:

      material: WATER_BUCKET

      name: "&eHorizontal genbuckets"

      lore:
        - ""
        - "&7&o(( Click to open shop ))"
        - ""
        - "&7Use horizontal genbuckets to create"
        - "&7roofs & floors fast and efficient"
        - ""

    shop: "horizontal"

    slot: 12 # slot in the gui

  '3':

    item:

      material: WATER_BUCKET

      name: "&eInfused genbuckets"

      lore:
        - ""
        - "&7&o(( Click to open shop ))"
        - ""
        - "&7Use infused genbuckets to place"
        - "&7vertical walls on each side of the"
        - "&7block"
        - ""

    shop: "infused"

    slot: 14 # slot in the gui

  '4':

    item:

      material: WATER_BUCKET

      name: "&ePsuedo genbuckets"

      lore:
        - ""
        - "&7&o(( Click to open shop ))"
        - ""
        - "&7Use psuedo genbuckets to repair"
        - "&7broken walls"
        - ""

    shop: "psuedo"

    slot: 16 # slot in the gui
shops.yml
use-back-buttons: true

shops:

  vertical:

    enabled: true

    goBackButton: 31 # back button will display if enabled in file.yml

    trait: "VERTICAL" # Which genbucket type does this shop have?

    size: 4 # Number of lines in inventory

    fill: true # Fill inventory ?

    inventory-name: "Vertical genbuckets"

    '0': # Must be unique

      name: "&eVertical Cobble" # Genbucket item name

      icon: "WATER_BUCKET" # This is the item placed in the GUI and the item you will get when purchased

      type: "COBBLESTONE" # This is the material the bucket places

      slot: 12 # This is the slot for the bucket in the GUI

      price: 400 # This is the price for the bucket

      description: # This is the lore of the bucket in the gui
      - ""
      - "&7&o((Left click to buy or right click to open bulk shop))"
      - ""
      - "&7Price for one &e%price%" # The {price} and {material} placeholders only works in description
      - ""
      - "&7Spawns &e%material% &7blocks"
      - ""

      item-lore: # New lore after the gen has been purchased
      - ""
      - "&7&oRight click a block to place"
      - ""

    '1':

      name: "&eVertical Sand"

      icon: "WATER_BUCKET"

      type: "SAND"

      slot: 13

      price: 400

      description: # This is the lore of the bucket in the gui
      - ""
      - "&7&o((Left click to buy or right click to open bulk shop))"
      - ""
      - "&7Price for one &e%price%" # The {price} and {material} placeholders only works in description
      - ""
      - "&7Spawns &e%material% &7blocks"
      - ""

      item-lore: # New lore after the gen has been purchased
      - ""
      - "&7&oRight click a block to place"
      - ""

    '2':

      name: "&eVertical Obby"

      icon: "WATER_BUCKET"

      type: "OBSIDIAN"

      slot: 14

      price: 700

      description: # This is the lore of the bucket in the gui
      - ""
      - "&7&o((Left click to buy or right click to open bulk shop))"
      - ""
      - "&7Price for one &e%price%" # The {price} and {material} placeholders only works in description
      - ""
      - "&7Spawns &e%material% &7blocks"
      - ""

      item-lore: # New lore after the gen has been purchased
      - ""
      - "&7&oRight click a block to place"
      - ""

  infused:

    enabled: true

    goBackButton: 31

    trait: "INFUSED"

    size: 4

    fill: true

    inventory-name: "Infused genbuckets"

    '0':

      name: "&eInfused Cobble"

      icon: "WATER_BUCKET"

      type: "COBBLESTONE"

      slot: 12

      price: 200

      trait: "INFUSED"

      description: # This is the lore of the bucket in the gui
      - ""
      - "&7&o((Left click to buy or right click to open bulk shop))"
      - ""
      - "&7Price for one &e%price%" # The {price} and {material} placeholders only works in description
      - ""
      - "&7Spawns &e%material% &7blocks"
      - ""

      item-lore: # New lore after the gen has been purchased
      - ""
      - "&7&oRight click a block to place"
      - ""

    '1':

      name: "&eInfused Obsidian"

      icon: "WATER_BUCKET"

      type: "OBSIDIAN"

      slot: 13

      price: 700

      trait: "INFUSED"

      description: # This is the lore of the bucket in the gui
      - ""
      - "&7&o((Left click to buy or right click to open bulk shop))"
      - ""
      - "&7Price for one &e%price%" # The {price} and {material} placeholders only works in description
      - ""
      - "&7Spawns &e%material% &7blocks"
      - ""

      item-lore: # New lore after the gen has been purchased
      - ""
      - "&7&oRight click a block to place"
      - ""


    '2':

      name: "&eInfused Netherrack"

      icon: "WATER_BUCKET"

      type: "NETHERRACK"

      slot: 14

      price: 31

      trait: "INFUSED"

      description: # This is the lore of the bucket in the gui
      - ""
      - "&7&o((Left click to buy or right click to open bulk shop))"
      - ""
      - "&7Price for one &e%price%" # The {price} and {material} placeholders only works in description
      - ""
      - "&7Spawns &e%material% &7blocks"
      - ""

      item-lore: # New lore after the gen has been purchased
      - ""
      - "&7&oRight click a block to place"
      - ""

  psuedo:

    enabled: true

    goBackButton: 31

    trait: "PSUEDO"

    size: 4

    fill: true

    inventory-name: "PsuedoVertical genbuckets"

    '0': # Must be unique

      name: "&ePsuedo Cobble"

      icon: "WATER_BUCKET"

      type: "COBBLESTONE"

      slot: 12

      price: 400

      description: # This is the lore of the bucket in the gui
      - ""
      - "&7&o((Left click to buy or right click to open bulk shop))"
      - ""
      - "&7Price for one &e%price%" # The {price} and {material} placeholders only works in description
      - ""
      - "&7Spawns &e%material% &7blocks"
      - ""

      item-lore: # New lore after the gen has been purchased
      - ""
      - "&7&oRight click a block to place"
      - ""

    '1':

      name: "&ePsuedo Sand"

      icon: "WATER_BUCKET"

      type: "SAND"

      slot: 13

      price: 400

      description: # This is the lore of the bucket in the gui
      - ""
      - "&7&o((Left click to buy or right click to open bulk shop))"
      - ""
      - "&7Price for one &e%price%" # The {price} and {material} placeholders only works in description
      - ""
      - "&7Spawns &e%material% &7blocks"
      - ""

      item-lore: # New lore after the gen has been purchased
      - ""
      - "&7&oRight click a block to place"
      - ""

    '2':

      name: "&ePsuedo Obby"

      icon: "WATER_BUCKET"

      type: "OBSIDIAN"

      slot: 14

      price: 700

      description: # This is the lore of the bucket in the gui
      - ""
      - "&7&o((Left click to buy or right click to open bulk shop))"
      - ""
      - "&7Price for one &e%price%" # The {price} and {material} placeholders only works in description
      - ""
      - "&7Spawns &e%material% &7blocks"
      - ""

      item-lore: # New lore after the gen has been purchased
      - ""
      - "&7&oRight click a block to place"
      - ""

  horizontal:

    enabled: true

    goBackButton: 31

    trait: "HORIZONTAL"

    size: 4

    fill: true

    inventory-name: "Horizontal genbuckets"

    '0': # Must be unique

      name: "&eHorizontal Cobble"

      icon: "WATER_BUCKET"

      type: "COBBLESTONE"

      slot: 12

      price: 400

      description: # This is the lore of the bucket in the gui
      - ""
      - "&7&o((Left click to buy or right click to open bulk shop))"
      - ""
      - "&7Price for one &e%price%" # The {price} and {material} placeholders only works in description
      - ""
      - "&7Spawns &e%material% &7blocks"
      - ""

      item-lore: # New lore after the gen has been purchased
      - ""
      - "&7&oRight click a block to place"
      - ""

    '1':

      name: "&eHorizontal Sand"

      icon: "WATER_BUCKET"

      type: "SAND"

      slot: 13

      price: 400

      description: # This is the lore of the bucket in the gui
      - ""
      - "&7&o((Left click to buy or right click to open bulk shop))"
      - ""
      - "&7Price for one &e%price%" # The {price} and {material} placeholders only works in description
      - ""
      - "&7Spawns &e%material% &7blocks"
      - ""

      item-lore: # New lore after the gen has been purchased
      - ""
      - "&7&oRight click a block to place"
      - ""

    '2':

      name: "&eHorizontal Obby"

      icon: "WATER_BUCKET"

      type: "OBSIDIAN"

      slot: 14

      price: 700

      description: # This is the lore of the bucket in the gui
      - ""
      - "&7&o((Left click to buy or right click to open bulk shop))"
      - ""
      - "&7Price for one &e%price%" # The {price} and {material} placeholders only works in description
      - ""
      - "&7Spawns &e%material% &7blocks"
      - ""

      item-lore: # New lore after the gen has been purchased
      - ""
      - "&7&oRight click a block to place"
      - ""

Plugin Tutorial

Coming soon!

Still need help?

Couldn't find what you're looking for? Feel free to contact us on our Discord or Service Desk!

  • No labels