> For the complete documentation index, see [llms.txt](https://reasonfounddecoy.gitbook.io/mctantrum-wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://reasonfounddecoy.gitbook.io/mctantrum-wiki/slimefun/addons/sensibletoolbox/items/storage.md). # Storage {% hint style="warning" %} This page is a work in progress. Information may not be accurate. {% endhint %} ## Storage STB provides a couple of blocks for efficient mass storage of items. ### BSU (Big Storage Unit) ![recipe-bsu](/files/ZuhG8H1r5gFjf9ycnqRg) The BSU can store up to 128 stacks of a single item (so up to 8192 items if the item's stack size is 64). Right-clicking the BSU will open a GUI: ![bsu-gui](/files/LVkiu0oITbKb1BTW4mDT) 1. Place items to be stored in this slot. They will be automatically pulled into storage, if there's room. If there are items in storage, then only items of *exactly* the same type (material, block data and metadata) will be accepted. 2. Items stored are shown here; the tooltip shows the number of items stored and the maximum number storable. 3. This is the output slot; this is automatically filled from the internal storage up to the stored item's maximum stack size. 4. The bottom button here toggles the BSU's "locked" mode; when locked, the BSU will remember its stored item even when emptied, and only accept that item, either via the GUI or from an Item Router. When unlocked, the BSU will forget its stored item if it's emptied, and accept any item. [Labelling a BSU with a sign](/mctantrum-wiki/slimefun/addons/sensibletoolbox/items.md) is a useful thing to do; you will see at a glance what is stored and how much. A locked BSU shows the item quantity in red (unlocked shows the quantity in black). There are other ways to quickly store and extract items: * Right-clicking a BSU with the same item in hand as the item that is stored will automatically store that item in the BSU. Right-clicking an empty BSU will always open the GUI. Note that right-clicking with block items (e.g. stone) may require you to stand a little back from the BSU - this is a CraftBukkit limitation on how events are fired when right-clicking with a block item, and not something that STB can control. * Double-right-clicking will store *all* items in the player's inventory that match the stored item. * Left-clicking a BSU will pop out one stack of the stored item on the floor. * Shift-left-clicking a BSU will pop out a single item. * You can also move items in and out with an [Item Router](/mctantrum-wiki/slimefun/addons/sensibletoolbox/items/routing.md). If you break a BSU, its contents will be scattered on the floor. Breaking a full BSU is not a great idea! In addition, a maximum of 4096 items will be dropped; any stored items over that will be lost forever. ### HSU (Hyper Storage Unit) ![hsu](/files/ZuhG8H1r5gFjf9ycnqRg) The HSU functions in a similar manner to the BSU, but with these important differences: * The HSU can store up to *2 billion* items in a nearby dimensional pocket * Due to its extra-dimensional nature, the HSU does *not* lose its contents when broken. This makes it an excellent solution for moving very large quantities of items around. * The HSU requires a small amount of [energy](/mctantrum-wiki/slimefun/addons/sensibletoolbox/items/energy.md) to run: * Inserting items (manually or via an Item Router) uses 0.05 SCU per item inserted. So a stack of 64 items requires 3.2 SCU. * Extracting items via an Item Router uses 0.05 SCU per item extracted. * Extracting items manually does not require power, so if you run out of energy, your items are still available to you. * The HSU has an internal charge buffer of 1000 SCU, and can receive energy at a maximum rate of 10 SCU/tick. It can also take an energy cell. Note that as of STB v0.0.3, the HSU requires an [Integrated Circuit](/mctantrum-wiki/slimefun/addons/sensibletoolbox/items/components.md) to craft. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://reasonfounddecoy.gitbook.io/mctantrum-wiki/slimefun/addons/sensibletoolbox/items/storage.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.