
Maid Storage Manager
Enables your maid to manage your items
About this Mod
Maid Storage Manager

Adds a new job to the Touhou Maid mod. Now maids can pick up items from the ground and store them in nearby chests, or find specific items for you based on your request lists.
Usage
Filter
Place an item frame on a chest and insert a Filter/No Access into it.
If a maid detects items in the chest that do not match the filter, she will attempt to remove them and store them in other chests.
Deposit
Throw items directly to the maid. During idle time, she will store all items from her inventory into nearby chests following these priorities:
- Chests with active whitelist filters will be prioritized.
- Chests that previously stored the same item type.
- Any accessible chest without No Access.
Request
You can ask maids to retrieve specific items:
- Craft a Request List item.
- Right-click to open the GUI.
- Fill in required items and quantities (use mouse wheel to adjust numbers).
- (Optional) Sneak + right-click a target chest to bind a storage location.
- Give the configured list to the maid.
The maid will search nearby for listed items. Upon completion (regardless of success), she will place found items and the list itself into the target chest. Requested target chests ignore No Access restrictions.
Storage List
During idle time, maids automatically scan nearby chest contents. Give them a Storage List item to record memorized item quantities, which will return a Recorded Storage List.
Storage Define
Storage Define specifies which containers a maid can access and from which faces. Right-click blocks to select/deselect faces; sneak + right-click to select blocks (no face data, e.g., furnaces can directly access all slots).
Right-click air to switch definition modes:
- Add: Append new storage accesses to the maid's existing list
- Remove: Delete specified storage from maid's accessible locations
- Replace: Completely overwrite maid's access points (maid will ONLY use these)
- Replace Specific: When accessing specified locations, only allow interaction through selected faces
Compatibility Notes
- Maids can retrieve items from AE2 terminals (auto-crafting not yet supported). Configurable.
- Chest opening/closing animations are synchronized in multiplayer if the container supports state visibility.
- Uses item insertion method for multiblock container recognition. Watch for mod conflicts.
Asset License
GUI textures under assets/texture/gui are modified from Touhou Maid assets and follow CC-BY-NC-SA 4.0. Other assets and code licenses are specified in the license file.
Available Versions
How to Install Maid Storage Manager on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set forge Loader
In the panel under "Egg", select the forge loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "Maid Storage Manager". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1, 1.20.1
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Maid Storage Manager server crashes on startup – what to do?
Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.1). You can switch loaders with one click in the panel.
Is Maid Storage Manager compatible with forge and neoforge?
Maid Storage Manager officially supports forge, neoforge for Minecraft 1.21.1, 1.20.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Maid Storage Manager – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Maid Storage Manager consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Maid Storage Manager with just one click on your server.