SuperHoppers icon

SuperHoppers -----

Item Hopper | Mob Hopper | Custom Hoppers | API



banner_2.png

Collect, sell and withdraw unlimited
amounts of items and mobs
in any chunk!

Requires: [Vault + Economy plugin]




features.png

Current features:
  • Efficient - reduce server lag caused by massive farms.
  • Extremely configurable.
  • Developer API.
  • SQLite support.
  • Collect any mob or item (even custom ones) within either chunk or radius.
  • Sell and withdraw collected mobs and items.
  • Per hopper item filter.
  • Funnel filter to instantly remove unwanted items.
  • Custom item hoppers which collect only certain items.
  • Single mob hoppers.
  • Hopper links to access hopper remotely.
  • Hopper storage to view all your hoppers at one place.
  • Advanced mob withdrawal system replicates vanilla drops.
  • Holograms display total worth, owner name etc.
  • Custom, predefined hoppers.
  • Enable auto-sell and receive notifications on how much you're earning.
  • Let other players access your individual hoppers using a "trusted" system.
  • CMI, HolographicDisplays, DecentHolograms, HeadDatabase, ShopGUIPlus, WildStacker, RoseStakcer support.
  • And much more!
Upcoming features:
  • Want something added to this list? Join me on Discord!


Item Hopper
[​IMG]


Mob hopper
[​IMG]



commands.png

Commands:
Code (Text):
/hopper give <player> <type> [amount] #superhoppers.command.give
/hopper reload #superhoppers.command.reload
/hopper trust #superhoppers.command.trust
/hopper trustall #superhoppers.command.trustall
/hopper storage #superhoppers.command.storage
/hopper help
/hopper migrate #Migrates between storage methods
 

config.png

Code (YAML):
#---------------------# General settings #---------------------#

prefix
: "&7[&cHopper&7]"
#How often configs should save automatically (minutes)
auto_save_interval
: 1
#Enabling this will not allow players to place more than one
#item hopper per chunk
one_hopper_per_chunk
: false
#Enabling this will only allow sellable items to be collected
#using item hoppers
collect_only_sellables
: false
#Currency symbol
currency
: "$"
#Should the currency symbol be placed before worth?
currency_before
: false
#Disables selling collected items/mobs
disable_selling
: false
#ItemHoppers will collect all items if there are no filter
enable_collect_all
: true
#Enabling this will give more loot when withdrawing
#mobs if the player holds an item with the looting
#enchantment. Only for vanilla loot tables.
enable_looting_enchantment
: false
#Enabling this will disable holograms
disable_holograms
: false
#Enabling this will make the hoppers use the vanilla
#hopper GUI instead of the custom one for item hoppers.
disable_enhanced_gui
: false
#Will disable sell all for all hoppers
disable_sell_all
: false
#Enable/disable giving xp when withdrawing mobs
give_xp
: true
#Selling mobs will give money based on the mob's drop
#instead of the mob's worth. Enabling this will make
#the %worth% placeholder for mob hoppers show an
#estimated value.
sell_mobs_by_drop
: true
#Enabling this will make item hoppers drop the items
#collected when broken instead of selling the items.
drop_items
: false
#Should plugin get items worth from ShopGUIPlus instead?
use_shop_gui_plus
: false
#Should ShopGUIPlus look up permissions for different
#item prices? E.g. for boosters or rank shops.
shop_gui_plus_perms
: true
#Disables the void filter
disable_void_filter
: false
#Disables withdrawing mobs
disable_mob_withdraw
: false
#Hologram update interval (in ticks)
hologram_update_interval
: 100
radius_collection
:
  #Should the hoppers use chunks or radius for collection
  enable
: false
  #Radius for collection
  radius
: 20
auto_sell
:
  #Will disable auto selling for all hoppers
  disable
: false
  #Should the hoppers sell items instantly when collected?
  instant
: true
  #How often should the hoppers sell items (in ticks)
  interval
: 100

#--------------------# Database settings #--------------------#
database
:
  #Database type: YAML, SQLITE
  method
: YAML

#--------------------# Hologram settings #--------------------#

#Use CMI holograms instead of HolographicDisplays or DecentHolgorams
hologram_use_cmi
: false
#Will remove all nearby CMI holograms when the
#server is stopping. Only enable if you experience
#hologram duplication!
aggressive_hologram_cleaning
: false
#Hologram Y offset
hologram_offset
: 0
#Placeholders are %worth% and %owner%
item_hologram
:
 - "&7>> &cSuperHopper &7(&c%type%&7) <<"
  - " "
  - "&7Worth
: &a%worth%"
  - "&7Owner
: &e%owner%"
  - " "
  - "&7> Right Click to enter &eStorage&7<"
  - "&7> Shift + Right Click to edit &eFilter &7<"
  - "&7> Shift + Left Click to &aSell All &7<"
mob_hologram
:
 - "&7>> &cSuperHopper &7(&c%type%&7) <<"
  - " "
  - "&7Worth
: &a%worth%"
  - "&7Owner
: &e%owner%"
  - " "
  - "&7> Right Click to enter &eStorage&7<"
  - "&7> Shift + Left Click to &aSell All &7<"
link_hologram
:
 - "&7>> &eHopperLink &7<<"
  - " "
  - "&7Worth
: &a%worth%"
  - "&7Owner
: &e%owner%"
  - "&7Linked to
: &e%linked%"
  - " "
  - "&7> Click to interact &7<"

#--------------------# Messages and sounds #--------------------#

#Plugin messages
messages
:
  config_reload
: "&eConfig reloaded!"
  no_permission
: "&cYou do not have permissions for this!"
  no_permission_command
: "&cYou do not have permissions to use this command!"
  player_not_found
: "&cUnable to find player!"
  invalid_range
: "&cAmount must be between 1 and 64!"
  hopper_placed
: "&eSuperHopper placed!"
  hopper_removed
: "&eSuperHopper removed!"
  no_access
: "&cYou do not have access to this hopper!"
  sell_everything
: "&eSold everything for &a%worth%&e!" #Placeholders: %worth%
  sell_item
: "&eSold item for &a%worth%&e!" #Placeholders: %worth%
  sell_mob
: "&eSold mob for &a%worth%&e!" #Placeholders: %worth%
  sell_notify
: "&eYou have sold for &a%worth% &ethe past &c%time% &eminutes!" #Placeholders: %worth%, %minutes%
  on_join
: "&eYou have sold for &a%worth% &esince last time you logged in!" #Placeholders: %worth%
  click_to_trust
: "&eClick on the hopper you want &a%player% &eto be able to access!" #Placeholders: %player%
  click_to_untrust
: "&eClick on the hoppers you want to remove &a%player%'s &eaccess to!" #Placeholders: %player%
  click_to_toggle_trust_all
: "&eClick on the hopper you want &aeveryone &eto be able to access!"
  added_trusted
: "&a%player% &eadded to trusted players for this hopper!" #Placeholders: %player%
  removed_trusted
: "&a%player% &eremoved from trusted players for this hopper!" #Placeholders: %player%
  toggle_trust_all
: "&eTrust-all set to &b%state% &efor this hopper!" #Placeholders: %state% (true/false)
  item_blacklisted
: "&cThis item is blacklisted!"
  filter_max
: "&cYou've reached the maximum amount of filtered items!"
  mob_hopper_already_in_chunk
: "&cThere is already a mob hopper in this chunk!"
  item_hopper_already_in_chunk
: "&cThere is already an item hopper in this chunk!"
  item_not_sellable
: "&cYou can not add non-sellable items to the filter!"
  click_entity
: "&ePlease right click on an entity..."
  upgrade
: "&eUpgrade: %upgrade%"
  hopper_linked
: "&aHopperLink successfully linked to SuperHopper! You can now place it to create a link."
  not_a_hopper
: "&cThis is not a SuperHopper!"
  no_link_hopper
: "&cThis HopperLink does not have a linked SuperHopper! Right click a SuperHopper to link it."
  hopper_link_broken
: "&cThis HopperLink is no longer linked to a SuperHopper!"
  link_removed
: "&aHopperLink successfully removed!"
  link_placed
: "&aHopperLink successfully placed!"
  wait_before_click
: "&cPlease wait before clicking again!"

#Plugin sounds
sounds
:
  hopper_get
: ENTITY_ITEM_PICKUP
  hopper_place
: BLOCK_BEACON_ACTIVATE
  hopper_break
: BLOCK_BEACON_DEACTIVATE
  hopper_no_access
: BLOCK_ANVIL_PLACE
  hopper_open
: BLOCK_CHEST_OPEN
  auto_sell_switch
: UI_BUTTON_CLICK
  filter_add
: ITEM_ARMOR_EQUIP_LEATHER
  filter_remove
: BLOCK_FIRE_EXTINGUISH
  filter_already_contains
: BLOCK_ANVIL_PLACE
  withdraw
: ENTITY_ITEM_PICKUP
  sell
: ENTITY_EXPERIENCE_ORB_PICKUP
  sell_notify
: ENTITY_EXPERIENCE_ORB_PICKUP
  trust
: ENTITY_EXPERIENCE_ORB_PICKUP
  invalid_place
: BLOCK_ANVIL_PLACE
  hopper_link
: ENTITY_EXPERIENCE_ORB_PICKUP

#--------------------# Filter settings #--------------------#

filter
:
  #Inventory title
  title
: "&8Filter Items"
  size
: 54
  #Filler item at the bottom of the inventory
  filler
:
    material
: GRAY_STAINED_GLASS_PANE
    name
: " "
    lore
:
     - ""
    slots
: [45, 46, 47, 48, 50, 51, 52, 53 ]
  back
:
    material
: ARROW
    name
: "&eBack"
    slot
: 49
  #Lore for filter items
  item_lore
:
   - "&cClick &7to remove"
    - "&7item from the filter"
    - ""
    - "&c&lNB! &7(Removing will sell"
    - "&7all items of that material)"
    - ""
  #Max amount of items in the filter
  max_items
: 45

#--------------------# Storage Settings #--------------------#

storage
:
  #Inventory title
  title
: "&8SuperHopper Storage"
  #Size for normal storage inventory
  size_normal
: 54
  #Size for single type storage inventory
  size_single
: 36
  #Slots for storage items
  slots
: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44 ]
  #Slot for single type storage inventory
  single_slot
: 13
  #Filler item at the bottom of the inventory
  filler
:
    material
: GRAY_STAINED_GLASS_PANE
    name
: ""
    slots
: [45, 46, 47, 48, 49, 50, 51, 52, 53 ]
  #Auto sell slot for normal storage inventory
  auto_sell_slot_normal
: 48
  #Auto sell slot for single type storage inventory
  auto_sell_slot_single
: 30
  #Item when Auto-Sell is enabled
  auto_sell_true
:
    material
: LIME_TERRACOTTA
    name
: "&eAuto-Sell: &aEnabled"
    lore
:
     - ""
      - "&7The SuperHopper will"
      - "&7automatically sell all"
      - "&7collected items"
      - ""
      - "&7>> Click to &cDisable"
  #Item when Auto-Sell is disabled
  auto_sell_false
:
    material
: RED_TERRACOTTA
    name
: "&eAuto-Sell: &cDisabled"
    lore
:
     - ""
      - "&7The SuperHopper will"
      - "&7collect items normally"
      - ""
      - "&7>> Click to &aEnable"
  #Sell all slot for normal storage inventory
  sell_all_slot_normal
: 50
  #Sell all slot for single type storage inventory
  sell_all_slot_single
: 32
  #Item to sell all items in the storage
  sell_all_true
:
    material
: LIME_STAINED_GLASS
    name
: "&eSell all: &aEnabled"
    lore
:
     - ""
      - "&7Shift + left click"
      - "&7the hopper to sell"
      - "&7everything quickly"
      - ""
      - "&7>> Click to &cDisable"
  sell_all_false
:
    material
: RED_STAINED_GLASS
    name
: "&eSell all: &cDisabled"
    lore
:
     - ""
      - "&7Shift + left click"
      - "&7the hopper to sell"
      - "&7everything quickly"
      - ""
      - "&7>> Click to &aEnable"
  next_page
:
    material
: ARROW
    name
: "&eNext page"
    slot
: 52
  previous_page
:
    material
: ARROW
    name
: "&ePrevious page"
    slot
: 46
  #Void filter slot for normal storage inventory
  void_filter_slot_normal
: 49
  #Void filter slot for single type storage inventory
  void_filter_slot_single
: 31
  #Item to open the void filter
  void_filter
:
    material
: LAVA_BUCKET
    name
: "&cVoid Filter"
    lore
:
     - "&7All items in this filter will"
      - "&7be destroyed when collected/withdrawn."
      - ""
      - "&7>> Click to open"
  #Item to open the filter
  filter
:
    slot
: 45
    material
: BUCKET
    name
: "&eFilter"
    lore
:
     - "&7>> Click to open"
  #Lore for items in storage. Placeholders are %amount% and %worth%
  lore
:
   - ""
    - "&6> &eAmount
: &cx%amount%"
    - "&6> &eWorth
: &a%worth%"
    - ""
    - "&7>> Left click to &aSell &7<<"
    - "&7>> Right click to &eWithdraw &7<<"


#--------------------# Void Filter #--------------------#

void_filter
:
  size
: 54
  title
: "&8Void Filter"
  #Filler item at the bottom of the inventory
  filler
:
    material
: GRAY_STAINED_GLASS_PANE
    name
: ""
    slots
: [45, 46, 47, 48, 49, 50, 51, 52, 53 ]
  back
:
    slot
: 49
    material
: ARROW
    name
: "&eBack"
  #Lore for filter items
  item_lore
:
   - "&cClick &7to remove"


#--------------------# Global Storage settings #--------------------#

global_storage
:
  title
: "&8Global Storage"
  size
: 54
  #Slots for hoppers
  slots
: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44 ]
  #Filler item at the bottom of the inventory
  filler
:
    material
: GRAY_STAINED_GLASS_PANE
    name
: ""
    slots
: [45, 46, 47, 48, 49, 50, 51, 52, 53 ]
  next
:
    material
: ARROW
    name
: "&eNext page"
    slot
: 53
  previous
:
    material
: ARROW
    name
: "&ePrevious page"
    slot
: 45
  item
:
    material
: HOPPER
    name
: "%name%"
    #Lore for items in storage. Placeholders are %amount% and %worth%
    lore
:
     - ""
      - "&6> &eLocation
: &a%location%"
      - "&6> &eType
: &c%type%"
      - "&6> &eWorth
: &a%worth%"
      - ""
      - "&7>> Click to open &7<<"

#--------------------# SuperHopper item settings #--------------------#

#Item given by /hopper give. Placeholders are %type%
item
:
  material
: HOPPER
  name
: "&c&lSuperHopper &7(&e%type%&7)"
  lore
:
   - "&7Use this hopper to"
    - "&7collect &e%type% &7in"
    - "&7the chunk you place it!"
    - ""
link
:
  material
: CHEST
  name
: "&e&lHopperLink &7(%status%&7)"
  lore
:
   - "&7Right click on a SuperHopper"
    - "&7to link it to this HopperLink!"
    - ""
    - "&7Currently linked to hopper at:"
    - "&e%location%"

link_status
:
  linked
: "&aLinked"
  unlinked
: "&cUnlinked"
  no_location
: "&eNot linked"

#--------------------# Other settings #--------------------#

#Should SuperHoppers catching fire be cancelled?
cancel_block_burn
: true
#Should SuperHoppers taking explosion damage be cancelled?
cancel_block_explode
: true
#Should piston movement on SuperHoppers be cancelled?
cancel_piston_move
: true
#How often should players get notified how much they've earned from auto-sell? (In minutes)
sell_notify_interval
: 1
#Items which should be blacklisted from the filter
use_whitelist
: false #If true, only items in the list will be allowed
item_blacklist
:
 - DEAD_BUSH

#SuperBoosters settings
super_boosters
:
  #Name of the SuperBooster
  name
: "Money"
  #Money multiplier is this booster is active
  multiplier
: 2
 
Code (YAML):
#----------------------- Item worth -----------------------#

#Items and worth if ShopGUIPlus hook is disabled
item_worth
:
  IRON_INGOT
: 10.0
  GOLD_INGOT
: 100.0
  DIAMOND
: 1000.0


#------------------- Custom loot tables -------------------#

custom_loot_tables
:
  #If you want to use custom loot tables, set this to true
  enable
: false
  #List all mobs which should use custom loot tables. If a
  #mob is not listed, it will default to it's vanilla table
  mobs
:
    #EntityType of mob
    SKELETON
:
      #Material
      BONE
:
        #Probability of receiving this item
        probability
: 1
        #Minimum amount
        min
: 0
        #Maximum amount
        max
: 2
      ARROW
:
        probability
: 1
        min
: 0
        max
: 2
    ZOMBIE
:
      ROTTEN_FLESH
:
        probability
: 1
        min
: 0
        max
: 2
      POTATO
:
        probability
: 0.025
        min
: 1
        max
: 1
      IRON_INGOT
:
        probability
: 0.025
        min
: 1
        max
: 1
      CARROT
:
        probability
: 0.025
        min
: 1
        max
: 1
    COW
:
      LEATHER
:
        probability
: 1
        min
: 0
        max
: 2
      BEEF
:
        probability
: 1
        min
: 1
        max
: 3
    PIG
:
      PORKCHOP
:
        probability
: 1
        min
: 1
        max
: 3

#Enabled if custom_loot_tables is enabled
custom_xp
:
  mobs
:
    SKELETON
: 10

 
Code (YAML):
#--------------------- Mobs ---------------------#

#If you want to use HeadDatabase IDs instead of vanilla
#materials, enable HeadDB in the config.yml and place
#'hdb:' in front of the id! E.g. hdb:10000
mobs
:
  ZOMBIE
:
    material
: ZOMBIE_SPAWN_EGG
    price
: 100
  SKELETON
:
    material
: SKELETON_SPAWN_EGG
    price
: 100
  CREEPER
:
    material
: CREEPER_SPAWN_EGG
    price
: 150
  COW
:
    material
: COW_SPAWN_EGG
    price
: 50
  PIG
:
    material
: PIG_SPAWN_EGG
    price
: 50
  CHICKEN
:
    material
: CHICKEN_SPAWN_EGG
    price
: 50
  SHEEP
:
    material
: SHEEP_SPAWN_EGG
    price
: 50
supported plugins.png

Supported plugins:

help.png

Experiencing issues? Want to request a feature? Check out the SuperHoppers WIKI or join me on Discord!
I will try my best to solve your problem as fast as possible!

API:
Code (Text):

<repository>
            <id>jitpack.io</id>
            <url>https://jitpack.io</url>
</repository>
 
Code (Text):

<dependency>
        <groupId>com.github.Bestem0r</groupId>
        <artifactId>SuperHoppersAPI</artifactId>
        <version>1.2.0</version>
</dependency>
Code (Text):
Get the hopper manager:
SuperHoppersAPI#getHopperManager()

Events:
SuperHopperBreakEvent
SuperHopperPlaceEvent
 


Note: This plugin collectes
anonymous data using bStats



Enjoying SuperHoppers? Leave a review!
Resource Information
Author:
----------
Total Downloads: 80
First Release: Nov 20, 2021
Last Update: Nov 15, 2024
Category: ---------------
All-Time Rating:
5 ratings
Find more info at vebjorn-elvekrok.gitbook.io...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings