Inventory Reader (Skyblock Resource Calculator)

A Minecraft Fabric mod (formally known as Skyblock Mining Resource Reader) that seamlessly tracks inventory, storage, and sack data for Hypixel Skyblock, with advanced recipe and resource management.

This Mod should work on all Platforms

---

Overview

Inventory Reader automatically monitors your in-game inventories, containers, and sacks to keep track of resource changes. The mod provides enhanced resource tracking, recipe calculations, and crafting planning—all in-game, with no external applications required.

---

Features

• Automatic Resource Tracking: Monitors player inventory, storage containers (e.g., backpacks, ender chests), and sacks in real time.
• Recipe Management: View, expand, and calculate crafting recipes for Hypixel Skyblock items.
• Crafting Calculator: See required ingredients and missing resources for any recipe and amount.
• Customizable HUD Widget: In-game overlay for quick resource and recipe info, with full customization.
• Data Persistence: All data is saved locally and persists between sessions.
• In-Game Commands & Shortcuts: Access all features via chat commands or keybinds.
• First-Time User Onboarding: Welcome message and instructions on first launch.
• Reminders: In-game reminders to open sacks for first-time setup.

---

Requirements

• Minecraft 1.21.5+
• Fabric Loader 0.16.11+
• Java 21

---

Installation

1. Install Fabric Loader for Minecraft 1.21.5 or newer.
2. Download the latest release jar from the Releases page.
3. Place the jar file in your Minecraft mods folder.
4. Launch Minecraft with the Fabric profile.

---

Usage

• Play normally on Hypixel Skyblock. The mod tracks your resources in the background.
• Use the in-game HUD widget and GUI to view resources, recipes, and plan crafting.
• All data is saved to local JSON files in your Minecraft directory.
• On first run, open all Sacks, Backpacks, and Ender Chests to initialize tracking.

---

Files Created

All mod data is stored in .ir-data/data/ inside your Minecraft directory:

• allcontainerData.json — Storage container data
• inventorydata.json — Player inventory data
• resources.json — All tracked resources (auto-initialized with all supported items)
• widget_config.json — HUD widget settings
• forging.json, gemstone_recipes.json — Recipe data (auto-generated)
• sackNames.txt — List of recognized sack names

---

In-Game Commands

• /ir menu — Open the Sandbox Viewer (resource/recipe GUI)
• /ir widget — Open Widget Customization Menu
• /ir reset — Reset all mod data
• /ir done — Acknowledge reminders
• /ir credits — Show Credits

---

Keyboard Shortcuts

• V — Open Sandbox Viewer
• B — Open Widget Customization
• H — Toggle widget on/off (restores last selected recipe when re-enabled).
• P — Open Positioning HUD directly

Troubleshooting

• Make sure your Minecraft version matches the supported version.
• Use /ir reset to reset all mod data (soft reset)
• Open all Sacks, Backpacks, and Ender Chests at least once for full tracking.
• Use /ir done to acknowledge reminders.
• Check logs for any error messages.
• Restart Minecraft if you encounter issues.

---

License

This project is licensed under the terms of the CC-BY-SA-4.0 License.

---

Credits

Created by Scholiboi

---

Support

For questions, issues, or feature requests, please open an issue on GitHub.