Epic Hoppers

This plugin changes the way hoppers work, by adding new features that allow users to make a profit, collect materials (even remotely) and make grinding, in general, a more fun and easy thing to do.
Part of the Epic Series.

Getting Started

To install EpicHoppers you will need to:

1. Turn your server off.
2. Add the required dependencies: Vault.
3. Add the optional dependencies: ShopGUI+.
4. Add in the latest version of EpicHoppers which you can find in our marketplace.
5. Turn your server back on.

Unlockables

Each level has customizable unlockables based on the levels.yml configuration. Keep in mind that you can allow unlocks of certain abilities at a smaller level if you wish so, simply add the option in the levels.yml file.

---

The following unlockables are available for customization:

Name	Description	Image
Range	The distance in blocks a hopper can wirelessly transmit items to other containers such as other hoppers, chests, furnaces, etc... It should be noted that this can not travel across worlds.
Amount	The number of items that will wirelessly or non-wirelessly transmit from one hopper to another hopper at a time. The time option can be specified in the config.yml file, while the Amount per level option is set in the levels.yml file.
Link-amount	Used to indicate many hoppers a single hopper can be connected too. When this is unlocked players will be able to utilize this upgrade by clicking the usual link button referenced in the {Amount} module. Then punch the desired linkable containers to complete the linking process. If you do not wish to utilize all available links, simply punch the original hopper to complete the process.
Suction	Automatically transfers the items in the suction area into the inventory of the hopper. The default range of is set to 3 but can be edited set in the levels.yml file dependent on your personal preference. You can also lower or disable the Suction on an individual hopper through the GUI.
Cost-xp	The cost in experience levels required to perform an upgrade to the hopper. This is set in the levels.yml file.
Cost-eco	The amount of money (player balance) required to perform an upgrade to the hopper. This is set in the levels.yml file.
Filter	You can set items to filter into two different chests or be voided (destroyed). You can access the Whitelist and Blacklist through the GUI.
Teleport	Provides the ability to teleport to another linked hopper. Please keep in mind, that the teleportation will only be active to the first linked up hopper, not all of them. If there is a need for multiple hoppers to be linked, you need to set them in a chain mode (A --> B --> C).
AutoSell	Sells all items that have been put in the sale Whitetilst, this is a separate whitelist than the filter one. You can either use ShopGUI+ for the prices or set them up in the config.yml file.
BlockBreak	Gives the ability for hoppers to break any blocks that are above them automatically. The frequency of the block breaking can be edited in the levels.yml file.
AutoCrafting	Provides the ability to autocraft certain items. The list of the craftable items can be edited in the config.yml file.

Plugin Files

---

Main:

  # Should hoppers be upgradable?
  Allow hopper Upgrading: true

  # Should you be able to upgrade hoppers with economy?
  Upgrade With Economy: true

  # Should you be able to upgrade hoppers with experience?
  Upgrade With XP: true

  # Should natural hoppers not be epic hoppers?
  Allow Normal Hoppers: false

  # Should players be able to teleport through hoppers?
  Allow Players To Teleport Through Hoppers: true

  # Should hoppers dump items into a player enderchests?
  Support Enderchests: true

  # The type of particle shown when a hopper is upgraded.
  Upgrade Particle Type: SPELL_WITCH

  # The amount of ticks between hopper transfers.
  Amount of Ticks Between Hops: 8

  # The amount of time in between saving to file.
  # This is purely a safety function to prevent against unplanned crashes or
  # restarts. With that said it is advised to keep this enabled.
  # If however you enjoy living on the edge, feel free to turn it off.
  Auto Save Interval In Seconds: 15

  # The cooldown between teleports. It prevents players
  # from getting stuck in a teleport loop.
  Amount of Ticks Between Teleport: 10

  # The amount of time in ticks a player has between hitting the hopper
  # Link button and performing the link. When the time is up the link event is canceled.
  Timeout When Syncing Hoppers: 300

  # Items that shouldn't work with Sync touch. You should put items in here
  # that other plugins use to store data with.
  Sync Touch Blacklist:
  - CHEST
  - FURNACE
  - HOPPER

  # The maximum amount of hoppers per chunk.
  Max Hoppers Per Chunk: -1

  # The particle shown when the block break module performs a block break.
  BlockBreak Particle Type: LAVA

  # Anything listed here will not be broken by the block break module.
  BlockBreak Blacklisted Blocks:
  - BEDROCK
  - END_PORTAL
  - ENDER_PORTAL
  - END_PORTAL_FRAME
  - ENDER_PORTAL_FRAME
  - PISTON_HEAD
  - PISTON_EXTENSION
  - RAIL
  - RAILS
  - ACTIVATOR_RAIL
  - DETECTOR_RAIL
  - POWERED_RAIL

  # AutoCraft module needs a free slot to craft items with.
  # Normally, crafting hoppers won't grab items that would fill that slot.
  # This option ejects items if that last slot is forcibly filled
  AutoCraft Jam Eject: false

  # Anything listed here will not be able to be auto crafted.
  AutoCraft Blacklist:
  - BEDROCK
  - EGG

  # These are the prices used by the auto sell module.
  AutoSell Prices:
  - STONE,0.50
  - COBBLESTONE,0.20
  - IRON_ORE,0.35
  - COAL_ORE,0.20

  # Should prices be grabbed from ShopGuiPlus?
  # If ShopGuiPlus is not enabled or the player is offline the default price list will be used.
  # If this is something that you do not want then you should empty the default list.
  Use ShopGuiPlus for Prices: false

  # Which economy plugin should be used?
  # Supported plugins you have installed: "Vault".
  Economy: Vault

Interfaces:

  Economy Icon: SUNFLOWER

  XP Icon: EXPERIENCE_BOTTLE

  Glass Type 1: GRAY_STAINED_GLASS_PANE

  Glass Type 2: BLUE_STAINED_GLASS_PANE

  Glass Type 3: LIGHT_BLUE_STAINED_GLASS_PANE

System:
  # The enabled language file.
  # More language files (if available) can be found in the plugins data folder.
  Language Mode: en_US

Level-1:
  Range: 10
  Amount: 1
  Cost-xp: 20
  Cost-eco: 5000
Level-2:
  Range: 20
  Amount: 2
  Cost-xp: 25
  Cost-eco: 7500
Level-3:
  Range: 30
  Amount: 3
  Suction: 1
  Cost-xp: 30
  Link-amount: 2
  Cost-eco: 10000
Level-4:
  Range: 40
  Amount: 4
  Suction: 2
  Link-amount: 2
  BlockBreak: 4
  Cost-xp: 35
  Cost-eco: 12000
Level-5:
  Range: 50
  Amount: 5
  Suction: 3
  BlockBreak: 2
  Link-amount: 3
  Cost-xp: 40
  Cost-eco: 15000
Level-6:
  Range: 60
  Amount: 5
  Suction: 3
  BlockBreak: 2
  Filter: true
  Teleport: true
  AutoSell: 60
  Link-amount: 3
  Cost-xp: 45
  Cost-eco: 20000
Level-7:
  Range: 70
  Amount: 5
  Suction: 3
  BlockBreak: 2
  Filter: true
  Teleport: true
  AutoSell: 30
  AutoCrafting: true
  Link-amount: 4
  Cost-xp: 50
  Cost-eco: 30000

Translations

We offer translated versions of this plugin! In order to use them, enter the corresponding Language Code into your config.yml.

Language	Language code
Arabic	ar_EG
English	en_US
Spanish	es_ES
Faroese	fo_FO
French	fr_FR
Italian	it_IT
Dutch	nl_NL
Norwegian	no_NO
Polish	pl_PL
Persian	pr_FA
Portuguese	pr_PT
Russian	ru_RU
Swedish	sv_SE
Turkish	tr_TR

Permissions & Commands

---

Command	Description	Permission Node
<player> - The playername for the person that you are targeting.
<level> - Indicates the level of the hopper spawned.
<duration> - Can either be days(d), hours(h), minutes(m) or seconds(s). For example 10 seconds would be 10s.
/eh	Displays the basic help menu for the EpicHoppers plugin.	Given by default.
/eh give <player> <level>	Give yourself or another player a EpicHopper with a defined level.	epichoppers.admin
/eh boost <player> <multiplier> <duration>	Allows you to boost the transfer speed of all hoppers owned by the player by a multiplier.
/eh reload	Reloads the EpicHoppers configuration and language files.
Bypass all plugin restrictions and grants access to all admin commands for EpicHoppers.
Allows you to use EpicHoppers.		epichoppers.overview
Allows you to override the range.		epichoppers.override
Allows players to use the teleport button in the hopper interface without the need to upgrade their hoppers for it.		epichoppers.teleport
Giving this permission to a player will allow them to bypass build/interact restrictions within EpicHoppers.		epichoppers.bypass
Allows the user to upgrade an EpicHopper using money.		epichoppers.upgrade.eco
Allows the user to upgrade an EpicHopper using XP.		epichoppers.upgrade.XP
Allows players to use the Filter without the need to upgrade their hoppers for it.		epichoppers.filter
Allows players to use AutoCrafting without the need to upgrade their hoppers for it.		epichoppers.crafting
With this, you can specify the number of hoppers that a player is allowed to place within one chunk.		epichoppers.limit.<amount>

Supported Plugins

• Factions / FactionsUUID
• ASkyBlock / USkyblock / FabledSkyblock
• WorldGuard
• GriefPrevention
• Kingdoms
• Towny
• ShopGUI+
• BentoBox

For compatibility with BentoBox, use EpicHooks