Automatic Storage

Drop all expedition resources in ONE spot to auto-store everything. Plug & Play. Mods compatibility, flexible options & individual preferences, edit recipes, simple UI, and full localization support.
AutoStorage crate preview

AutoStorage crate preview

Show the craft

Show the craft

item image
Everything you need to know and some you can also ignore

Everything you need to know and some you can also ignore

Deposit all your expeditions stuffs in it to automaticly store everything

Deposit all your expeditions stuffs in it to automaticly store everything

This shows how looks like the storage crate in your chest room

This shows how looks like the storage crate in your chest room

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

  1. Craft the Automatic Storage Crate at the Workbench, in the Tinkering tab (Tier 2).
  2. Place it in your base.
  3. Put items inside. The AutoStorage crate will distribute them to compatible nearby chests.
  4. Configure it by crouching and pressing Interact (F by default) while looking at the crate.

Automatic Storage crafting recipe

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?


🧰 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:

  1. Deny by exact block ID
  2. Deny when the ID contains a specified token
  3. Allow by exact block ID
  4. 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:

  1. βœ… 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.
  2. βœ… AutoStorage crates never transfer items to one another.
  3. βœ… Existing stacks are filled before empty slots.
  4. βœ… Matching destinations are prioritized by the quantity already stored in the selected item/category group, then by distance.
  5. βœ… Item stack limits are always respected.
  6. βœ… If the primary target is full, AutoStorage tries another compatible target.
  7. βœ… 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 onlyStorageOwnerCanConfig is enabled, the owner or a player with autostorage.config.any can configure the crate.

AutoStorage configuration, sorting options and terrain map

↔️ Show Range

Range visualization for an AutoStorage crate

🧾 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 horizontalRadiusMax blocks (default: 14)
  • ↕️ Vertical range: 1 to verticalRadiusMax blocks (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.

Automatic Storage Team

profile avatar
Owner
  • 5
    Followers
  • 8
    Projects
  • 60.4K
    Downloads
Donate

More from MiniBoxView all

  • Shared Life project image

    Shared Life

    Shared health and linked deaths for Hytale co-op, configurable healing, native Soulbound support, and optional shared inventory, hotbar, tools and backpack.

    • 8
    • October 29, 2026
  • Automatic Collector project image

    Automatic Collector

    Browse nearby chests and withdraw items through one interface. Supports modded containers, configurable exclusions, and automatic range linking with Automatic Storage.

    • 214
    • October 29, 2026
  • Open Inventory & Inspect Gear project image

    Open Inventory & Inspect Gear

    Open player inventories, inspect gear safely, and interact with backpacks. Includes admin tools, offline access, permissions, distance limits, configurable sections, and multi-language support

    • 1.4K
    • October 13, 2026
  • Escape Rope : Quick Exit a Cave project image

    Escape Rope : Quick Exit a Cave

    Quick exit a cave by using a rope to get out of these caves

    • 2.4K
    • October 13, 2026
  • Shared Life project image

    Shared Life

    Shared health and linked deaths for Hytale co-op, configurable healing, native Soulbound support, and optional shared inventory, hotbar, tools and backpack.

    • 8
    • October 29, 2026
  • Automatic Collector project image

    Automatic Collector

    Browse nearby chests and withdraw items through one interface. Supports modded containers, configurable exclusions, and automatic range linking with Automatic Storage.

    • 214
    • October 29, 2026
  • Open Inventory & Inspect Gear project image

    Open Inventory & Inspect Gear

    Open player inventories, inspect gear safely, and interact with backpacks. Includes admin tools, offline access, permissions, distance limits, configurable sections, and multi-language support

    • 1.4K
    • October 13, 2026
  • Escape Rope : Quick Exit a Cave project image

    Escape Rope : Quick Exit a Cave

    Quick exit a cave by using a rope to get out of these caves

    • 2.4K
    • October 13, 2026