ChestRestack

A plugin for Spigot servers that allows players to move items into their chests by shift-clicking them.

General

Author: Tonnanto
Current Version: 1.0

Download the plugin and find the Project Page on SpigotMC and Bukkit.

How it works

Shift-click a chest

Its dead simple. Shift-left click on a chest, and all items from your inventory that are already present in the chest will be moved into the chest. You do not have to open the chest, nor your inventory. This makes it straightforward and efficient to unload your inventory after a mining session or any other kind of expedition. Just click on every chest in your storage room, and your inventory will be clutter-free in no time.

Individual Player Preferences

ChestRestack also gives every player the option to adjust their individual preferences to tailor the functionality to suit their needs. To view and configure preferences, use the /cr prefs command. These preferences include the following:

• Should the chest be sorted after restacking?
• Should items from the hotbar be moved?
• Should tools and weapons be moved?
• Should armor be moved?
• Should arrows and rockets be moved?
• Should food items be moved?
• Should potions be moved?
• Should shift-right or shift-left click trigger the functionality?
• Or should the feature be disabled entirely?

Commands

All commands for this plugin start with /chestrestack or its shorter aliases /restack or /cr

• /cr help - Shows a Help Menu that explains the plugin and all commands
• /cr <disable | enable> - Disables or enables the plugin for an individual player
• /cr prefs - Show an interactive chat-menu of the player's preferences
• /cr prefs sorting - Toggle whether chests should be sorted after restacking
• /cr prefs clickmode <shift-left | shift-right> - Choose a click-mode for restacking
• /cr prefs reset - Restore the default preferences
• /cr prefs <tools | armor | arrows | food | potions> - Enable or disable restacking of certain items

Admin Command:

• /cr reload - reloads the plugin and its configuration.

Configuration

# This is the config file for ChestRestack.
# This config was generated for version 1.0

# You can delete this file to regenerate the default config on server reload.


# GENERAL

# Whether the chest will be sorted after moving items
# Disabling this globally will disable it for all players independent of their individual preferences.
# I only recommend disabling this if you use a different plugin for sorting of inventories.
sorting-enabled-global: true

# Whether a sound should be played when items are restacked
restack-sound: true

# Set the locale for the plugin.
# Contact me if you would like to have your language supported. You might need to help with translations.
# Available locales:
# en: English, de: German
locale: en

# Whether new updates should be announced to admins and in the console.
# Updating to the newest version is always recommended unless the new version is not compatible with your server.
check-for-updates: true



# DEFAULT PLAYER PREFERENCES

# Each player can overwrite their own preferences using commands
# These are the default values the preferences will have when they first join or when they reset their preferences

# Whether the chest will be sorted after moving items
# Can be over by sorting-enabled-global
sorting-enabled-default: true

# The click-mode that triggers the restacking action
# shift-left | shift-right
click-mode-default: shift-left

# Whether items from the hotbar should be restacked or ignored by default
move-from-hotbar-default: true

# Whether tools and weapons should be restacked or ignored by default
move-tools-default: false

# Whether armor should be restacked or ignored by default
move-armor-default: true

# Whether arrows and rockets should be restacked or ignored by default
move-arrows-default: true

# Whether food should be restacked or ignored by default
move-food-default: true

# Whether potions should be restacked or ignored by default
move-potions-default: true

License

Copyright (C) 2024, Anton Stamme

ChestRestack is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

ChestRestack is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with ChestRestack. If not, see https://www.gnu.org/licenses/.