RunicKeeper

Runic Keeper

Master your inventory with the power of the runes.

Runic Keeper is a Hytale mod that revolutionizes how you store and access your items. Inspired by popular "Magic Storage" systems, this mod introduces a new magical block that connects to all nearby chests, allowing you to view, search, and manage your entire storage system from a single, powerful interface.

---

What's New in v1.4.0? (The Sorting Update)

This update introduces Smart Sorting Runes, a new crafting station, and significant quality-of-life improvements. Managing your storage empire has never been easier!

New Feature: Runic Crafter & Sorting Runes

Introducing the Runic Crafter, a new workbench allowing you to create powerful runes that enforce order in your storage system.

• Runic Crafter Block: A new station for crafting runes. It can be crafted in a standard Workbench using 10 Iron Ingots and 20 Essence of the Void.
  • (Note: Currently uses the Arcane Workbench model as a placeholder).
• Sorting Runes: Use these runes on chests to restrict them to specific item categories.
  • Log Rune: Restricts chests to Logs and Wood types.
  • Stone Rune: Restricts chests to Stone, Rock, and Cobblestone.
  • Ore Rune: Restricts chests to Ores, Bars, and Gems.
  • Weapon Rune: Restricts chests to Swords, Bows, Wands, and Axes.
• Smart Deposit Logic: The system now prioritizes filtered chests. If you have an empty chest marked "Ore" and deposit items, ore will go there first, even before filling non-filtered chests!
  • Troubleshooting Tip: If items are not entering an empty filtered chest automatically, try placing a single matching item inside manually to "prime" it.

Improvements & Fixes

Double Chest Support:

• Sealing & Filtering: Using a Runic Seal or Sorting Rune on a Double Chest now automatically applies the effect to both halves. No more desync!
  • Migration Notice: Due to backend changes, please delete old JSON files (sealed_chests.json, chest_filters.json) in the config folder before updating to ensure Double Chest support works correctly.

Mod Compatibility:

• Storage Drawers Fix: Resolved a critical issue where Runic Keeper failed to scan or interact with storage drawers correctly. The scanner now intelligently handles unique container implementations to prevent ghost items or detection failures.

UI Enhancements:

• Expanded Sidebar: The category sidebar has been expanded to include more filtering options: Wood, Stone, Crafting, Plants, and Materials.
• Layout: Sidebar now supports a 2-column grid layout for better visibility.

Backend & Logic:

• Improved Scanning: Optimized the StorageScanner to use object identity checks. This ensures accurate counting and prevents double-counting items in complex setups.
• Priority Logic: Fixed a bug where filtered chests would be ignored if they were empty.

---

Key Features

• Centralized Storage Network: Access every item in surrounding chests without opening them individually.
• Seal Your Chests! Craft a Runic Seal to lock specific chests. Sealed chests are ignored when depositing items, allowing you to create "Read-Only" storage for special gear or loot that won't get cluttered.
• Smart Filtering (New!): Use Sorting Runes to create dedicated storage for Ores, Wood, Weapons, and more.
• Powerful & Intuitive UI:
  • Search Bar: Instantly find any item by name.
  • One-Click Management: Use header buttons like "Quick Stack" (deposits matching items) and "Put All" (clears your backpack, ignoring your hotbar) to manage your inventory effortlessly.
  • Advanced Sorting: Cycle between sorting items by Quantity, Type, or Name.
  • Full Inventory View: See your entire player inventory and hotbar integrated directly into the UI.
  • Native Tooltips: Hover over any item in the network to see its name and details.

---

Getting Started

1. Craft the Blocks

• Runic Keeper: Crafted at a Tinkering Workbench (5x Iron Ingot, 1x Voidheart, 4x Wooden Chest).
• Runic Crafter: Crafted at a standard Workbench (10x Iron Ingot, 20x Essence of the Void).
• Runic Seal: Crafted at a Tinkering Workbench (2x Void Essence, 5x Marble Cobble, 1x Iron Ingot).

2. Setup Your Network

1. Place Your Keeper: Place the Runic Keeper block centrally among your chests.
2. Open the Network: Press F on the Runic Keeper to open the storage interface.
3. Organize: Use Sorting Runes to designate specific chests for Ores or Wood, or use the Runic Seal to protect your valuable gear from accidental deposits.

---

Configuration

You can adjust the scanning radius to fit your base layout.

• Command: /runicradius <number> (Default: 5, Max: 50)
• Config File: Located at mods/RunicKeeper/config.json.

---

Roadmap

Runic Keeper is in active development. Here’s what’s coming next:

• More Filter Runes: Expanding the variety of sorting runes for even finer control.
• Visual Updates: New custom models and textures for the Runic Crafter and other blocks.
• Visual Network Feedback: Particle effects or overlays to easily see which chests are connected and which are sealed.

---

Honorable Mentions & Showcases

@Zenouv - all credits for him for updating model with new texture and animations!