Refined Storage · Troubleshooting · Advanced
Refined Storage Troubleshooting: Fixing Missing Items, Stuck Crafting, and NBT Lag
A massive Refined Storage network is the ultimate convenience, right up until it freezes your crafting jobs, eats your items, or corrupts your entire base with a dreadful NBT overload error. This advanced troubleshooting guide will teach you how to diagnose missing items, unstick infinite crafting loops, and sanitize your Storage Disks to prevent devastating world corruption and severe server TPS lag.
What you need
- An established Refined Storage network (Controller, Disk Drive, Grid, and Crafting Monitor)
- Disk Manipulator and several Speed/Stack Upgrades
- External Storage bus and large vanilla chests or dedicated storage drawers/barrels
- Filter items or whitelist/blacklist materials (damaged bows, enchanted armor)
- Wrench or pickaxe for rapid device replacement
Step by step
1Purge NBT Junk Using the Disk Manipulator
Never allow mob farm drops like damaged bows, enchanted leather armor, or custom tool variants to flood your Storage Disks, as this causes chunk corruption and massive lag. Place a Disk Manipulator connected to your network alongside an External Storage attached to a trash can or isolated chest with a very high priority (e.g., 100). Set the Disk Manipulator to move items from the disk into the network, configure its filter to match the problematic gear, and disable exact NBT and Damage comparison in the GUI. Insert your bloated Storage Disks into the input slot to rapidly drain all unique gear variations out of your digital storage.
Tip: Load the Disk Manipulator with four Stack Upgrades and three Speed Upgrades to process thousands of corrupted items in seconds.
2Locate Missing Items via Priority Audits
When items vanish from your Grid or fail to enter your Storage Disks, they are almost always being hijacked by a high-priority External Storage or kept inside an isolated sub-network. Walk along your Cable lines and check the priority level of every External Storage, Disk Drive, and Storage Block you have placed. Lower the priority of random machine buffers (like chests attached to furnaces) to a negative number so items naturally default back to your main Disk Drive.
Tip: Double-check your Grid search bar and left-side filter buttons; setting the view to 'Craftables Only' or leaving a@modname tag in the search box is the number one reason players think their items disappeared.
3Unstick Infinite Processing Crafting Jobs
Open your Crafting Monitor to see why an auto-crafting job is hanging indefinitely. If it says a machine is currently processing an item, walk over to the Crafter attached to that specific machine (such as a smelter or crusher). Verify that the Crafter is actually facing the valid input side of the machine and that an Importer or External Storage is actively pulling the finished product out of the machine's output slot back into the network.
Tip: If a machine gets jammed with leftover items from a canceled job, manually empty the machine and place those raw results directly into your Grid to immediately satisfy the waiting Crafting Monitor.
4Fix NBT-Mismatch Recipes in Patterns
Molecular crafting recipes often stall because a Pattern demands a sub-component with exact metadata (like a half-charged energy cell or specific anvil-named tool) that the system cannot replicate. Take the broken Pattern to your Pattern Grid and re-encode it. Before clicking the create button, make sure the 'Exact' mode toggle is unchecked unless the recipe specifically requires precise durability or enchantments, allowing the Crafter to substitute valid generic equivalents.
Tip: When encoding recipes using buckets or fluid containers, it is always safer to use the fluid mode in the Pattern Grid rather than relying on physical bucket items.
5Eliminate Controller Flickering and Power Brownouts
If your Grid frequently closes itself or items briefly disappear and reappear, your network is suffering from energy starvation. Open the Controller GUI to inspect your exact energy usage per tick versus its maximum internal buffer capacity (check JEI or the Controller tooltip for your modpack's specific energy values). Disconnect non-essential high-drain devices like Wireless Transmitters filled with Range Upgrades, or immediately upgrade your power generation infrastructure so the input rate strictly exceeds the network's continuous drain.
Tip: Use a Detector paired with a Relay to automatically shut off power-hungry sub-networks when your main energy storage drops below fifty percent.
6Optimize Network Topology for Server TPS
A single sprawling network with dozens of Exporters, Importers, and Destructors constantly polling inventories will severely degrade server tick rate (TPS). Replace any External Storage attached to massive chests full of random items with dedicated storage drawers or bulk storage blocks for single item types. Furthermore, remove Stack and Speed Upgrades from Importers and Exporters that do not strictly require rapid item movement, as these upgrades multiply the frequency of inventory checks per second.
Tip: Spread your Disk Drives and heavy auto-crafting Crafters across different chunk boundaries rather than cramming your entire digital infrastructure into one single 16x16 chunk.
How it works
Understanding the dreaded NBT lag requires looking at how Minecraft saves data. Unlike simple cobblestone, which is stored as a single item ID and a quantity count, items with durability, enchantments, or custom names contain complex Named Binary Tag (NBT) data. When you store thousands of unique mob-dropped bows on a single 64k Storage Disk, the mod has to serialize every individual bow's metadata into that item or tile entity. If the data within a single chunk or player inventory exceeds Minecraft's internal byte packet limit, the game will forcibly disconnect you or fail to save the chunk, resulting in a corrupted world or an unopenable Grid.
Auto-crafting in Refined Storage operates on a strict credit-and-debit expectation system. For a Processing Pattern, the Crafter simply pushes the input ingredients into whatever inventory it points at and then waits passively. The Crafter has no awareness of whether the attached machine actually has power, is configured to accept items on that side, or is jammed with another player's items. The job will remain permanently stuck in the Crafting Monitor until those exact expected output items re-enter the Refined Storage network via an Importer, Interface, or manual player insertion.
Server TPS (Ticks Per Second) lag primarily stems from how External Storage and active I/O buses interact with non-network inventories. Every time an item enters your network, the Controller must scan its storage registry from highest priority to lowest to find a valid home. If you connect an External Storage to a colossal chest containing dozens of empty or mixed slots, the network must iterate through every single slot of that chest on every single transfer operation, creating a massive computational bottleneck.
Common mistakes
- Pipe-dumping raw mob farm loot directly into an Importer without first filtering out damaged armor, weapons, and Enchanted Books.
- Pointing a Crafter directly into another Crafter or a disabled machine, causing items to get stuck in an invisible internal buffer.
- Leaving hundreds of blank slots on a high-priority External Storage chest, forcing the network to constantly scan that chest during every automation cycle.
- Breaking a Disk Drive with a pickaxe while it holds NBT-heavy disks and putting the whole block in a backpack, which immediately triggers a player-data packet kick.
FAQ
Why does my Crafting Monitor say a job is running, nothing is happening, and the cancel button does not fix the bottleneck?
A machine down the line is either full, unpowered, or jammed with leftover items from a previous recipe. Find the machine responsible for the current sub-step, manually clear its input and output slots, and then cancel and restart the crafting job.
Is it safe to use Infinite or colossal third-party addon Storage Disks?
They are completely safe for raw bulk resources like stone, ingots, and crops that lack metadata. However, they are extremely dangerous if unfiltered, because they allow you to accumulate enough NBT items in a single disk to corrupt your save file before the disk ever reaches its item limit.
Why is my Exporter not pushing items even though I know I have thousands of them in my Grid?
Check if the Exporter is configured to compare NBT or Damage values. If you put a slightly damaged pickaxe or a specific tag item into the Exporter filter slot with exact comparisons enabled, it will ignore pristine or differently tagged versions of that item in your storage.
Do long Cable lines cause server lag in Refined Storage?
Passive Cables themselves add negligible lag once the network graph is built. However, breaking or placing blocks on a massive unified Cable network forces the Controller to recalculate the entire network pathing, which causes a noticeable momentary lag spike.
By proactively stripping NBT-heavy gear off your Storage Disks, auditing your storage priorities, and verifying input/output paths on processing machines, you will keep your Refined Storage network completely immune to data corruption, stuck crafts, and server-crashing TPS lag.