Transfer Rules

Transfer Rules

Applies to Storage Bridge (Sophisticated Storage) 0.0.0-beta.1 for Minecraft 1.21.1 (NeoForge).

Summary

Destination	Accepts	Refuses
Apothic-Enchanting Library	minecraft:enchanted_book	everything else
Apotheosis Gem Case	unsocketed gems	socketed gems, non-gems

The rules in detail

Libraries take enchanted books and nothing else

Any minecraft:enchanted_book stack in your inventory is moved into the Library. No other item is.

One-way and unrecoverable. The Library consumes what it accepts, and there is no way to pull a book back out — not with this mod, not by other means.

Gem Cases take unsocketed gems, and validate themselves

Unsocketed gem stacks are forwarded. Anything that is not a valid gem is rejected by the Gem Case's own capability rather than by this mod.

Socketed gems are not loose items and are not moved, so do not expect a socketed gem stack to transfer.

Direction

Both are one-way, into the destination. Nothing in this mod moves items out of a Library or a Gem Case.

How much moves in one gesture

Everything in your inventory that matches a rule for the chosen destination. There is no per-gesture limit and no partial transfer.

Routing order, and why it matters

1. Books and gems are routed first, to a reachable Library or Gem Case.
2. Then Sophisticated Storage's own deposit runs.

This ordering is the point: the items with nowhere else to go are handled before the controller's general deposit swallows the rest. Without it, a Gem Case next to your controller would never see anything.

The practical result of one right-click: enchanted books in a Library, gems in a Gem Case, and the remaining items in the controller's storages.

Which destination wins

The controller's connected and linked blocks are searched, and the mod deposits into one eligible container. With both a Library and a Gem Case in range, only one is used — there is no rule that prefers one over the other.

Practical recipes

Sort your enchanted books into the Library

Empty your enchanted books into your inventory, right-click the Controller. All of them go. No filtering by enchantment — it is every enchanted book you are carrying.

Load unsocketed gems into a Gem Case

Carry the loose gems, right-click the Controller. The Gem Case rejects anything that is not a gem, so you cannot misload it this way.

If nothing happens

1. Nothing matched a rule. The rules above are strict by design.
2. You were sneaking.
3. You clicked something other than the Controller.
4. The target is outside controllerRange, or is neither connected nor linked to it.
5. The destination refused the item. Both the Library and the Gem Case validate.