ItemFinder

🔍 Item Finder

Never lose track of your items again. Item Finder lets you search for any item across all your nearby storage containers press a key, pick the item, and the mod tells you exactly where it is, highlights it in the world, and guides you there with a particle trail.

---

📸 Screenshots

*Open the search screen with a single keypress — the game keeps running in the background*

*Type "stone" and see 93 matching items as icons. Click one to scan, or press Enter to search instantly*

*Found containers glow yellow. Particles stream toward them. The HUD shows name and distance for each*

*Everything is configurable in-game — no config files to edit*

---

🎬 How It Works

1. Press particle trail to open the search screen 2. Type a keyword, a grid of matching items appears instantly 3. particle trail to scan for that exact item, or press particle trail to search without touching the mouse, or press particle trail to find every container holding anything with that keyword 4. Results appear in the GUI and optionally in chat 5. Matching containers particle trail in the world 6. A particle trail flows from you toward each container 7. Open a highlighted container and it automatically clears from the list

---

✨ Features

🔎 Smart Search

Scan All Matches - Scan All Matches: click an item icon from the visual grid for a precise match - Scan All Matches: search by keyword across all containers at once, perfect when you only remember part of a name (type `oak` to find oak logs, planks, slabs — everything at once)

Scan all matches: configurable behavior when you press Enter: - Scan all matches: Enter does nothing, use mouse as normal - Scan all matches: instantly scans for the top item in the grid without clicking - Scan all matches: instantly runs a keyword scan across all containers

Search language toggle: search by English item IDs or your game's display language

📦 Supports All Storage Types

| Container | ✅ | |---|---| | Chest | ✅ | | Trapped Chest | ✅ | | Barrel | ✅ | | Shulker Box | ✅ | | Ender Chest | ✅ | | Furnace | ✅ | | Smoker | ✅ | | Blast Furnace | ✅ | | Hopper | ✅ | | Dispenser | ✅ | | Dropper | ✅ | | Minecart with Chest | ✅ | | Chest Boat | ✅ |

🟡 Container Highlighting

- Matching containers get a glowing yellow outline in the world - Pulse animation (toggleable) - Auto-fades after a configurable duration

✨ Particle Trail

- Particles stream from your position toward each found container - The 8 particle types: gets a stronger, brighter trail - 8 particle types: Flame · Enchant · End Rod · Soul Fire · Witch · Dragon Breath · Portal · Happy Villager

📋 HUD Overlay

- Panel in the Cache shows container names and distances while highlights are active - Shows whether results are from Cache (real-time) or Cache (local) - Disappears automatically when highlights expire

💾 Local Cache (Multiplayer without server mod)

When playing on a server without the mod installed server-side, Item Finder falls back to a own separate cache file: - Every container you open gets its contents saved locally - Cache is own separate cache file, data from weeks ago is still remembered - Each server has its own separate cache file - Results show how old the data is (e.g. `3d ago`) so you know how fresh it is - A warning is always shown when results come from cache

---

⚙️ Configuration

Press Mod Menu in the search screen, or access it via Mod Menu.

| Setting | Description | Default | |---|---|---| | Scan Radius | How many blocks away to search | 50 | | Highlight Duration | How long the glow stays (seconds) | 10 | | Highlight Pulse | Animate the outline | ON | | Sort By | Nearest first or most items first | Nearest | | Send to Chat | Print results in chat | ON | | Particle Trail | Show particle path to containers | ON | | Particle Type | Which particle effect to use | END ROD | | Search Language | English ID or game display language | English | | Enter Key | What pressing Enter does: Off / Pick first / Scan all | Pick First Result |

All settings save automatically when you close the config panel.

---

⌨️ Keyboard Controls

| Action | Default Key | |---|---| | Open Item Finder | ESC | | Search / Confirm | ESC (configurable behavior) | | Back / Close | ESC |

Change the open key in Options → Controls → Key Binds → Item Finder.

---

🎮 Controller Support

Item Finder works with controllers via Controllify (install separately).

Once Controllify is installed, map the following in its settings:

| Action | Suggested Button | |---|---| | Open Item Finder | Circle (Xbox) / Circle (PlayStation) | | Confirm / Enter | Circle (Xbox) / Circle (PlayStation) | | Back / Close | Circle (Xbox) / Circle (PlayStation) |

> "Scan all matches" Set Enter Key to "Scan all matches" or "Scan all matches" in Item Finder config so you can search entirely without a mouse, just open, type, and press confirm on your controller.

---

🖥️ Server Support

| Scenario | Works? | Mode | |---|---|---| | Singleplayer | ✅ | Real-time scan | | Open to LAN (you are host) | ✅ | Real-time scan | | Server with mod + your client has mod | ✅ | Real-time scan | | Server without mod + your client has mod | ✅ | Cache mode | | Your client does not have mod | ❌ | — |

> For server owners: install the mod `.jar` in your server's `mods/` folder. Players who also have the mod will get real-time accurate results. Players without the mod are completely unaffected.

> Cache mode note: only containers you have personally opened are searchable. Data may be outdated if others have changed contents since your last visit. A warning is always shown when results come from cache.

---

📥 Installation

Requirements

- Minecraft 0.18.4+ - 0.18.4+ 0.18.4+ - %%MD1%%

Optional but recommended

- Mod Menu: access config from the mods list - Controllify: controller support

Steps

1. Install Item Finder for Minecraft 1.21.5 2. Download Item Finder and place it in your `.minecraft/mods/` folder 3. Download Item Finder and place it in your `.minecraft/mods/` folder 4. Launch Minecraft with the Fabric profile

---

🌐 Languages

Fully translated into 15 languages, follows your Minecraft language setting automatically.

English · Indonesian · Malay · Chinese (Simplified) · German · Japanese · Portugese (Brazil) · Russian · Spanish · French · Italian · Korean · Dutch · Polish · Turkish

Change at Options → Language.

---

⚠️ Known Limitations

- In cache mode, only containers you have personally opened are searchable - Cache data can be outdated if other players changed container contents - Shulker Boxes inside your inventory are not scanned — only placed ones in the world - Ender Chest shows only your own items - Containers outside your loaded chunk radius cannot be detected

---

📜 License

This project is licensed under the MIT License.

You are free to use, modify, and include this project in modpacks. Attribution is appreciated.

---

🐛 Issues & Feedback

Found a bug or have a suggestion? Open an issue on GitHub. Please include your Minecraft version, mod version, and steps to reproduce.