Description
π¦ Automatic Storage: Fast & Easy to Use
AutoStorage is a lightweight, efficient, and powerful mod that automatically sorts items between chests. Drop all your expedition resources in one place, and AutoStorage will handle the rest.
π How It Works
- Craft the Automatic Storage Crate at the Workbench, in the Tinkering tab (Tier 2).
- Place it in your base.
- Put items inside. The AutoStorage crate will distribute them to compatible nearby chests.
- Configure it by crouching and pressing Interact (F by default) while looking at the crate.

The crafting recipe can be changed in the configuration file.
β¨ Features
- π¦ Automatically distributes items to nearby chests (including compatible containers added by other mods)
- π§ Smart targeting: items are sent to chests that already contain the same item type
- π§© Two sorting modes: exact item ID or item category
- β±οΈ Server-configurable transfer rate, measured in stacks or individual items
- β‘ Event-driven architecture with bounded safety checks and retries, limiting unnecessary scans
- π§± Intelligent transfers that respect your chest organization: existing stacks are filled before empty slots
- π₯οΈ In-game UI for configuring each crate (Crouch + F)
- ποΈ Per-crate sorting mode
- π§ Per-crate options such as Use other chests if needed and container exclusions
- π Per-crate horizontal and vertical range controls with + and β buttons
- π Live linked-chest count and range visualization
- βοΈ Extensive configuration options for both small and large servers
- π Advanced filtering to control which container block IDs may or may not receive items
- π‘οΈ Built-in safeguards against item duplication, optimized for low CPU usage
- π’ Compatibility with the SimpleClaims mod to help prevent griefing, and other mods like StorageDrawers.
- π Localized UI and item names: AR / BG / CS / DE / EL / EN / ES / PE / ET / FR / IT / NL / PL / PT / RU / SK / SV / TR / UK
(Translations are AI-assisted; corrections are welcome!)
π Complete Your Storage Setup
Automatic Collector is the companion to Automatic Storage. Automatic Storage distributes your deposited items among nearby chests; Automatic Collector lets you browse stored items and withdraw a chosen quantity, one stack, or the maximum your inventory can hold.
When both mods are installed, Automatic Collector can use the exact area of the nearest eligible Automatic Storage crate, subject to server range limits and claim protections. The two mods also work independently.
π Bug Reports & Suggestions
Found a bug, have an idea, or want to request a feature?
- β Best option: Join my Discord and post in the appropriate channel.
π§° Commands
| Command | Description |
|---|---|
/autostorage reload |
Reloads the plugin configuration. Alias: /as reload |
π Permissions
| Feature | Permission | Default |
|---|---|---|
| Use and configure AutoStorage | autostorage.use |
Allowed |
| Craft AutoStorage when permission-based crafting is enabled | autostorage.craft |
Denied |
| Bypass the owner-only configuration restriction | autostorage.config.any |
Denied |
βοΈ Configuration
The UI and configuration examples on this page follow AutoStorage 2.0.0. Choose the file matching your Hytale server version; file availability is listed in the Files tab.
The configuration file is organized into sections.
Every setting can be customized to match your server's needs.
Configuration file: mods/MiniBox_AutoStorage/config.json. Apply changes with /autostorage reload (alias /as reload). An invalid reload keeps the previous valid configuration.
For version 2.0.0: the configuration uses configVersion: 7, and tracked crates use SQLite schema 1. Older or unversioned configuration/database formats are not automatically converted.
radius
The in-game UI allows players to adjust each AutoStorage crate's range up to the server-defined maximum values.
| Key | Description | Default | Range |
|---|---|---|---|
horizontalRadiusMax |
Maximum horizontal range, in blocks | 18 |
1 to 200 |
verticalRadiusMax |
Maximum vertical range, in blocks | 15 |
1 to 200 |
defaultHorizontalRadius |
Default horizontal range when an AutoStorage crate is placed | 14 |
1 to 200 |
defaultVerticalRadius |
Default vertical range when an AutoStorage crate is placed | 6 |
1 to 200 |
Default range per crate
- βοΈ Horizontal: 14 blocks
- βοΈ Vertical: 6 blocks
π transferConfig
Controls how and when items are transferred.
| Key | Description | Default | Range |
|---|---|---|---|
transferImmediate |
When true, transfers begin immediately after the source container changes. When false, the plugin waits for the configured delay after the last interaction. |
true |
true / false |
transferAfterLastInteractionInSeconds |
Delay after the last interaction, in seconds. Requires transferImmediate = false. |
3 |
0 to 60 |
transferOnlyWhenClose |
Transfers items only when the chest is closed. | false |
true / false |
transferMode |
Transfer unit: STACKS moves stacks per iteration; ITEMS moves up to a specified number of individual items per iteration. |
STACKS |
STACKS / ITEMS |
transferAmountPerTransfer |
Number of stacks or items moved during each transfer iteration | 1 |
1 to 1000 |
transferIntervalMs |
Cooldown between successful transfers, in milliseconds | 1000 |
250 to 5000 |
π§© Sorting Settings
| Key | Description | Default | Range |
|---|---|---|---|
defaultSortingMode |
Global default sorting mode: ITEM_ID matches exact items; ITEM_CATEGORY groups items by category. |
ITEM_ID |
ITEM_ID / ITEM_CATEGORY |
idleRetryMs |
Retry interval when no items are moved, in milliseconds | 5000 |
1000 to 60000 |
idleRetryBackoffMaxMs |
Maximum retry interval after an AutoStorage crate has been idle for a long time, in milliseconds | 60000 |
1000 to 60000 |
targetScanCacheMaxAgeMs |
Maximum cached-scan age in milliseconds; capped by idleRetryBackoffMaxMs | 15000 |
1000 to 60000 |
onlyStorageOwnerCanConfig |
When enabled, configuration is restricted to the owner or a player with autostorage.config.any. | false |
true / false |
π οΈ Crafting
| Key | Description | Default |
|---|---|---|
itemIsCraftable |
Enables or disables crafting for the AutoStorage item | true |
craftRequiresPermission |
Requires a permission to view and craft AutoStorage | false |
craftRequiresPermissionName |
Permission node used when permission-based crafting is enabled | autostorage.craft |
craftOutputQuantity |
Number of AutoStorage crates produced per craft | 1 |
π§ͺ recipeOverride (Optional)
Optionally overrides the AutoStorage crafting recipe for item ID Furniture_AutoStorage.
When enabled, the plugin generates an item override file and reloads the item asset.
| Key | Description | Default |
|---|---|---|
enabled |
Enables the recipe override | false |
timeSeconds |
Crafting duration, in seconds | 2.0 |
input |
Ingredient list containing itemId and quantity |
β |
benchRequirement |
Workbench requirements containing id, type, categories, and requiredTierLevel |
β |
π― targetFilter
Controls which target containers are considered valid.
Filters are evaluated in the following order:
- Deny by exact block ID
- Deny when the ID contains a specified token
- Allow by exact block ID
- Allow when the ID contains a specified token
| Key | Description | Default |
|---|---|---|
allowBlockIdsEnabled |
Enables or disables the allowBlockIds filter |
false |
denyBlockIdsEnabled |
Enables or disables the denyBlockIds filter |
false |
allowIdContainsEnabled |
Enables or disables the allowIdContains filter |
false |
denyIdContainsEnabled |
Enables or disables the denyIdContains filter |
true |
allowBlockIds |
Exact block IDs to allow | [] |
denyBlockIds |
Exact block IDs to deny | [] |
allowIdContains |
Allows a container when its block ID contains one of these tokens | ["chest", "drawer", "storage"] |
denyIdContains |
Denies a container when its block ID contains one of these tokens | ["autostorage", "salvage", "campfire", "furnace", "tannery"] |
π Mod Compatibility
| Key | Description | Default |
|---|---|---|
claimModCompatibility |
Enables or disables compatibility with claim-protection mods | true |
π Sorting Rules
AutoStorage follows these rules when distributing items:
- β In Same item type mode, destinations must already hold that item type. Same category uses the selected game category. Enable Use other chests if needed to try other included chests when no matching destination can accept the item, including when matching chests are full or reject it.
- β AutoStorage crates never transfer items to one another.
- β Existing stacks are filled before empty slots.
- β Matching destinations are prioritized by the quantity already stored in the selected item/category group, then by distance.
- β Item stack limits are always respected.
- β If the primary target is full, AutoStorage tries another compatible target.
- β Item durability, quality, and metadata are preserved. Existing stacks are merged only when compatible.
π₯οΈ User Interface
π Opening the UI
Crouch (sneak) and press Interact (F by default) while looking at an AutoStorage crate to open its configuration UI.
When
onlyStorageOwnerCanConfigis enabled, the owner or a player withautostorage.config.anycan configure the crate.

βοΈ Show Range

π§Ύ Sorting Modes
| Mode | Description |
|---|---|
| Same item type | Sorts by exact item ID using strict matching |
| Same category | Uses Hytale's first nonempty creative-library category, with type/item fallbacks. These categories may group unrelated items; the UI displays a warning. |
π Range Controls
Each AutoStorage crate has its own search range:
- βοΈ Horizontal range: 1 to
horizontalRadiusMaxblocks (default: 14) - βοΈ Vertical range: 1 to
verticalRadiusMaxblocks (default: 6)
Use the + and β buttons in the UI to adjust these values. Changes are saved automatically. The interface shows the current radius / server maximum and a top-down terrain map. Volume dimensions include both edges (2 Γ radius + 1); unavailable terrain samples are shown in grey.
β The selected sorting mode and range values are saved per crate and override the global defaults.
πΎ Persistence
π Tracked Crates
Tracked crates are automatically saved to tracked_autostorage.db. The following settings are stored for each crate:
- World and coordinates
- Owner UUID
- Sorting mode
- Horizontal and vertical range
- Ignored target containers
- Use other chests if needed option
π§ͺ Default Crafting Recipe
β Every value can be changed in the configuration file.
| Property | Value |
|---|---|
| Crafting Time | 2 seconds |
| Workbench | Workbench β Tinkering tab (Tier 2+) |
| Storage Capacity | 54 slots |
| Maximum Stack Size | 2 |
π Ingredients
- 5Γ Concentrated Life Essence
- 20Γ Copper Bar
- 20Γ Iron Bar
- 1Γ Gold Bar
π Language Files
The plugin provides localized item names and UI text.
It automatically detects the language selected in your game.
(Translations are machine-assisted; corrections are welcome!)
π§© Check Out My Other Mods
Explore the other MiniBox mods for Hytale:
- π Shared Life β Share health and linked deaths in co-op, with configurable healing and optional shared inventories.
- π₯ Automatic Collector β Browse nearby storage and withdraw a quantity, one stack, or the maximum your inventory can hold.
- π₯ Open Inventory & Inspect Gear β Open player inventories and inspect equipment with configurable permissions.
- βοΈ Escape Rope: Quick Exit from a Cave β Use a rope to return to the surface when a safe destination is available.
π I try to keep my mods easy to use, lightweight, configurable, and server-friendly.




