Modular Storage System

# Modular Storage System Modular Storage System is a comprehensive Minecraft storage plugin. It provides a multi-tiered network-based storage system with craftable, expandable storage disks and an intuitive terminal interface. The plugin features automation capabilities through importers and exporters, making it perfect for advanced storage and logistics systems. ## Features ### Core Storage System - **Network-Based Storage**: Connect Storage Servers, Drive Bays, and Terminals with Network Cables - **Multi-Tier Storage Disks**: 1k, 4k, 16k, and 64k capacity tiers with hot-swappable functionality - **Advanced Terminals**: Search, sort, and manage your items with persistent per-terminal settings - **Disk Information**: Storage disks display detailed tooltips with capacity, usage, and crafter information - **Disk Recycling**: Dismantle empty disks to recover components (Shift + Right-click) ### Automation & Management - **Automation System**: Import and export items automatically with configurable filters - **Furnace Integration**: Specialized exporter GUI for targeting fuel and input slots separately - **Security Controls**: Manage network access with Security Terminals ### Crafting & Recipes - **Alternative Recipes**: Craft disks using shapeless recipes (Housing + Platter) in 2x2 or 3x3 grids - **Recipe Book Integration**: All recipes can be discovered and visible in the vanilla recipe book ### Performance & Configuration - **Block Marker Cache**: Intelligent caching system reduces database queries with 5-second TTL - **Click Rate Limiting**: GUI interactions are rate-limited to prevent database spam - **Database Backend**: Uses HikariCP connection pooling with SQLite for performance and reliability - **Comprehensive Configuration**: Customizable via config.yml, lang.yml, and recipes.yml files --- ## Quick Setup Tutorial ### Basic Network Setup 1. **Craft a Storage Server** - The central hub of your storage network 2. **Place a Drive Bay** - Adjacent to the Storage Server (holds up to 7 storage disks) 3. **Add a Terminal** - Adjacent to the Storage Server or Drive Bay for item access 4. **Craft Storage Disks** - Start with 1k disks and insert them into the Drive Bay 5. **Start Storing** - Right-click the Terminal to access your network storage ### Network Components - **Storage Server**: Must be present in every network, acts as the controller - **Drive Bay**: Stores your storage disks, can have multiple per network - **Terminal**: Access point to view and manage stored items - **Network Cable**: Extends connections beyond adjacent placement (max 800 cables per network) --- ## Importers and Exporters ### How They Work **Importers** automatically pull items from connected containers (chests, furnaces, etc.) into your storage network. **Exporters** automatically push items from your storage network into connected containers. ### Setup Process 1. **Craft an Importer or Exporter** 2. **Place it adjacent to a container** (chest, furnace, hopper, etc.) 3. **Connect it to your network** using Network Cables 4. **Right-click to configure** filters and enable/disable 5. **Set filters** by dragging items into filter slots (empty = import/export everything) ### Special Container Support - **Furnaces**: Dedicated GUI with separate filter sections for fuel (left) and input material (right) slots - 18 filter slots for fuel items - 18 filter slots for material items - Intelligent slot targeting for automated smelting setups - **Brewing Stands**: Specialized interfaces for ingredient and bottle slots - **All Containers**: Works with chests, barrels, hoppers, dispensers, and more ### Filter Configuration - **Empty Filters**: Import/export all items (no restrictions) - **Item Filters**: Drag items into filter slots to whitelist specific items - **Multiple Filters**: Combine multiple items for complex filtering logic --- ## Terminal Features ### Search Functionality - **Item Search**: Click the spyglass button (bottom left) to search for items - **Type in Chat**: Enter your search term in chat to filter items instantly - **Persistent Search**: Search terms are saved per terminal location - **Clear Search**: Shift + Click the spyglass or search again to clear ### Sorting Options - **Alphabetical Sort**: Default sorting mode, organizes items A-Z - **Quantity Sort**: Click the name tag button to sort by item count (highest first) - **Persistent Settings**: Sort preference is saved per terminal location ### Storage Interaction - **Pagination**: Navigate through pages with previous/next buttons - **Real-Time Updates**: Terminal displays live storage capacity and item counts --- ## Items and Crafting Recipes ### Network Blocks #### Server The core controller of every storage network. ``` NRN N = Netherite Ingot RAR R = Redstone NRN A = Amethyst Shard ``` #### Drive Bay Houses up to 7 removable storage disks. ``` BOB B = Copper Block CCC C = Chest BOB O = Crying Obsidian ``` ####