Storage Hub Walkthrough

Storage Hub connects chests that a player has opened into one searchable interface with items, crafting, recipes, shimmer, progression, relays, and Mysterious Chest management.

Registration and indexing

Opening a chest records its world position. This prevents unexplored world-generation chests from becoming remote storage. The item and crafting views build indexes from eligible registered storage and refresh only when relevant state changes, avoiding repeated full scans while browsing large networks.

Transactional crafting

Crafting separates planning from mutation:

1. Determine eligible inventory and storage sources.
2. Resolve recursive intermediate recipes when enabled.
3. Verify stations, liquid/biome unlocks, material counts, and output capacity.
4. Record each native item mutation.
5. Deliver the result or roll the recorded mutations back if delivery fails.

This prevents partial material loss when a recipe changes, storage is full, or another operation invalidates a plan.

Mysterious Chest

The custom chest stores capacities beyond Terraria's fixed 40-slot array in a stable sidecar keyed to the placed chest. Its 40, 80, 200, 1,000, and 5,000-slot levels persist through renaming, saving, reloading, pickup, and replacement. Core's custom-item identity system keeps its item form stable across loads.

Multiplayer and servers

Storage Hub selects a singleplayer, Host & Play/server, or remote-client provider. The server validates requested counts, permissions, chest coordinates, and item types before mutating authoritative storage, then broadcasts the corresponding Terraria chest and inventory updates. Dedicated-server reflection resolves types from the server assembly rather than loading client XNA state.

All peers need Storage Hub because it adds a custom item and network protocol.

Source

See src/StorageHub/ in the TerrariaModder repository.