Astral Storage Network v1.1

# Astral Storage Network

Want to try it first?
You can test Astral Storage Network live on the server IP: spiele.norddeich.city

Astral Storage Network adds a clean shared-storage system for Hytale servers.

Players can link multiple chests to one controller and access the combined storage through a portable terminal. It is designed for shared bases, multiplayer storage rooms, and large storage systems where opening every chest manually becomes annoying.

Items can be inserted through the terminal or directly into linked chests. The network updates and synchronizes automatically, so linked chest contents stay connected to the terminal view.

## Features

• Link multiple chests into one shared storage network
• Access linked storage through a portable terminal
• Craft the controller and terminal at the normal workbench under Tinkering
• Bind terminals to controllers with F or right-click
• Link and unlink chests with the terminal using F or right-click
• Insert items through the terminal or directly into linked chests
• Automatically updates and synchronizes linked chest contents
• Search large storage networks
• Sort items by name or quantity
• Deposit and withdraw items through one terminal interface
• Share network access with other players
• Built-in network management panel
• Per-player network access permissions
• Configurable terminal range
• Configurable linked-chest overlay
• Green overlay helper for linked chests
• Configurable overlay range and maximum shown chests
• Server-side repair command for unusual missing-link cases
• Performance-focused backend for large chest networks
• Safer handling for unsupported item previews to prevent client UI crashes

## Commands

Admin commands require the networkchests.admin permission.

• /astralnetwork networks — opens the network panel
• /astralnetwork settings — opens the global settings window
• /astralnetwork repair — repairs missing or stale linked chest data
• /astralnetwork perf — shows debug/performance information

## Permissions

- networkchests.admin — allows access to Astral Storage Network admin commands and global management tools

Normal players do not need this permission to use their own terminals and storage networks.

## How it works

1. Craft the controller and terminal at the normal workbench under Tinkering
2. Place a network controller
3. Bind a terminal to the controller with F or right-click
4. Link chests to the network with the bound terminal using F or right-click
5. Insert items through the terminal or directly into any linked chest
6. Open the terminal to browse, search, sort, deposit, and withdraw items

## Configuration

The mod includes configurable settings for:

• Terminal range enabled/disabled
• Terminal range distance
• Linked chest overlay range
• Maximum linked chest overlays shown at once

These values can be changed from the in-game settings window.

The config file is stored at:

mods/AstralStorage/config.properties

Default values:

• overlay.maxShownChests=100
• overlay.rangeBlocks=20
• terminal.rangeEnabled=false
• terminal.rangeBlocks=64

## Multiplayer

Astral Storage Network is built with multiplayer storage in mind.

Network owners can share access with other players, making it useful for community bases, team storage rooms, and large multiplayer worlds.

Players can be given only the permissions they need, such as terminal access without chest-linking rights.

## Performance

The storage backend was designed for larger networks.

It uses cached network state, per-network storage data, safer terminal refresh behavior, and optimized update handling to reduce unnecessary refreshes and server load.

## Notes

• The controller and terminal can be crafted at the normal workbench under Tinkering
• Items can be added through the terminal or directly through linked chests
• Linked chest contents update and synchronize automatically with the network
• Networks are world-local for predictable behavior
• Terminal range checks are measured from the network controller when enabled
• Linked chest overlays are helper visuals and can be configured
• Unsupported or unsafe item previews may be hidden from the terminal to protect players from client UI crashes
• The repair command is mainly intended for server owners/admins if chests were removed in unusual ways
• The performance command is mainly intended for debugging and server-side troubleshooting

## Support

If you find a bug, please report:
https://discord.gg/3M5cWF7WWk

• server version
• mod version
• what you were doing
• screenshots or logs if possible

Clear reports help issues get fixed much faster.