ItemVault
ItemVault is a virtual item storage plugin for Minecraft that allows players to store their items in a database and withdraw them whenever they need them.

The system displays stored items in a category-based GUI. Each item appears with its original icon and shows the amount currently stored. It is ideal for survival, economy, RPG, SkyBlock, BoxPvP, and resource-heavy servers.

Features

• Per-player virtual item storage.
  
  
• Category-based GUI.
  
  
• Item search system.
  
  
• Support for vanilla and custom items.
  
  
• Stores items with names, lore, enchantments, and metadata.
  
  
• Auto-save item system.
  
  
• Ignored slot system.
  
  
• Console administrative commands.
  
  
• Safe withdrawal: if the player inventory is full, remaining items are not lost.
  
  
• PlaceholderAPI support.
  
  
• SQLite database.
  
  
• Support for Paper, Purpur, and compatible forks.
  

Compatibility
ItemVault is designed for Paper/Purpur servers.

Supported versions:

• Minecraft 1.20.1
  
  
• Minecraft 1.21.x
  
  
• Java 21
  
  
• Paper / Purpur
  

Optional dependency:

• PlaceholderAPI
  

Main Commands
/storage

Opens the virtual storage.

/storage save

Stores the item currently in your hand.

/storage saveall

Stores all possible items from your inventory.

/storage withdraw <material> <amount>

Withdraws a specific amount of a material.

/storage search <text>

Searches stored items by name, material, or text.

/storage ignore

Toggles the selected hotbar slot as ignored. Items in that slot will not be stored with /storage saveall.

/storage autosave

Toggles auto-save for the selected item.

/storage messages

Toggles auto-save messages.

Spanish Commands
The plugin also includes Spanish command aliases:

/almacen
/almacen guardar
/almacen guardarall
/almacen retirar <material> <cantidad>
/almacen buscar <texto>
/almacen ignorar
/almacen autoguardar
/almacen mensajes

Administrative Commands
/storage admin give <player> <material> <amount>
/storage admin take <player> <material> <amount>
/storage admin set <player> <material> <amount>

These commands can be executed from the console and allow administrators to add, remove, or set item amounts in a player's virtual storage.

Aliases
/itemvault
/ivault
/almacen
/deposito
/storage

PlaceholderAPI
ItemVault includes PlaceholderAPI support.

%itemvault_item_<MATERIAL>%

Shows the stored amount of a material.

Examples:

%itemvault_item_DIAMOND%
%itemvault_item_IRON_INGOT%
%itemvault_item_TORCH%
%itemvault_item_COBBLED_DEEPSLATE%

Other placeholders:

%itemvault_total_items%
%itemvault_total_types%
%itemvault_is_empty%
%itemvault_has_<MATERIAL>%

Scoreboard example:

- '&bDiamonds: &f%itemvault_item_DIAMOND%'
- '&7Torches: &f%itemvault_item_TORCH%'
- '&aTotal stored: &f%itemvault_total_items%'

GUI Categories
The menu is organized into categories to make item management easier:

• All
  
  
• Minerals
  
  
• Blocks
  
  
• Wood
  
  
• Food
  
  
• Tools and weapons
  
  
• Armor
  
  
• Farming
  
  
• Redstone
  
  
• Mob drops
  
  
• Decoration
  
  
• Potions
  
  
• Others
  

Item Search
The search system allows players to find stored items easily.

Examples:

/storage search diamond
/storage search iron
/storage search torch
/storage search pickaxe
/storage search sword
/storage search food

Spanish searches are also supported:

/almacen buscar diamante
/almacen buscar hierro
/almacen buscar antorcha
/almacen buscar pico
/almacen buscar espada

The search system also ignores accents, for example:

carbon
carbón
pocion
poción

Safe Withdrawal
If a player tries to withdraw more items than their inventory can hold, ItemVault will only give the amount that fits. The remaining items will stay safely stored in the virtual storage.

This prevents accidental item loss.

Auto-Save
Players can enable auto-save for a selected item using:

/storage autosave

When the player picks up that item from the ground, it will be automatically sent to their virtual storage.

Ignored Slots
Players can protect a selected hotbar slot using:

/storage ignore

Anything placed in that slot will not be stored automatically with /storage saveall.

This is useful for protecting tools, weapons, food, totems, or other important items.

Dependencies
Optional dependency:

PlaceholderAPI

Database
ItemVault uses SQLite automatically.

The database is saved in:

plugins/ItemVault/itemvault.db

Ideal For

• Survival servers
  
  
• Economy servers
  
  
• RPG servers
  
  
• Java + Bedrock servers
  
  
• Resource-heavy servers
  
  
• Reward systems
  
  
• Scoreboards and holograms with PlaceholderAPI
  
  
• Events where items need to be deducted from a player through console commands