Storage

Optimized virtual storage system for Minecraft servers.

Supports Minecraft 1.8.x - 1.21.11.

Overview

Storage is a complete virtual storage system that helps players manage mined resources on your server. With features like autoPickup, resource transfer between players, events, and custom enchants, Storage offers an engaging and efficient way to process and manage resources.

Important note

This is a completely rewritten version of the original Storage source code, with new features and improved performance, and with the original author's permission to distribute the resources.

Original plugin: https://www.spigotmc.org/resources/storage.100516/

Main features

Virtual Storage System - Automatically store mined blocks into a virtual storage.
Conversion System - Convert materials between forms (ingots <-> blocks) with configurable rates.
Resource Transfer System - Transfer resources to other players, single or multiple items at once.
Event System - Join events: mining contest, double drop, community event.
MythicMobs Storage - Automatically store MythicMobs drops in a virtual storage.
Custom Enchants - Built-in enchants: TNT, Haste, Multiplier, Vein Miner.
Special Materials - Custom items with configurable drop rates when mining blocks.
Crafting System - Extremely convenient crafting system.
API Support - Developer API.
Folia Support - Can run on Folia servers.

Virtual Storage System

Auto collect blocks when mined.
Unlimited storage capacity (configurable via config.yml).
Enable/disable auto pickup.

MythicMobs Storage

Auto collect MythicMobs items when killing mobs.
Configure allowed items in mythicstorage.yml.
Enable/disable auto pickup.
Works with many MythicMobs versions (4.x, 5.x, and newer).

Resource Transfer System

Transfer resources to online players.
Two modes: single transfer and multi-transfer.
Transfer history tracking.

Event System

Mining Contest - Compete with other players to mine the most blocks.
Double Drop - Double resources during event time.
Community Event - Work together to complete the server goal.

Custom Enchants

TNT - Explodes when mining with configurable radius.
Haste - Increase mining speed.
Multiplier - Gain more resources when mining.
Vein Miner - Mine the entire ore vein at once.

Crafting System

Open crafting menu with /storage craft.
Craft custom recipes by using materials stored in Storage.
Recipes can also require MythicMobs items (if MythicStorage is enabled).

Commands

/storage - Open the main storage GUI
/storage help - Show command list
/storage toggle - Enable/disable auto pickup
/storage groundstore - Toggle ground-store mode
/storage convert - Open the resource conversion GUI
/storage craft - Open crafting menu
/storage transfer <player> <material> - Transfer specific resource
/storage transfer multi <player> - Transfer multiple resources
/storage transfer log [player] [page] - View resource transfer history
/storage event list - List all active events
/storage event start <event> - Start a specific event
/storage event stop <event> - Stop a specific event
/storage reload - Reload plugin files
/storage max <player> <amount> - Set maximum storage for a player
/storage view <player> - View storage player
/storage add <material;data> <player> <amount> - Add item to player's storage
/storage remove <material;data> <player> <amount> - Remove item from player's storage
/storage set <material;data> <player> <amount> - Set item amount for a player
/storage reset <material|all> [player] - Reset items in player's storage
/storage autosave - Show auto-save system status
/storage save - Save all player data
/storage enchant give <player> <enchant> <level> - Give enchant to item in hand
/storage enchant remove <player> <enchant> - Remove enchant from item in hand
/storage enchant list [player] - List available enchants or enchants of the item in hand
/storage enchant info <enchant> - Show detailed info about an enchant
/storage enchant setmaxlevel <enchant> <level> - Set maximum level for an enchant
/storage specialmaterial list - List special materials
/storage specialmaterial info <material> - Show detailed info about a special material
/storage specialmaterial give <player> <material> <amount> - Give special material to a player
/storage crafteditor - Open recipe editor (admin)
/storage crafteditor import - Import held item to new recipe (admin)

/mythicstorage - Open MythicStorage GUI
/mythicstorage toggle - Toggle MythicMobs auto-pickup
/mythicstorage view <player> - View player MythicStorage
/mythicstorage transfer <player> <item> - Transfer MythicMobs items (GUI)
/mythicstorage transfer multi <player> - Transfer multiple MythicMobs items
/mythicstorage transfer log [page] - View transfer history
/mythicstorage add/remove/set/reset/reload - Admin commands
/mythicstorage groundstore - Toggle MythicStorage ground-store mode

Permissions

storage.toggle - Toggle auto pickup
storage.convert - Use resource conversion feature
storage.transfer.use - Use basic resource transfer
storage.transfer.multi - Use multi-resource transfer
storage.transfer.log - View your own resource transfer history
storage.transfer.log.others - View other players' transfer history
storage.transfer.admin - Bypass transfer cooldown and limits
storage.event.view - View event status
storage.groundstore - Toggle Storage ground-store
storage.event.admin - Manage server events
storage.enchant.use - Use items with enchants
storage.admin.enchant - Manage custom enchants
storage.admin - General admin permission
storage.admin.add - Add items to player's storage
storage.admin.remove - Remove items from player's storage
storage.admin.set - Set item amount for a player
storage.admin.max - Set max storage for a player
storage.admin.reload - Reload plugin config
storage.admin.reset - Reset player's storage resources
storage.admin.specialmaterial - Manage special materials
storage.view - View other player's storage
storage.craft.use - Use crafting feature
storage.craft.admin - Admin commands for crafting system
storage.mythicstorage.groundstore - Toggle MythicStorage ground-store
storage.mythicstorage.use - Use MythicMobs storage feature
storage.mythicstorage.toggle -  Toggle MythicMobs auto-pickup
storage.mythicstorage.view - View other players' MythicMobs storage
storage.mythicstorage.admin - Admin commands for MythicMobs storage
storage.mythicstorage.transfer - Transfer MythicMobs items to other players
storage.mythicstorage.transfer.multi - Transfer multiple MythicMobs items at once
storage.mythicstorage.transfer.log - View own MythicMobs transfer logs
storage.mythicstorage.transfer.log.others - View other players MythicMobs transfer logs

Placeholders

%storage_storage_<MATERIAL>% - Display resource amount in storage
%storage_storage_<MATERIAL>_formatted% - Display formatted resource amount
%storage_storage_<MATERIAL>_percentage% - Display resource percentage vs max storage
%storage_max_storage% - Display max storage limit
%storage_percentage% - Display total storage percentage used
%storage_price_<MATERIAL>% - Display resource sell price
%storage_status% - Display auto pickup status (On/Off)
%storage_page_storage_current% - Current page in Storage GUI
%storage_page_storage_total% - Total pages in Storage GUI
%storage_page_mythic_current% - Current page in MythicStorage GUI
%storage_page_mythic_total% - Total pages in MythicStorage GUI
%storage_total_materials% - Number of different materials stored
%storage_total_blocks% - Total blocks in storage
%storage_total_blocks_formatted% - Total blocks formatted
%storage_available_space% - Available storage space
%storage_available_space_formatted% - Available space formatted
%storage_transfer_sent_total% - Total blocks sent via transfer
%storage_transfer_received_total% - Total blocks received
%storage_transfer_count% - Total number of transfers
%storage_top_<material>_<position>_name% - Leaderboard player name for specific material
%storage_top_<material>_<position>_amount% - Leaderboard amount for specific material
%storage_top_all_<position>_name% - Leaderboard player name for total blocks
%storage_top_all_<position>_amount% - Leaderboard amount for total blocks
%storage_event_active% - Check if any event is active
%storage_event_active_<event_type>% - Check if a specific event type is active
%storage_event_name% - Current active event name
%storage_event_type% - Current active event type
%storage_event_remaining_time% - Remaining time in the current event
%storage_event_remaining_seconds% - Remaining time in seconds
%storage_event_duration% - Total event duration in seconds
%storage_event_start_time% - Event start timestamp (milliseconds)
%storage_event_start_time_formatted% - Formatted event start time
%storage_event_start_date% - Event start date
%storage_event_start_datetime% - Event start date and time
%storage_event_next_time% - Time until next event
%storage_event_next_seconds% - Seconds until next event
%storage_event_next_<event_type>_time% - Time until next specific event type
%storage_event_next_<event_type>_seconds% - Seconds until next specific event type
%storage_event_next_<event_type>_datetime% - Full date and time of next specific event
%storage_event_next_<event_type>_date% - Date of next specific event
%storage_event_next_<event_type>_schedule_info% - Scheduled info for the event
%storage_mining_contest_rank% - Player's current rank in mining contest
%storage_mining_contest_score% - Player's current score
%storage_mining_contest_participants% - Number of participants
%storage_mining_contest_top_<position>_name% - Player name at specific rank
%storage_mining_contest_top_<position>_score% - Player score at specific rank
%storage_community_progress% - Progress of the Community Event
%storage_community_goal% - Goal of the Community Event
%storage_community_percentage% - Progress percentage
%storage_community_participants% - Number of participants
%storage_community_player_contribution% - Player's contribution
%storage_double_drop_multiplier% - Current multiplier in Double Drop event
%storage_double_drop_player_blocks% - Number of blocks mined by the player

%storagecraft_total_recipes% - Total number of recipes
%storagecraft_enabled_recipes% - Total enabled recipes
%storagecraft_available_recipes% - Recipes available for player (permission-checked)
%storagecraft_craftable_recipes% - Recipes the player can craft (has materials)
%storagecraft_is_crafting% - Whether player is currently crafting
%storagecraft_recipe_<recipeId>_exists% - Check if recipe exists
%storagecraft_recipe_<recipeId>_enabled% - Check if recipe is enabled
%storagecraft_recipe_<recipeId>_can_craft% - Check if player can craft recipe
%storagecraft_recipe_<recipeId>_max_amount% - Max craftable amount for recipe
%storagecraft_recipe_<recipeId>_name% - Display name of recipe

%storage_mythic_<item>% - Display name of specific MythicMobs item
%storage_mythic_<item>_amount% - Amount of specific MythicMobs item
%storage_mythic_<item>_amount_formatted% - Formatted amount
%storage_mythic_total_items% - Total number of unique items stored
%storage_mythic_total_amount% - Total amount of all items combined
%storage_mythic_total_amount_formatted% - Total amount formatted
%storage_mythic_max_storage% - Maximum MythicStorage capacity
%storage_mythic_percentage% - MythicStorage percentage used
%storage_mythic_available_space% - Available MythicStorage space
%storage_mythic_autopickup_status% - Auto-pickup status (Enabled/Disabled)
%storage_mythic_transfer_sent_total% - Total items sent to other players
%storage_mythic_transfer_received_total% - Total items received from others
%storage_mythic_transfer_count% - Total number of transfers
%storage_mythic_top_<item>_<position>_name% - MythicStorage leaderboard player name
%storage_mythic_top_<item>_<position>_amount% - MythicStorage leaderboard amount

Installation

Download Storage.jar.
Put it into your server plugins folder.
Restart the server.
Configure the plugin in the generated config files.

Soft dependencies

PlaceholderAPI (for placeholder support)
WorldGuard (for region protection)
MythicMobs (for MythicMobs storage feature)

Why choose Storage?

Performance optimized.
Fully configurable.
Multi-version support.
Active development.
Developer friendly.

Support & links

GitHub: https://github.com/hongminh54/Storage
Bug reports & suggestions: https://github.com/hongminh54/Storage/issues
Wiki & documentation: Available on GitHub
Developer API: Full JavaDoc

Special thanks

VoChiDanh - Author of the original plugin
Community - Feedback and suggestions

Storage V3