# \ud83d\udd0d Item Finder<\/p>\n
**Never lose track of your items again.**
\nItem 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.<\/p>\n
—<\/p>\n
## \ud83d\udcf8 Screenshots<\/p>\n
\n*Open the search screen with a single keypress \u2014 the game keeps running in the background*<\/p>\n
\n*Type “stone” and see 93 matching items as icons. Click one to scan, or press Enter to search instantly*<\/p>\n
\n*Found containers glow yellow. Particles stream toward them. The HUD shows name and distance for each*<\/p>\n
\n*Everything is configurable in-game \u2014 no config files to edit*<\/p>\n
—<\/p>\n
## \ud83c\udfac How It Works<\/p>\n
1. Press **Y** to open the search screen
\n2. Type a keyword, a grid of matching items appears instantly
\n3. **Click an item** to scan for that exact item, or press **Enter** to search without touching the mouse, or press **Scan All Matches** to find every container holding anything with that keyword
\n4. Results appear in the GUI and optionally in chat
\n5. Matching containers **glow yellow** in the world
\n6. A **particle trail** flows from you toward each container
\n7. Open a highlighted container and it automatically clears from the list<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
### \ud83d\udd0e Smart Search<\/p>\n
**Two search modes:**
\n– **Exact pick**: click an item icon from the visual grid for a precise match
\n– **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 \u2014 everything at once)<\/p>\n
**Enter key shortcut**: configurable behavior when you press Enter:
\n– **Off**: Enter does nothing, use mouse as normal
\n– **Pick first result**: instantly scans for the top item in the grid without clicking
\n– **Scan all matches**: instantly runs a keyword scan across all containers<\/p>\n
**Search language toggle**: search by English item IDs or your game’s display language<\/p>\n
### \ud83d\udce6 Supports All Storage Types<\/p>\n
| Container | \u2705 |
\n|—|—|
\n| Chest | \u2705 |
\n| Trapped Chest | \u2705 |
\n| Barrel | \u2705 |
\n| Shulker Box | \u2705 |
\n| Ender Chest | \u2705 |
\n| Furnace | \u2705 |
\n| Smoker | \u2705 |
\n| Blast Furnace | \u2705 |
\n| Hopper | \u2705 |
\n| Dispenser | \u2705 |
\n| Dropper | \u2705 |
\n| Minecart with Chest | \u2705 |
\n| Chest Boat | \u2705 |<\/p>\n
### \ud83d\udfe1 Container Highlighting
\n– Matching containers get a **glowing yellow outline** in the world
\n– Pulse animation (toggleable)
\n– Auto-fades after a configurable duration<\/p>\n
### \u2728 Particle Trail
\n– Particles stream from your position toward each found container
\n– The **nearest container** gets a stronger, brighter trail
\n– **8 particle types:** Flame \u00b7 Enchant \u00b7 End Rod \u00b7 Soul Fire \u00b7 Witch \u00b7 Dragon Breath \u00b7 Portal \u00b7 Happy Villager<\/p>\n
### \ud83d\udccb HUD Overlay
\n– Panel in the **top-right corner** shows container names and distances while highlights are active
\n– Shows whether results are from **Server** (real-time) or **Cache** (local)
\n– Disappears automatically when highlights expire<\/p>\n
### \ud83d\udcbe Local Cache (Multiplayer without server mod)
\nWhen playing on a server without the mod installed server-side, Item Finder falls back to a **local cache**:
\n– Every container you open gets its contents saved locally
\n– Cache is **persistent**, data from weeks ago is still remembered
\n– Each server has its **own separate cache file**
\n– Results show how old the data is (e.g. `3d ago`) so you know how fresh it is
\n– A warning is always shown when results come from cache<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
Press **\u2699 Config** in the search screen, or access it via **Mod Menu**.<\/p>\n
| Setting | Description | Default |
\n|—|—|—|
\n| Scan Radius | How many blocks away to search | 50 |
\n| Highlight Duration | How long the glow stays (seconds) | 10 |
\n| Highlight Pulse | Animate the outline | ON |
\n| Sort By | Nearest first or most items first | Nearest |
\n| Send to Chat | Print results in chat | ON |
\n| Particle Trail | Show particle path to containers | ON |
\n| Particle Type | Which particle effect to use | END ROD |
\n| Search Language | English ID or game display language | English |
\n| Enter Key | What pressing Enter does: Off \/ Pick first \/ Scan all | Pick First Result |<\/p>\n
All settings save automatically when you close the config panel.<\/p>\n
—<\/p>\n
## \u2328\ufe0f Keyboard Controls<\/p>\n
| Action | Default Key |
\n|—|—|
\n| Open Item Finder | **Y** |
\n| Search \/ Confirm | **Enter** (configurable behavior) |
\n| Back \/ Close | **ESC** |<\/p>\n
Change the open key in **Options \u2192 Controls \u2192 Key Binds \u2192 Item Finder**.<\/p>\n
—<\/p>\n
## \ud83c\udfae Controller Support<\/p>\n
Item Finder works with controllers via Controllify (install separately).<\/p>\n
Once Controllify is installed, map the following in its settings:<\/p>\n
| Action | Suggested Button |
\n|—|—|
\n| Open Item Finder | **Y** (Xbox) \/ **Triangle** (PlayStation) |
\n| Confirm \/ Enter | **A** (Xbox) \/ **Cross** (PlayStation) |
\n| Back \/ Close | **B** (Xbox) \/ **Circle** (PlayStation) |<\/p>\n
> **Tip:** Set Enter Key to **”Pick first result”** 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.<\/p>\n
—<\/p>\n
## \ud83d\udda5\ufe0f Server Support<\/p>\n
| Scenario | Works? | Mode |
\n|—|—|—|
\n| Singleplayer | \u2705 | Real-time scan |
\n| Open to LAN (you are host) | \u2705 | Real-time scan |
\n| Server with mod + your client has mod | \u2705 | Real-time scan |
\n| Server without mod + your client has mod | \u2705 | Cache mode |
\n| Your client does not have mod | \u274c | \u2014 |<\/p>\n
> **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.<\/p>\n
> **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.<\/p>\n
—<\/p>\n
## \ud83d\udce5 Installation<\/p>\n
### Requirements
\n– Minecraft **1.21.5**
\n– Fabric Loader **0.18.4+**
\n– Fabric API<\/p>\n
### Optional but recommended
\n– Mod Menu: access config from the mods list
\n– Controllify: controller support<\/p>\n
### Steps
\n1. Install Fabric for Minecraft 1.21.5
\n2. Download **Fabric API** and place it in your `.minecraft\/mods\/` folder
\n3. Download **Item Finder** and place it in your `.minecraft\/mods\/` folder
\n4. Launch Minecraft with the Fabric profile<\/p>\n
—<\/p>\n
## \ud83c\udf10 Languages<\/p>\n
Fully translated into **15 languages**, follows your Minecraft language setting automatically.<\/p>\n
English \u00b7 Indonesian \u00b7 Malay \u00b7 Chinese (Simplified) \u00b7 German \u00b7 Japanese \u00b7 Portugese (Brazil) \u00b7 Russian \u00b7 Spanish \u00b7 French \u00b7 Italian \u00b7 Korean \u00b7 Dutch \u00b7 Polish \u00b7 Turkish<\/p>\n
Change at **Options \u2192 Language**.<\/p>\n
—<\/p>\n
## \u26a0\ufe0f Known Limitations<\/p>\n
– In cache mode, only containers you have personally opened are searchable
\n– Cache data can be outdated if other players changed container contents
\n– Shulker Boxes inside your inventory are not scanned \u2014 only placed ones in the world
\n– Ender Chest shows only your own items
\n– Containers outside your loaded chunk radius cannot be detected<\/p>\n
—<\/p>\n
## \ud83d\udcdc License<\/p>\n
This project is licensed under the MIT License.<\/p>\n
You are free to use, modify, and include this project in modpacks.
\nAttribution is appreciated.<\/p>\n
—<\/p>\n
## \ud83d\udc1b Issues & Feedback<\/p>\n
Found a bug or have a suggestion? Open an issue on GitHub.
\nPlease include your Minecraft version, mod version, and steps to reproduce.<\/p>\n","protected":false},"excerpt":{"rendered":"
A Fabric mod to quickly locate items in nearby containers with visual guidance.<\/p>\n","protected":false},"featured_media":86976,"template":"","meta":{"_minecraft_slug":"itemfinder-fabric","_minecraft_project_id":"A14TUuc3","_minecraft_author":"FadhlanPutra","_minecraft_license":"MIT","_minecraft_downloads":8,"_minecraft_follows":0,"_minecraft_client_side":"optional","_minecraft_server_side":"optional","_minecraft_storage_type":"zip","_minecraft_archive_name":"itemfinder-fabric.zip","_minecraft_size_bytes":83677,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:57:58.375654Z","_minecraft_date_created":"2026-05-07T23:38:09.966955Z","_minecraft_date_modified":"2026-05-04T14:44:54.756366Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/itemfinder-fabric","_minecraft_icon_attachment_id":86976,"_minecraft_imported_at":"2026-06-04T23:15:37+00:00","_minecraft_import_hash":"436f28339844e5fd8383290b9ed03c49","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,89,91,92],"mod_loader":[99],"minecraft_version":[78],"class_list":["post-86975","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-game-mechanics","mod_category-storage","mod_category-utility","mod_loader-fabric","minecraft_version-1-21-5"],"yoast_head":"\n