Description
## Where did I put that?
Your storage room has 40 chests. Somewhere there's a stack of redstone, a Mending book and that one enchanted pickaxe. In vanilla you open chest after chest, squinting at every slot.
**Clean Item Finder** adds a small search box above every chest and inventory. Type what you're looking for - matching items get a **yellow frame**, everything else is **dimmed**.
## Features
- **Search box** above chests, barrels, shulker boxes, ender chests, furnaces, hoppers, your own inventory and more.
- **Smart matching** - item names, custom (renamed) names, item ids and **enchantments** ("mending", "sharpness").
- **Looks inside shulker boxes** - a shulker box lights up if something inside it matches.
- **Several words** - "diamond sword" finds items that match both words.
- **"12 found" counter** next to the box.
- **Ctrl+F** jumps straight into the search box; **Enter** or clicking a slot stops typing.
- **Safe typing** - while typing, E doesn't close the screen and Q doesn't drop items.
- Clears itself for the next chest (or remembers your search, if you prefer).
## Controls
| Key | Action |
|---|---|
| Click the box / Ctrl+F | Start typing |
| Enter / click a slot | Stop typing |
| Esc | Close the screen as usual |
## Settings
The file `config/cleanitemfinder.properties` is created on first launch:
- `enabled` (true)
- `rememberSearch` - keep the search for the next chest (false)
- `searchInsideContainers` - look inside shulker boxes (true)
- `searchEnchantments` - match enchantment names (true)
- `highlightColor` (#FFFFD84A), `dimColor` (#B0101010)
## Works on servers
This is a **client-side only** mod. It only highlights items you can already see in the open inventory, using information your game already has. It doesn't open chests for you or reveal anything hidden. Works on any server and on Realms.
## Honest limitations
- It searches the chest you have open - it can't search all chests in your base at once.
- The creative inventory has its own search, so the box isn't added there.
- Shulker box contents are only searched if the server sends them (vanilla servers do).
- Other mods that add a search box in the same spot may overlap.
- The settings are in a config file; there is no in-game settings screen yet.
## Requirements
- Minecraft 1.21 / 1.21.1
- Fabric Loader 0.16 or newer
- Fabric API
- Java 21
## Installation
1. Install Fabric Loader for Minecraft 1.21.1.
2. Put **Fabric API** and **Clean Item Finder** in your `mods` folder.
3. Start the game.
## Modpacks
You are welcome to include this mod in any modpack. No need to ask.
## Also by this author
- **Clean Background FPS** - lower FPS and volume while Minecraft is in the background
- **Clean Auto Reconnect** - automatically rejoins the server after a disconnect
- **Clean Keystrokes** - WASD, mouse buttons and CPS on screen for PvP and streaming
- **Clean Item Mover** - Shift + drag and scroll to move items faster in any inventory
- **Clean Outline** - custom block outline and crosshair: color, thickness, rainbow
- **Clean Chat Heads** - player faces next to chat messages, optional timestamps
- **Light Level Overlay** - press F7 to see where mobs can spawn
- **Clean Ping Display** - real ping numbers in the Tab list
- **Clean Horse Stats** - a horse's speed, jump and health at a glance
- **Clean Info HUD** - coordinates, facing, biome and FPS in a tidy panel
- **Status Effect Timers** - your potion effects as a clean list with countdowns
- **Death Location Helper** - an on-screen arrow back to where you died
- **Item Pickup Notifier** - see everything you pick up at the side of the screen
- **Smooth Zoom** - hold a key to zoom, scroll to change the zoom level
- **Item Container Preview** - see Shulker Box contents in the tooltip
- **Clean Tooltip Enchants** - color-coded enchantments with (MAX) tags
- **Smart Torch Placer** - place torches with one key, optional Auto-Light for mining
- **Smart Crop Harvest** - right-click ripe crops to harvest and replant
- **Floating Damage Indicators** - damage, heal and crit numbers above mobs
- **Smart Tool Safety** - durability warnings and tool break protection
- **Smart Chest Organizer** - sort buttons and quick deposit for chests
- **Dynamic Armor HUD** - armor, held item and arrow durability on screen
- **Smart Auto-Trash** - quickly trash or auto-throw junk items
- **Dynamic Item Glow** - rarity colors and glow for items
## About the images
The project logo is an illustration created with AI assistance; it is not an in-game screenshot. The screenshots in the gallery are real, unedited in-game captures.
