📦 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 false : A delay after last interaction	`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 : Transfer stack per iteration (more control, less spam) ITEMS : Transfer up to N individual items per iteration	`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 : Exact item matching (iron sword to iron sword only) ITEM_CATEGORY : Category-based sorting (all weapons together, all tools together)	`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 onlyStorageOwnerCanConfig is 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 horizontalRadiusMax blocks (default: 14)
↕️ Vertical range: 1 to verticalRadiusMax blocks (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 :

🔥 Open Inventory & Inspect Gear
⛏️ Escape Rope : Quick Exit a Cave

👉 I try to keep my mods easy to use, lightweight, configurable and server-friendly.