2025-03-28

Since 2020, I’ve been working on Refined Storage 2—an evolution of the original mod, rebuilt from the ground up with a focus on code quality, modern architecture, and Fabric support. After years of development and public GitHub milestones, the first beta is now available on CurseForge and Modrinth for Minecraft 1.21.1.

Background

Refined Storage is nearly ten years old, and its codebase was starting to show its age. While none of the original 2015 code likely remained—thanks to years of refactors—it still felt like the right time for a clean slate.

The biggest issue with the old version was that, while functional, its internal structure had become a burden. It lacked tests, and the architecture made it difficult to maintain, evolve, or prevent regressions.

I started Refined Storage back in high school. Today, I’m a professional software engineer. I wanted the codebase to reflect that growth and be something I could keep enjoying and supporting.

Rewriting a mod of this size was a big risk. It could’ve failed. But I believed it was necessary to secure the long-term future of the project.

Goal

Refined Storage 2 has been rebuilt from the ground up with the following goals in mind:

  • A strong focus on code quality

  • Long-term maintainability

  • Mod loader independence

  • A complete rethinking and modernization of nearly every feature

What has changed?

Summary

  • Integrations have been moved to addons.

  • There is a Mekanism integration now adding support for chemical storage.

  • The Fluid Grid was removed. The regular Grid now handles items, fluids, and chemicals.

  • The Grid marks autocraftable resources with an orange backdrop, also considering uninserted patterns in your inventory.

  • The Autocrafter now supports more locking options for easier blocking mode.

  • Autocrafting now takes into account multiple patterns with the same output, respecting priority defined in the Autocrafter.

  • The crafting preview and amount selection screens have been merged into one screen with live updates, ability to receive autocrafting notifications and a "Max" button to fill out max craftable.

  • The Pattern Grid now supports encoding stonecutter and smithing table recipes.

  • Storage disks and blocks can now be upgraded by combining with a higher-tier Storage Part. The original part is returned.

  • You can now configure separate insert and extract priorities on storages.

  • Storages now support void excess mode to automatically delete overflow.

  • The Fluid Interface has been removed and the Interface now supports all resource types.

  • Multiple Controllers can now be placed in one network to meet energy demand.

  • The Relay now supports creating subnetworks.

  • The Configuration Card has been added to easily move configurations across devices.

  • The Wrench now supports dismantling devices.

  • Colored cables and variants (Importers, Exporters, External Storages) connect only with matching colors.

Official integrations and addons

To reduce core complexity, integrations have been moved to their own addon mods.

Removed from core into a dedicated addon

Viewing resources

  • The Fluid Grid was removed. The regular Grid now handles items, fluids, and chemicals.

    • Single Grid with items

  • Fluids and chemicals can be inserted by right-clicking a container onto the Grid.

  • The Grid supports a Resource Type filter, defaulting to "All".

  • Grid tag search now uses #, and tooltip search uses $.

  • The Grid search bar supports complex expressions and syntax highlighting.

    • Grid with advanced search query

  • New slot hints show what will be inserted or extracted.

    • Grid tooltip showing what can be inserted

    • Grid tooltip showing what can be extracted

  • The Crafting Grid adds:

    • A clear-to-player-inventory button.

    • A keybinding to clear to inventory (NeoForge only).

    • A shortcut (CTRL+SHIFT on result slot) to filter the Grid by crafting matrix contents.

    • Crafting Grid highlighting items from the crafting matrix

    • A config option to clear items from the matrix to the player or network inventory when closing the screen.

    • Screenshot showing ability to move items out of the crafting matrix

  • The amount screen (e.g., for Detectors) now:

    • Supports scrollbars and increment/decrement buttons.

    • Highlights invalid amounts in red.

    • Detector amount screen

  • Grid UI settings like smooth scrolling and row stretch are now global client config.

  • The Portable Grid UI now displays an energy bar.

  • Contents of storages in "insert-only" mode are now visible in the Grid.

Autocrafting

  • The Crafter has been renamed to the Autocrafter.

  • The Autocrafter now:

    • Faces the block you’re placing it against, like other cable blocks.

    • Supports renaming from the UI.

    • Supports configuring a priority value to give precedence to patterns with the same output.

    • Allows toggling visibility to the Autocrafter Manager (enabled by default).

    • Connects to other Autocrafters only through the front face, avoiding unintended network connections when used with interfaces.

    • Autocrafter UI

  • Locking mode replaces the old "crafter mode" with following options:

    • Never

    • Lock until redstone pulse

    • Lock until connected machine is empty (for blocking mode)

    • Lock until all outputs are received (for blocking mode)

    • Lock until low redstone signal

    • Lock until high redstone signal

  • The Autocrafter Manager now includes:

    • A view filter: All, Not Full, or Visible-only Autocrafters.

    • A revamped search that targets pattern inputs, outputs, names, or all.

  • You can initiate autocrafting from the Storage Monitor if the resource count is zero.

  • When multiple patterns share an output, the one with the highest priority is used first.

  • Tasks can’t be cancelled if there’s not enough storage space to return intermediates.

  • The crafting preview now:

    • Merges preview and amount selection into one screen with live updates.

    • Lets you fill out the maximum amount that is craftable.

    • Autocrafting preview

    • Allows enabling notifications when a task is completed.

    • Autocrafting notification

    • Shows all parallel requests triggered by recipe mods.

  • The Autocrafting Monitor now:

    • Uses compacted units.

    • Displays which machine is processing each step.

    • Uses a sidebar for tasks instead of tabs.

    • Autocrafting Monitor

  • The Grid and Pattern Grid:

    • Visually mark autocraftable resources with orange backdrops and tooltips.

    • Also consider uninserted patterns in your inventory.

    • Pattern Grid screenshot

  • The Pattern Grid:

    • Supports encoding stonecutter and smithing table recipes.

    • Pattern Grid modes

    • Pattern Grid stonecutter encoding

    • The alternatives screen supports searching, tag-based resource groups (collapsible), and translated tag names.

    • Allowed alternatives for a processing input

    • "Exact mode" replaced by inverse Fuzzy mode.

  • Patterns:

    • Show the recipe in their tooltip.

    • Pattern with recipe in the tooltip

    • Use different textures and names to distinguish from empty patterns.

    • Pattern types

Storage

  • Storage disks and blocks can now be upgraded by combining with a higher-tier Storage Part. The original part is returned.

    • Recipe showing storage disk upgrading

  • You can now configure separate insert and extract priorities on storages.

    • Different insert/extract priorities

  • The Interface:

    • Now supports fluids and chemicals (replaces the "Fluid Interface").

    • Supports extraction via buckets or other containers.

    • No longer has dedicated import slots; input goes to export slots.

    • Immediately imports and exports.

    • Interface supports multiple resource types now

  • The External Storage:

    • Supports multiple resource types simultaneously.

  • The Constructor and Exporter:

    • Support scheduling modes: first available, round robin, or random.

    • Filter slots now show hints for missing, blocked, currently autocrafting, or uncraftable resources.

    • Filter slot hints

  • The Importer:

    • Extracts as much of a single resource type as possible across all slots, following the per-tick quota.

    • Automatically detects the connected resource type (item/fluid/chemical).

  • The Regulator Upgrade:

    • Previously supported Exporters, but now also supports Importers and stops importing once the set amount is reached.

    • Must now be configured via the item, not the device UI.

  • Void excess mode can be enabled on storages to automatically delete overflow. An allowlist filter is required.

  • You no longer have to pre-select a resource type in filter slots: right-click a container or drag from a recipe viewer instead.

  • Item storage capacities are now multiples of 1024 for better stack alignment.

  • A single resource can now exceed 2,147,483,647 units in storage.

  • Fuzzy mode replaces "Exact mode" and is off by default for performance.

  • The Disk Manipulator has been renamed to Disk Interface.

Networking

UI and accessibility

  • Disk Drives, Disk Interfaces (formerly known as "Disk Manipulator"), and Portable Grids now support custom disk models for each disk type.

    • Custom item

  • UI titles now scroll (marquee) when overflowing.

  • New Grid size: Extra Large (12 rows).

  • Hints, tooltips, and SHIFT-help added across many screens.

    • Help tooltip

  • Upgrade slots now show compatible upgrades.

    • Upgrade slots showing compatible upgrades

  • Upgrade tooltips list supported devices.

    • Upgrade tooltip showing applicable devices

  • JEI/REI/EMI search sync is now configurable separately from Grid auto-selection.

Other additions and tweaks

  • Optimized memory usage and startup time.

  • Improved Grid search performance.

  • Configuration Card copies upgrades and settings between devices.

  • Quartz Enriched Copper is used to craft cables, giving copper a use.

  • Creative Range Upgrade grants infinite wireless range in the Wireless Transmitter.

  • Colored cables and variants (Importers, Exporters, External Storages) connect only with matching colors.

  • Detectors and Grids can now be placed in all directions (sideways, upside-down).

    • Colored cables and upside down blocks

  • New Wrench behavior:

    • Crouch-wrench to dismantle a block (preserving config).

    • Supports wrenches from other mods that have the c:wrenches tag.

  • Recipes now follow tag conventions from NeoForge and Fabric.

  • Compatibility improvements with modded block movers:

    • Fixed moving devices with mods like Carrier.

    • Fixed CTRL + click in creative mode not preserving block data.

Infrastructure improvements

Refined Storage 2 wasn’t built in isolation. As part of its development, the broader Refined Mods ecosystem saw major upgrades:

  • The website was overhauled with a brand-new wiki system that supports multiple versions at a time.

  • The wiki was completely rewritten from scratch.

  • On the more technical side, Refined Architect was created—a shared project used across all Refined Mods. It includes GitHub workflows, version management, and a Gradle convention plugin to simplify (cross-platform) mod development.

What’s next?

Refined Storage 2 will continue to receive frequent updates with new features and bug fixes. Most new functionality will be released as part of addons.

Special thanks

This release was the result of a sustained, multi-year effort. I couldn’t have done it without the incredible support from the community.

Special thanks to:

  • My friends on the ForgeCraft server for helping out with all sorts of random questions.

  • The Refined Mods Discord community for bug reports, testing, and feedback.

  • Translators on Crowdin who eagerly kept up with all the changes.

  • Technici4n for early API feedback and major influence on the final API design.

  • shartte for untangling Gradle issues.

  • Ultramega for help with integration tests.

  • My supporters on Patreon and Ko-Fi.

  • My partner Robin, for supporting me through every step of this journey.

Disclaimer: Refined Storage v2.0.0 is beta software. While sufficiently tested, bugs may occur.