Description
📦 Automatic Storage : Fast & Easy to Use
AutoStorage is a light, efficient, and powerful mod that automates item sorting between chests.
Drop all expedition resources in ONE spot to auto-store everything.
🚀 How it works ?
- Craft the Automatic Storage Crate at a Tier 2 Tinkering Workench .
- Place it in your base.
- Put items inside and the AutoStorage crate will distribute them to compatible nearby chests.
- Configure it with Crouch + Interact (F) on the crate.
Craft can be changed in the config file
✨ Features
- 📦 Automatic item distribution to nearby chests (compatible with mods that have containers)
- 🧠 Smart targeting: items go to chests that already contain the same item type
- 🧩 Two sorting modes: exact item ID or item category
- ⏱️ Server configuratable transfer rate (by stacks or item quantity)
- ⚡ Event-driven architecture: no infinite background polling (unlike similar addons), for a minimal server load
- 🧱 Intelligent transfer: that respect your chest organization. Fills existing stacks first, then empty slots
- 🖥️ In-game UI for per-crate configuration (Crouch + F)
- 🎛️ Per-crate sorting mode via the UI
- 💩 Indivual options on your crate such as : "Transfer to an empty chest if not matched" or "Ignore this chest"
- 📏 Per-crate horizontal/vertical range controls with +/- buttons
- 🔗 Live display of linked chests count within range, and show the range
- ⚙️ Plenty of configuration options & flexibility to match your needs for big and small servers
- 📝 Advanced filtering in the config to specify which Item Container ID you can transfer to or not
- 🏢 Security to avoid any duplication. Optimization for a low CPU usage
- 🟢 Compatibility with SimpleClaims mod to avoid griefing
- 🌍 Localized UI and item names: AR / BG / CS / DE / EL / EN / ES, PE / ET / FR / IT / NL / PL / PT / RU / SK / SV / TR / UK (by ChatGPT sorry).
🐞 Bug Reports & Suggestions
Found a bug, have an idea, or want to request a feature?
- ✅ Best way: join my Discord and post in the appropriate channel
🧰 Command
| Command | Description |
|---|---|
/autostorage reload |
Reloads the plugin configuration (alias: /as reload) |
🔐 Permission
| Feature | Permission |
|---|---|
| Authorize craft AutoStorage (when craft is disable) | autostorage.craft |
| Open any AutoStorage configuration (when onlyStorageOwnerCanConfig is enable) | autostorage.config.any |
⚙️ Configuration
The configuration file is organized by sections.
Every setting is fully customizable to match your server’s needs.
radius
The in-game UI lets players adjust each AutoStorage radius up to the max.
Controls this maximum radius on the server of all of the automatic storage crest.
| Key | Description | Default | Range |
|---|---|---|---|
horizontalRadiusMax |
Maximum horizontal radius in blocks | 18 |
1 to 200 |
verticalRadiusMax |
Maximum vertical radius in blocks | 15 |
1 to 200 |
| defaultHorizontalRadius | Default horizontal radius when you place the AutoStorage crate | 14 | 1 to 200 |
| defaultVerticalRadius | Default horizontal radius when you place the AutoStorage crate | 6 | 1 to 200 |
Default radius per chest
- ↔️ Horizontal: 14 blocks
- ↕️ Vertical: 6 blocks
🔁 transferConfig
Controls how and when items are transferred.
| Key | Description | Default | Range |
|---|---|---|---|
transferImmediate |
true : Transfer immediately on container change |
true |
x |
transferAfterLastInteractionInSeconds |
Requires transferImmediate = false to apply a delay after the last interaction (seconds) |
3 |
0 to 60 |
transferOnlyWhenClose |
Transfers only when the chest is closed | false |
x |
transferMode |
Unit of transfer : |
STACKS |
x |
transferAmountPerTransfer |
Amount of stacks/items per transfer iteration | 1 |
1 to 1000 |
transferIntervalMs |
Cooldown between successful transfers in milliseconds | 1000 |
50 to 5000 |
🧩 Sorting Settings
| Key | Description | Default | Range |
|---|---|---|---|
defaultSortingMode |
Global default sorting mode: |
ITEM_ID |
x |
idleRetryMs |
Retry interval when no items moved (ms) | 5000 |
250 to 60000 |
idleRetryBackoffMaxMs |
Maximum retry interval after a long time of sleep for an AutoStorage chest that don't found an item (ms) | 60000 | 250 to 60000 |
| targetScanCacheMaxAgeMs | 15000 | 250 to 60000 | |
onlyStorageOwnerCanConfig |
Only the player who placed AutoStorage can open the UI | false |
x |
🛠️ Crafting
| Key | Description | Default |
|---|---|---|
itemIsCraftable |
Enable/disable crafting for the AutoStorage item | true |
craftRequiresPermission |
Require permission to see/craft AutoStorage | false |
craftRequiresPermissionName |
Permission node used when enabled | autostorage.craft |
| craftOutputQuantity | Number of AutoStorage crate for a craft | 1 |
🧪 recipeOverride (Optional)
Optional override for the AutoStorage crafting recipe (item id: Furniture_AutoStorage).
When enabled, the plugin generates an item override file and reloads the item asset.
| Key | Description | Default |
|---|---|---|
enabled |
Enable the override | false |
timeSeconds |
Crafting duration in seconds | 2.0 |
input |
Ingredient list (itemId, quantity) |
x |
benchRequirement |
Bench requirements (id, type, categories, requiredTierLevel) |
x |
🎯 targetFilter
Controls which target containers are considered valid.
Matching order is:
1) deny by exact block id
2) deny by id contains
3) allow by exact block id
4) allow by id contains
| Key | Description | Default |
|---|---|---|
| allowBlockIdsEnabled | Enable or disable the allowBlockIds filter | false |
| denyBlockIdsEnabled | Enable or disable the denyBlockIds filter | false |
| allowIdContainsEnabled | Enable or disable the allowIdContains filter | false |
| denyIdContainsEnabled | Enable or disable the denyIdContains filter | true |
allowBlockIds |
Exact block ids to allow (full id string) | [] |
denyBlockIds |
Exact block ids to deny (full id string) | [] |
allowIdContains |
Allow if the block id contains one of these tokens | [] |
denyIdContains |
Deny if the block id contains one of these tokens | ["autostorage", "salvage", "campfire", "furnace", "tanery"] |
📜 Mods compatibility
| Key | Description | Default |
|---|---|---|
| claimModCompatibility | Enable or disable the compatibility with claim mods | false |
📐 Sorting Rules
AutoStorage follows these rules when distributing items:
- ✅ Items only transfer to chests that already contain that item type
- ✅ AutoStorage chests never transfer items to each other
- ✅ Fills existing stacks first, then empty slots
- ✅ Prioritizes chests with the most of that item type
- ✅ Respects item stack limits (varies per item)
- ✅ Falls back to a secondary target if the primary is full
- ✅ Keeps condition consistent: pristine → pristine, damaged → damaged
🖥️ User Interface
🔓 Opening the UI
Crouch (sneak) + Interact (F) an AutoStorage chest to open the native configuration UI.
If
onlyStorageOwnerCanConfigis enabled, only the player who placed the AutoStorage can open this UI.
↔️ Show range
🧾 Sorting Modes (UI)
| Mode | Description |
|---|---|
| Identical Item | Sort by exact item ID (strict matching) |
| Item Category | Sort by category (weapons, tools, armor, etc.) — includes a warning about inconsistent categories |
📏 Range Controls
Each AutoStorage chest has its own search radius:
- ↔️ Horizontal range: 1 to
horizontalRadiusMaxblocks (default: 14) - ↕️ Vertical range: 1 to
verticalRadiusMaxblocks (default: 6)
Use the + and - buttons in the UI to adjust. Changes are saved automatically.
✅ The selected mode and ranges are saved per chest and override the global settings.
💾 Persistence
📌 Tracked Chests
- Tracked chests are automatically saved to
tracked_autostorage.json - On server startup, the plugin reloads all tracked chests
🧾 Saved Data Per Chest
| Stored Data | Notes |
|---|---|
| World name | x |
| X, Y, Z coordinates | x |
| Owner UUID | when available |
| Sorting mode override | per-chest |
| Horizontal/vertical radius | per-chest |
🧪 Crafting Recipe (Default)
✅ Everything is editable in the config.
| Property | Value |
|---|---|
| Crafting Time | 2 seconds |
| Workbench | Tinkering Bench (Tier 2+) |
| Storage Capacity | 36 slots |
| Max Stack | 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 your game language. (Thanks to ChatGPT!)
🧩 Checkout my mods
If you enjoy Automatic Storage, you might like my other mods too :
👉 I try to keep my mods easy to use, lightweight, configurable and server-friendly.