HomeJavaModsCustomSacks
CustomSacks
CustomSacks (v3.0)

Introduction:

CustomSacks provides an easy and simple way to collect mass amounts of materials by collecting dropped items and instantly inserting them into a sack. Any created sack is fully configurable and can collect any items as you wish. This plugin suites an server that requires players to have extra inventory storage when collecting items.

Features:

Previews:

Example crafting recipe for a mining sack. Setting crafting recipes are optional for sacks.

[​IMG]

Sack GUI.

[​IMG]

Sack preview shown in the item lore.

[​IMG]

Items being picked up and inserted into a farming sack.

[​IMG]

Items being withdrawn from the farming sack.

[​IMG]
Spoiler: Default Plugin Configuration
Code (YAML):
# CustomSacks Configuration
# Version: 3.0

# The configuration can be reloaded with /customsacksreload or /customsacksrl from in game or console.

################
# Player Sacks #
################

# The default sacks are only examples and you can add or remove any sack that you want.
# Each section under 'player-sacks' is an individual sack that can be obtained through crafting or commands.
# Different types of sacks can carry the same material. Whichever sack appears first in the inventory has priority.
# If sack data is changed with it already existing in game, the sack will update its data the next time it is used.
# Proceed with caution when removing items that can be accepted by the sack, as it may remove all of the specific material from existing sacks in game.
# Any defined materials for configuration values here can be found at: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html

# The 'display-item' is the real item that will be used as the sack.
# This can be any existing material.

# The 'display-name' is the sack display name.
# Color codes are applicable for this.

# The 'recipe' is the in game crafting recipe for the sack.
# Each letter represents a slot as shown here:
#
# ABC
# DEF
# GHI
#
# Recipes can include any existing material.
# Blank spaces represent 'AIR' or nothing. (Do not use 'AIR' as a material)
# If all spaces are empty, then the sack will not be craftable at all and can only be obtained with the command: /spawnsack <sack name>

# The 'items' section specifies what materials can be picked up by the sack.
# These items must be existing materials.

# Each item can be given a limit, which will be the maximum amount that the sack can hold of that specific item.
# To remove the limit, set the limit to 0.

# Each item can be assigned a color, which will color the display name of item in the sack and color of the name in the sack preview (if enabled).
# Any defined colors for configuration values here can be found at: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/ChatColor.html
# If you are not willing to add any custom colors, then it is recommended that you leave all colors set to the default: 'WHITE'

player-sacks
:
   mining
:
      display-item
: 'CAULDRON'
      display-name
: '&b&lMining Sack'
      recipe
:
         A
: 'LEATHER'
         B
: 'CHEST'
         C
: 'LEATHER'
         D
: 'LEATHER'
         E
: 'NETHERITE_PICKAXE'
         F
: 'LEATHER'
         G
: 'LEATHER'
         H
: 'CHEST'
         I
: 'LEATHER'
      items
:
         COBBLESTONE
:
            limit
: 800
            color
: 'GRAY'
         COBBLED_DEEPSLATE
:
            limit
: 800
            color
: 'DARK_GRAY'
         COAL
:
            limit
: 300
            color
: 'DARK_GRAY'
         RAW_COPPER
:
            limit
: 300
            color
: 'YELLOW'
         RAW_IRON
:
            limit
: 300
            color
: 'WHITE'
         RAW_GOLD
:
            limit
: 300
            color
: 'GOLD'
         LAPIS_LAZULI
:
            limit
: 600
            color
: 'BLUE'
         REDSTONE
:
            limit
: 600
            color
: 'RED'
         DIAMOND
:
            limit
: 100
            color
: 'AQUA'
         EMERALD
:
            limit
: 100
            color
: 'GREEN'
         QUARTZ
:
            limit
: 300
            color
: 'WHITE'
         ANCIENT_DEBRIS
:
            limit
: 100
            color
: 'DARK_GRAY'
   farming
:
      display-item
: 'COMPOSTER'
      display-name
: '&a&lFarming Sack'
      recipe
:
         A
: 'LEATHER'
         B
: 'CHEST'
         C
: 'LEATHER'
         D
: 'LEATHER'
         E
: 'NETHERITE_HOE'
         F
: 'LEATHER'
         G
: 'LEATHER'
         H
: 'CHEST'
         I
: 'LEATHER'
      items
:
         WHEAT_SEEDS
:
            limit
: 800
            color
: 'YELLOW'
         WHEAT
:
            limit
: 500
            color
: 'YELLOW'
         BEETROOT_SEEDS
:
            limit
: 800
            color
: 'RED'
         BEETROOT
:
            limit
: 500
            color
: 'RED'
         CARROT
:
            limit
: 500
            color
: 'GOLD'
         POTATO
:
            limit
: 500
            color
: 'YELLOW'
         POISONOUS_POTATO
:
            limit
: 100
            color
: 'YELLOW'
         MELON
:
            limit
: 500
            color
: 'GREEN'
         MELON_SLICE
:
            limit
: 1200
            color
: 'GREEN'
         PUMPKIN
:
            limit
: 500
            color
: 'GOLD'
         COCOA_BEANS
:
            limit
: 500
            color
: 'RED'
         BAMBOO
:
            limit
: 300
            color
: 'GREEN'
         SUGAR_CANE
:
            limit
: 300
            color
: 'GREEN'
         CACTUS
:
            limit
: 300
            color
: 'GREEN'
         NETHER_WART
:
            limit
: 500
            color
: 'RED'
   woodcutting
:
      display-item
: 'CHEST'
      display-name
: '&e&lWoodcutting Sack'
      recipe
:
         A
: 'LEATHER'
         B
: 'CHEST'
         C
: 'LEATHER'
         D
: 'LEATHER'
         E
: 'NETHERITE_AXE'
         F
: 'LEATHER'
         G
: 'LEATHER'
         H
: 'CHEST'
         I
: 'LEATHER'
      items
:
         OAK_LOG
:
            limit
: 500
            color
: 'YELLOW'
         SPRUCE_LOG
:
            limit
: 500
            color
: 'YELLOW'
         BIRCH_LOG
:
            limit
: 500
            color
: 'YELLOW'
         JUNGLE_LOG
:
            limit
: 500
            color
: 'YELLOW'
         ACACIA_LOG
:
            limit
: 500
            color
: 'YELLOW'
         DARK_OAK_LOG
:
            limit
: 500
            color
: 'YELLOW'
         MANGROVE_LOG
:
            limit
: 500
            color
: 'YELLOW'
         CHERRY_LOG
:
            limit
: 500
            color
: 'YELLOW'
         PALE_OAK_LOG
:
            limit
: 500
            color
: 'YELLOW'
         OAK_SAPLING
:
            limit
: 100
            color
: 'GREEN'
         SPRUCE_SAPLING
:
            limit
: 100
            color
: 'GREEN'
         BIRCH_SAPLING
:
            limit
: 100
            color
: 'GREEN'
         JUNGLE_SAPLING
:
            limit
: 100
            color
: 'GREEN'
         ACACIA_SAPLING
:
            limit
: 100
            color
: 'GREEN'
         DARK_OAK_SAPLING
:
            limit
: 100
            color
: 'GREEN'
         MANGROVE_PROPAGULE
:
            limit
: 100
            color
: 'GREEN'
         CHERRY_SAPLING
:
            limit
: 100
            color
: 'GREEN'
         PALE_OAK_SAPLING
:
            limit
: 100
            color
: 'GREEN'
   excavation
:
      display-item
: 'BARREL'
      display-name
: '&7&lExcavation Sack'
      recipe
:
         A
: 'LEATHER'
         B
: 'CHEST'
         C
: 'LEATHER'
         D
: 'LEATHER'
         E
: 'NETHERITE_SHOVEL'
         F
: 'LEATHER'
         G
: 'LEATHER'
         H
: 'CHEST'
         I
: 'LEATHER'
      items
:
         GRASS_BLOCK
:
            limit
: 600
            color
: 'GREEN'
         DIRT
:
            limit
: 1200
            color
: 'GREEN'
         COARSE_DIRT
:
            limit
: 600
            color
: 'GREEN'
         PODZOL
:
            limit
: 600
            color
: 'GREEN'
         MYCELIUM
:
            limit
: 600
            color
: 'GREEN'
         SAND
:
            limit
: 800
            color
: 'YELLOW'
         RED_SAND
:
            limit
: 800
            color
: 'YELLOW'
         SNOW_BLOCK
:
            limit
: 800
            color
: 'WHITE'
         SNOWBALL
:
            limit
: 800
            color
: 'WHITE'
         GRAVEL
:
            limit
: 600
            color
: 'GRAY'
         SOUL_SAND
:
            limit
: 800
            color
: 'RED'
         SOUL_SOIL
:
            limit
: 800
            color
: 'RED'
   mob
:
      display-item
: 'ENDER_CHEST'
      display-name
: '&c&lMob Sack'
      recipe
:
         A
: 'LEATHER'
         B
: 'CHEST'
         C
: 'LEATHER'
         D
: 'LEATHER'
         E
: 'NETHERITE_SWORD'
         F
: 'LEATHER'
         G
: 'LEATHER'
         H
: 'CHEST'
         I
: 'LEATHER'
      items
:
         ROTTEN_FLESH
:
            limit
: 500
            color
: 'YELLOW'
         BONE
:
            limit
: 500
            color
: 'WHITE'
         ARROW
:
            limit
: 500
            color
: 'WHITE'
         GUNPOWDER
:
            limit
: 500
            color
: 'DARK_GRAY'
         STRING
:
            limit
: 500
            color
: 'WHITE'
         SPIDER_EYE
:
            limit
: 500
            color
: 'RED'
         ENDER_PEARL
:
            limit
: 300
            color
: 'BLUE'
         SLIME_BALL
:
            limit
: 300
            color
: 'GREEN'
         BLAZE_ROD
:
            limit
: 300
            color
: 'GOLD'
         GOLD_NUGGET
:
            limit
: 300
            color
: 'GOLD'
         GHAST_TEAR
:
            limit
: 100
            color
: 'WHITE'
         MAGMA_CREAM
:
            limit
: 300
            color
: 'GOLD'
         RABBIT
:
            limit
: 200
            color
: 'LIGHT_PURPLE'
         CHICKEN
:
            limit
: 200
            color
: 'LIGHT_PURPLE'
         PORKCHOP
:
            limit
: 200
            color
: 'LIGHT_PURPLE'
         BEEF
:
            limit
: 200
            color
: 'LIGHT_PURPLE'
         MUTTON
:
            limit
: 200
            color
: 'LIGHT_PURPLE'
         RABBIT_HIDE
:
            limit
: 200
            color
: 'WHITE'
         FEATHER
:
            limit
: 200
            color
: 'WHITE'
         LEATHER
:
            limit
: 200
            color
: 'RED'
         WHITE_WOOL
:
            limit
: 200
            color
: 'WHITE'
         INK_SAC
:
            limit
: 200
            color
: 'DARK_GRAY'

#################
# Sack Previews #
#################

# When enabled, sack previews are displayed in the lore of the item.
# Sack previews will contain each sack item and have it shown in its color.
# Any existing sacks will be updated on their next use.

sack-previews
: true

#################
# Sack Messages #
#################

# When the values are not empty, a message will be displayed in chat and/or the action bar when a sack collects/withdraws items.
# Leaving any value empty will disable the message completely.
# Color codes are applicable here.
# Available placeholders are shown here:
#
# %item% - The item that was picked up.
# %amountChanged% - How much of the item will be inserted into the sack.
# %newAmount% - New sack total of the item.
# %limit% - Sack limit of the item.

sack-pickup-messages
:
   chat
: ''
   action-bar
: '&a %item%: +%amountChanged% (%newAmount%/%limit%)'

sack-withdrawal-messages
:
   chat
: ''
   action-bar
: '&c %item%: -%amountChanged% (%newAmount%/%limit%)'

###############
# Sack Sounds #
###############

# When the values are not empty, a sound will be played when a sack collects/withdraws items.
# Leaving any 'type' value empty will disable the sound completely.
# The 'pitch' will be the pitch of the sound on a scale from 0-2. (Decimals are accepted)
# If 'type' is empty, then you can disregard the value of 'pitch' completely.
# Any defined sounds for configuration values here can be found at: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html

sack-pickup-sound
:
   type
: 'ENTITY_EXPERIENCE_ORB_PICKUP'
   pitch
: 2.0

sack-withdrawal-sound
:
   type
: 'ENTITY_ENDER_DRAGON_FLAP'
   pitch
: 2.0

Commands

Plugin details

Read from the plugin's own plugin.yml.

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

CustomSacks is a free Minecraft Java mod. Compatible with Minecraft 1.19, 1.20, 1.20.6, 1.21. Downloaded 436 times (via Spigot). Download it and open it directly in the game.

Explore more