TheStorage v1.1.1

Meet TheStorage — a Premium system with upgradable Ender Chest pages, physical backpack items, virtual backpack slots, and full GUI control over unlocks and layout.


▪ Upgradable Ender Chest Pages:
Up to 9 configurable pages (default 3 unlocked), 45 slots per page, per-page unlock costs, and optional permission gates.

▪ Physical Backpack Items:
Tiered backpacks (Small → Mega) with custom names, lore, slot sizes, and Base64 player-head textures. Right-click to open on the go.

▪ Virtual Backpack Slots:
Main menu slots to equip/store backpacks safely — unlock more slots with economy and/or permissions (up to 18 slots).

▪ Multi-Page Backpacks:
Large tiers (e.g. 90 slots) automatically use pagination with sort and page navigation in the portable layout.

▪ Override Vanilla Ender Chest:
Right-clicking an Ender Chest opens TheStorage instead — plays chest animation and respects enderchest-open-mode (MENU or direct PAGE_1).

▪ EC Page Icon Selector:
Players can choose a custom display icon for each unlocked Ender Chest page from a built-in selector GUI.

▪ Sort Items:
One-click sort inside Ender Chest pages and backpack inventories.

▪ Storage Protection:
- Prevent backpacks inside other backpacks (prevent-nesting)
- Prevent backpacks inside Ender Chest pages (prevent-backpacks)

▪ Upgradable GUIs:
Main menu, EC pages, backpack menu, icon selector, and portable backpack layouts — fillers, sounds, textures, and console open/close commands.

▪ Vault Economy:
Unlock EC pages and backpack slots using server currency (costs in config.yml & backpacks.yml). Economy and permission requirements can be toggled independently.

▪ Flexible Storage:
YAML, MySQL, or SQLite with async operations and auto-save.

▪ Performance Focused:
Lightweight design with batch-friendly SQL and efficient inventory handling.

▪ Fully Configurable:
Page costs, backpack tiers, GUI layouts, sounds, messages, unlock rules, and number formatting.




Player Commands
➤ /thestorage or /thestorage open — Opens the main Storage GUI.
▪ Permission: thestorage.use
➤ /thestorage help — Shows the help menu.
▪ Permission: thestorage.use

Admin Commands
➤ /thestorage forceopen <player> — Forces a player to open their Storage menu.
▪ Permission: thestorage.admin
➤ /thestorage give ec <player> <pages> — Grants additional Ender Chest pages to a player.
▪ Permission: thestorage.admin
➤ /thestorage give backpack <player> <tier> — Gives a backpack item (e.g. small, medium, large, greater, jumbo, mega).
▪ Permission: thestorage.admin
➤ /thestorage reload — Reloads all configuration files.
▪ Permission: thestorage.admin


▪ thestorage.use — Open Storage GUI and help command.
▪ thestorage.admin — reload, forceopen, give commands.
▪ thestorage.unlock.ec.<page> — Unlock a specific Ender Chest page (when permission unlocking is enabled).
▪ thestorage.unlock.bp.<slot> — Unlock a specific virtual backpack slot (when permission unlocking is enabled).




▪ %thestorage_ec_pages_unlocked% — Number of Ender Chest pages unlocked.
▪ %thestorage_backpack_slots_unlocked% — Number of virtual backpack slots unlocked.
▪ %thestorage_total_used_slots% — Total used slots across all EC pages.
▪ %thestorage_used_slots_<page_num>% — Used slots on a specific EC page (e.g. %thestorage_used_slots_1%).
▪ %thestorage_has_backpack_<slot>% — Whether a backpack is equipped in slot (true/false).
▪ %thestorage_backpack_tier_<slot>% — Tier ID of backpack in slot (or None).