️ VaultsAndTanks
The Ultimate Storage & Fluid Solution for Minecraft 1.21+

VaultsAndTanks revolutionizes server storage by introducing high-capacity multi-block item Vaults and visual liquid Tanks. Packed with automation, sorting, and a robust security system, it is designed to seamlessly integrate into survival and technical gameplay.

Installation

1. Download: Place VaultsAndTanks.jar into your server's plugins folder.
   
   
2. Restart: Restart your server to generate default files.
   
   
3. Configure: Edit config.yml and multiblocks.yml to customize capacities and recipes.
   
   
4. Localization: Set your preferred language (default is English):
   
   /vat setlanguage en_us
   # Or for Portuguese: /vat setlanguage pt_br

Core Features
1. Vaults (Item Storage)
Vaults are high-capacity, multi-block storage units designed to replace messy chest rooms.

• Construction:
  • Craft a Vault Core using the custom recipe (Default: Copper, Chests, Barrels).
    
    
  • Place Vault blocks in a solid cube formation (e.g., 2x2x2, 3x3x3).
    
    
  • Note: Valid dimensions are configurable in config.yml.
• Interface Features:
  • Search: Click the Spyglass and type in chat to filter items.
    
    
  • Sorting: Sort instantly by Name (A-Z) or Quantity.
    
    
  • Pagination: Navigate massive inventories with arrow buttons.

2. Tanks (Liquid Storage)
Store fluids in massive quantities with visual feedback.

• Capacity: Liquids are stored in milibuckets (mB). 1 Bucket = 1000 mB.
  
  
• Visuals: Tanks dynamically render the liquid level inside the block.
  
  
• Interaction:
  • Right-Click: Fill/Empty a single bucket or bottle.
    
    
  • Shift + Right-Click: Fill/Empty all matching containers in your inventory.
• Supported Fluids: Water, Lava, Milk, XP, Potions, Honey.

⚡ Automation Systems
Collectors (Wireless Gathering)
Turn your storage into a vacuum for drops.

1. Craft a Collector (Custom Lightning Rod).
   
   
2. Place it directly onto a Vault or Tank.
   
   
3. Effect: Automatically pulls items (for Vaults) or XP Orbs (for Tanks) within a 5-block radius.
   • Visual indicator included.

XP Management
Store and utilize experience points efficiently.

• XP Drain: Place the custom Pressure Plate on top of a Tank. Stand on it to drain your XP bar into the tank.
  
  
• XP Tap: Place a Lever on an XP-filled Tank. Flick it to dispense XP bottles or summon XP orbs.

Vault-Tank Linking
Connect storage units to automate fluid container handling.

1. Place a Vault and a Tank directly next to each other.
   
   
2. Shift + Right-Click the Vault with an empty hand.
   
   
3. Select a Mode:
   • Input Liquid: Tank pulls empty buckets from Vault, fills them, and returns them.
     
     
   • Output Liquid: Tank drains filled buckets from Vault and returns empty ones.

Hopper Filters
Advanced filtering for item transport.

1. Shift + Right-Click a Hopper pointing into/out of a Vault.
   
   
2. Configure:
   • Whitelist/Blacklist: Control exactly what passes through.
     
     
   • NBT Mode: Enable "NBT Sensitive" to filter specific data (e.g., Enchanted Books, Potions).

Security & Trust
Protect your resources with a built-in locking system.

The Lock Key

• Crafting: Create a Lock Key using the custom recipe.
  
  
• Usage: Right-Click any Vault, Tank, or supported vanilla block (Doors, Chests) to open the Security GUI.
  
  
• Toggle: Click the lock icon to secure or unsecure the block.

Trust Management
Share access without unlocking everything.

Trust Type

How to Access

Description

Per-Block Trust

Click "Trust System" in the Lock GUI

Grants a player access to only that specific block.

Global Trust

Shift + Right-Click air with a Key

Grants a player access to ALL your locked blocks.

⚙️ Configuration
The config.yml is extensive and allows you to modify:

• Recipes: Custom crafting shapes and ingredients.
  
  
• Storage Limits: Define max capacity for Tanks and Vaults.
  
  
• Aesthetics: Toggle particles and sound effects.
  
  
• Vanilla Integration: Add/Remove lockable vanilla blocks (e.g., Furnaces, Shulkers).

Permissions
Permission Node

Description

Recommended Rank

vaultsAndTanks.command.reload

Access to /vat reload

Admin

vaultsAndTanks.lock.bypass

Open any locked block regardless of owner

Admin / Moderator

vaultsAndTanks.use

Basic usage of the plugin (if configured)

Default