Описание
# 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](https://fabricmc.net/) for Minecraft 1.21.5 or newer.
2. Download the latest release jar from the [Releases](https://github.com/Scholiboi/InventoryReader-HypixelMining/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](LICENSE).
---
## Credits
Created by Scholiboi
---
## Support
For questions, issues, or feature requests, please [open an issue](https://github.com/Scholiboi/InventoryReader-HypixelMining/issues) on GitHub.