AI Inventory Sorter

AI Inventory Sorter is a Minecraft mod that automatically organizes your inventory using AI. It places items in the optimal slots, ensuring your hotbar and main inventory are efficiently arranged for gameplay.

Features

Hotbar & Main Inventory Sorting
Automatically assigns items to the most appropriate hotbar and inventory slots, following a strict priority order for weapons, tools, armor, utility items, and food.
Intelligent Sectioning
- Left Third: Shulker boxes and storage items
- Middle Third: Tools, weapons, armor, blocks, and miscellaneous items
- Right Third: Food and consumables
Shulker-Aware
Reads shulker box contents for context but always places the box in the designated storage section.
AI-Powered JSON Mapping
Uses Ollama GPT-OSS 20B Cloud model to generate slot mappings.
Robust Parsing
Automatically handles code fences and extraneous text in AI responses, preventing JSON parsing errors.

Requirements

Minecraft 1.21.11
Fabric Loader
Fabric API
Ollama API key

Installation

Place the mod .jar into your mods/ folder.
Configure your Ollama API key in config/aiinventorysort.json.
Launch Minecraft.

FAQ

Q: How do I assign an Ollama API key?
A: Add your API key to config/aiinventorysort.json under apiKey.

Q: Does it support modded items?
A: Yes. The AI will classify modded items such as spears or custom tools according to your defined rules.

Q: What if the AI produces invalid JSON?
A: The mod automatically cleans code fences and extracts the JSON array, preventing MalformedJsonException.

Q: Can I customize slot priorities?
A: Hotbar and main inventory rules are built-in. Advanced users can modify the source code to change priorities, though this is not recommended. I do hope to add this feature soon.

Q: Why did nothing happen to my inventory after the AI finished? A: This is a known bug. Try closing your inventory after clicking the sort button.

Q: How long should it take to sort? A: With a full inventory, it might take up to 15-20 seconds. For a small inventory, you are looking at 5-10 seconds.

Q: Where is my config file? A: If there is no config file, create a file at /config in your instance's directory (click the folder button in Modrinth), name the file aiinventorysort.json and paste this in:

{
  "apiKey": "API_KEY_HERE",
  "snapshotLayout": [],
  "hotbarPins": {},
  "showButtons": true
}

Support

For bug reports or feature requests, feel free to contact me at: scdrichards2012@outlook.com