Advanced Cloud Storage

**Press V to open your personal cross-dimensional cloud warehouse** — store up to 5,400 slots, link containers and recall them from anywhere, capture entities, and craft 3×3 recipes that persist across sessions.

—

### What is Advanced Cloud Storage?

A personal warehouse mod for **NeoForge 1.21.1** that gives every player their own cloud-based inventory. Press V to open it — even across dimensions. Link chests, barrels, shulker boxes, and even entities, then access them from up to **175 blocks away**. Craft persistent 3×3 recipes that survive game restarts, and progress through a 5-level upgrade system to expand storage up to **5,400 slots** and **100 linked containers**.

—

###  Core Features

– **5,400-Slot Personal Warehouse** — Up to 100 pages of 54 slots each, all accessible from a single keybind.
– **Remote Container Access** — Link any chest, barrel, or shulker box and open it from up to 175 blocks away. No more running back to base.
– **Entity Capture & Recall** — Capture mobs, store them in your warehouse, and release or summon them anywhere.
– **Persistent 3×3 Crafting** — Your crafting grid is saved across sessions. Never lose a recipe in progress.
– **5-Level Upgrade System** — Start with 1 page and 5 container slots. Upgrade up to 100 pages and 100 linked containers.
– **Multi-Dimensional Storage** — Your warehouse follows you across dimensions. Same inventory, anywhere.
– **Item Categories & Search** — Organize your warehouse with custom categories. Search within the active category.
– **Drop Pickup** — Sweep nearby dropped items into your warehouse with a single command.

—

###  How to Use

1. **Press V** to open your cloud warehouse.
2. Use the toolbar to **switch categories**, **search**, **sort**, **upgrade**, or **flip pages**.
3. **Link a container**: Aim at any chest / barrel / shulker box and run `/cloud link`.
4. **Open a linked container**: Click its icon in the Containers tab, or run `/cloud openlinked <index>`.
5. **Capture an entity**: Aim at a mob and run `/cloud capture`.
6. **Upgrade your warehouse**: Run `/cloud upgrade` after placing required materials in your inventory.

—

###  Upgrade Levels

| Level | Pages | Linked Containers | Required Materials |
|—|—|—|—|
| Lv1 (default) | 1 | 5 | — |
| Lv2 | 5 | 10 | 64 iron ingots |
| Lv3 | 20 | 20 | 64 diamonds |
| Lv4 | 50 | 50 | 64 emeralds |
| Lv5 (max) | 100 | 100 | 1 nether star |

*(Material requirements are configurable — see Configuration below.)*

—

###  Configuration

All settings live in `config/premiumcloudstorage-common.toml`:

– `warehouse.maxSlots` — Default slot capacity per player
– `warehouse.upgradeMaterials` — Required materials per upgrade level
– `warehouse.maxLinkedContainers` — Container limit per level
– `warehouse.maxLinkedEntities` — Entity slot limit per level
– `warehouse.remoteAccessDistance` — Max distance for remote container access (default 175)

—

###  All Done via GUI — No Commands Needed

Advanced Cloud Storage is designed to be **fully GUI-driven**. There are no chat commands to memorize.

– **Press V** to open your warehouse
– **Aim at a chest/barrel/shulker box** with a Container Connector to link it
– **Aim at a mob** with an Entity Container to capture it
– Click in-GUI buttons to upgrade, rename, sort, search, switch categories, or flip pages
– Grant / revoke player access through the in-GUI permission manager

The only commands the mod registers (`/cloudstorage-perm-allow/deny`, `/cloudstorage-item-accept/deny`) are auto-triggered by chat buttons — they exist only so the click-to-accept flow works.

—

###  Compatibility

– **Minecraft**: 1.21.1
– **Mod Loader**: NeoForge 21.1.x
– **Dependencies**: None (standalone mod)

—

###  Feedback

Found a bug or have a suggestion? Open an issue on this page. Please include `latest.log` and reproduction steps.