Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Links
Tags
Creators
Details
findmyitems
Search every chest you have opened from one place.
findmyitems is a client-side storage catalog for Minecraft. It remembers the contents of containers as you open them, then lets you search, locate, retrieve, deposit, and plan crafting materials without checking every chest individually.
No server installation is required, but the mod is intentionally limited to single-player worlds.
Features
Search all indexed storage
Open a supported container once and findmyitems adds its contents to a searchable local index.
Press B to open the catalog and search across:
- Item names
- Item IDs
- Tooltip text
- Enchantment names
- Enchantment levels
- Items stored inside nested shulker boxes
Searches understand both numbered and Roman-numeral enchantment levels. For example, smite 4 and smite iv return the same items.
Items with different components are kept separate. Two otherwise identical swords with different enchantments are treated as different entries because they are not interchangeable.
The catalog contains three main views:
| View | Shortcut | Purpose |
|---|---|---|
| Items | Ctrl+1 |
Search every indexed item |
| Containers | Ctrl+2 |
Browse indexed containers by distance |
| Crafting | Ctrl+3 |
Calculate the materials required to craft an item |
On macOS, use Cmd instead of Ctrl.
The Items and Containers views can be displayed as either a list or a grid.
Find items across containers
The Items view combines matching items from every indexed container.
Each result shows:
- The total quantity available
- The nearest container holding the item
- The container's position
- Whether the container is close enough for interaction
Highlight containers through walls
Use the ender-eye action to outline a container in the world for five seconds.
The highlight is visible through blocks, making it useful for locating storage behind walls, beneath floors, or inside large storage rooms.
In grid mode, right-click an item to highlight its nearest container.
Retrieve items directly
When a matching container is within normal interaction range, findmyitems can move the requested quantity into your inventory.
The mod performs the normal container interaction in the background:
- The container is opened normally.
- The requested items are transferred.
- The container is closed.
The storage screen is not displayed, but the normal lid animation and sound still occur.
In grid mode, left-click an item to retrieve it.
Deposit matching items
Items can also be moved from your inventory back into a nearby indexed container.
Deposit is deliberately conservative. It is available only when the destination already contains the exact same item, including its components.
findmyitems will not guess where an unfamiliar item belongs.
Search inside shulker boxes
Items stored inside shulker boxes are indexed even when those shulker boxes are themselves stored inside another container.
Nested shulker boxes are supported up to four levels deep.
Filter container screens
A search field is added above ordinary container screens.
Typing into the field dims slots that do not match the search. This is visual filtering only; no items are moved or rearranged.
Plan crafting materials
The Crafting view breaks an item into the materials required to create it.
The resulting tree shows:
- Sub-crafts as indented rows
- Materials already covered by indexed storage in green
- Missing materials in red
- The remaining quantity you need to obtain
For example, a chest may expand into the planks needed to craft it.
A material is expanded into smaller components only when your indexed storage cannot already cover it.
Only crafting-grid recipes are followed. Processes such as smelting and stonecutting are excluded because their recipe relationships can create ambiguous or circular paths.
Supported containers
findmyitems currently supports:
- Chests
- Double chests
- Trapped chests
- Barrels
- Ender chests
- Shulker boxes placed as blocks
Containers added by other mods are not currently supported.
How indexing works
findmyitems records container contents only after you open them.
It does not inspect:
- Containers you have never opened
- Unloaded chunks
- Arbitrary storage elsewhere in the world
- Server-side inventory data unavailable to the client
Nearby indexed containers can be rescanned while their chunks are loaded. This helps keep the catalog synchronized when hoppers, farms, or other systems change their contents.
Your ender chest is treated specially because all ender chests expose the same personal inventory. It remains available at the top of the Containers view even when empty, unless a search filter is active.
Single-player only
findmyitems is active only in single-player worlds.
When connected to a multiplayer server:
- Containers are not indexed
- Existing index data is not used
- The container filter is not added
- The catalog keybind displays an explanatory message instead of opening
This restriction exists because the index represents what a container held when the client last observed it.
In single-player, only the local player can normally change that storage. On a server, another player or server-side system could modify a container without notifying the client, causing the catalog to report items that are no longer present.
A completely client-side mod cannot reliably keep unopened multiplayer containers synchronized.
Installation
findmyitems requires the Fabric mod loader.
Requirements
- Fabric Loader
0.19.3or newer - Fabric API
- Mod Menu
- Cloth Config
Fabric API is the shared API library required by most Fabric mods, including this one.
Mod Menu adds an in-game mod list and provides access to the findmyitems settings screen.
Cloth Config is used to build that settings screen.
Steps
- Install Fabric Loader for Minecraft
26.2. - Download Fabric API, Mod Menu, and Cloth Config for the same Minecraft version.
- Download
findmyitems-VERSION.jarfrom the releases page. - Place all four
.jarfiles in yourmods/folder. - Start Minecraft using the Fabric profile.
Optional integrations
- Shulker Box Tooltip — Displays shulker box contents when hovering over them. It is recommended but not required.
- Sodium — Provides rendering optimizations. It is recommended but not required.
findmyitems indexes the contents of shulker boxes, while Shulker Box Tooltip displays those contents directly in item tooltips.
Usage
Open any supported container to add it to the index. No additional setup is required.
Press B to open the catalog.
The keybind can be changed from:
Options → Controls → Key Binds → Miscellaneous
The catalog has three views, selected using the tabs at the top or their keyboard shortcuts:
| View | Shortcut | Contents |
|---|---|---|
| Items | Ctrl+1 |
Every item in the index, with the nearest container holding it |
| Containers | Ctrl+2 |
Every indexed container, sorted nearest first |
| Crafting | Ctrl+3 |
A material breakdown for a selected item |
On macOS, use Cmd instead of Ctrl.
The Items and Containers views can be shown as a list or grid using the toggle on the right side of the tab row.
Catalog controls
Items view
Each item entry includes three actions:
| Icon | Action |
|---|---|
| Ender eye | Highlight the nearest matching container |
| Hopper | Retrieve the requested quantity |
| Chest | Deposit matching items from your inventory |
Retrieval and deposit are enabled only when the target container is within normal block-interaction range, with one additional block of allowance.
Rows outside that range display the retrieval and deposit actions as disabled. Highlighting remains available from farther away.
When retrieving an item, the mod sends a normal interaction packet that opens the container, transfers the items, and closes it. The container's lid animation and sound occur normally, but its screen is not displayed.
In grid mode:
- Left-click retrieves the item
- Right-click highlights the nearest container
Containers view
The Containers view lists every indexed container with:
- Container type
- Block position
- Distance from the player
Entries are sorted nearest first, except for the player's ender chest, which is placed at the top.
The ender chest remains listed when empty unless a search term is active.
Crafting view
Enter an item name to inspect its material requirements.
Leaving the field empty displays every indexed item that has a supported crafting recipe.
The result is displayed as a tree:
- Indented rows represent sub-crafts, such as planks beneath a chest
- Green rows are fully covered by items already in indexed storage
- Red rows represent materials you still need to obtain
A material is expanded into its own components only when indexed storage cannot already cover it.
Recipes outside the crafting grid, such as smelting and stonecutting, are not followed because their conversions can produce ambiguous or circular paths.
Searching
The search field matches:
- Item names
- Item IDs
- Tooltip text
Enchantment levels match using either numbered or Roman-numeral notation. For example, smite 4 and smite iv return the same results.
Items that differ only by their components are listed separately. Two swords of the same type with different enchantments are treated as separate entries because they are not interchangeable.
Container screen filter
A filter field is added above ordinary container screens.
Typing into the field dims slots whose items do not match the search.
The filter changes only what is drawn. It does not move, rearrange, or modify any items.
Configuration
Settings are available from the findmyitems entry in Mod Menu.
The configuration file is stored at:
config/findmyitems.json
| Setting | JSON key | Default | Range | Description |
|---|---|---|---|---|
| Rescan interval | rescanIntervalSeconds |
5 seconds |
0–30 |
How often nearby indexed containers are reread. Set to 0 to disable automatic rescanning. |
| Search distance | searchDistanceBlocks |
64 blocks |
0–512 |
Maximum distance at which an indexed container may be reread. Set to 0 for unlimited distance. |
Automatic rescanning applies only when the container's chunk is currently loaded.
Reducing the search distance may improve frame times in worlds containing very large storage systems.
The catalog keybind is managed by Minecraft's normal key-mapping system and is not stored in this configuration file.
Index storage
Container indexes are stored separately from the main configuration:
config/findmyitems/worlds/ID.json
Each index is associated with:
- The world save directory
- The player's UUID
This prevents worlds with identical display names from sharing container data and keeps separate players' indexes isolated.
Privacy and server compatibility
All indexing data is stored locally in your Minecraft directory.
findmyitems:
- Does not upload container data
- Does not require a server-side mod
- Does not inspect unopened containers
- Does not operate on multiplayer servers
- Does not modify the world save to store its index
Everything is handled by the local Minecraft client. Features Search all indexed storage
The Items view combines matching items from every indexed container.
Each result shows:
The total quantity available The nearest container holding the item The container's position Whether the container is close enough for interaction Highlight containers through walls
Use the ender-eye action to outline a container in the world for five seconds.
The highlight is visible through blocks, making it useful for locating storage behind walls, beneath floors, or inside large storage rooms.
In grid mode, right-click an item to highlight its nearest container.
Retrieve items directly
When a matching container is within normal interaction range, findmyitems can move the requested quantity into your inventory.
The mod performs the normal container interaction in the background:
The container is opened normally. The requested items are transferred. The container is closed.
The storage screen is not displayed, but the normal lid animation and sound still occur.
In grid mode, left-click an item to retrieve it.
Deposit matching items
Items can also be moved from your inventory back into a nearby indexed container.
Deposit is deliberately conservative. It is available only when the destination already contains the exact same item, including its components.
findmyitems will not guess where an unfamiliar item belongs.
Search inside shulker boxes
Items stored inside shulker boxes are indexed even when those shulker boxes are themselves stored inside another container.
Nested shulker boxes are supported up to four levels deep.
Filter container screens
A search field is added above ordinary container screens.
Typing into the field dims slots that do not match the search. This is visual filtering only; no items are moved or rearranged.
Plan crafting materials
The Crafting view breaks an item into the materials required to create it.
The resulting tree shows:
Sub-crafts as indented rows Materials already covered by indexed storage in green Missing materials in red The remaining quantity you need to obtain
For example, a chest may expand into the planks needed to craft it.
A material is expanded into smaller components only when your indexed storage cannot already cover it.
Only crafting-grid recipes are followed. Processes such as smelting and stonecutting are excluded because their recipe relationships can create ambiguous or circular paths.
Supported containers
findmyitems currently supports:
Chests Double chests Trapped chests Barrels Ender chests Shulker boxes placed as blocks
Containers added by other mods are not currently supported.
How indexing works
findmyitems records container contents only after you open them.
It does not inspect:
Containers you have never opened Unloaded chunks Arbitrary storage elsewhere in the world Server-side inventory data unavailable to the client
Nearby indexed containers can be rescanned while their chunks are loaded. This helps keep the catalog synchronized when hoppers, farms, or other systems change their contents.
Your ender chest is treated specially because all ender chests expose the same personal inventory. It remains available at the top of the Containers view even when empty, unless a search filter is active.
Single-player only
findmyitems is active only in single-player worlds.
When connected to a multiplayer server:
Containers are not indexed Existing index data is not used The container filter is not added The catalog keybind displays an explanatory message instead of opening
This restriction exists because the index represents what a container held when the client last observed it.
In single-player, only the local player can normally change that storage. On a server, another player or server-side system could modify a container without notifying the client, causing the catalog to report items that are no longer present.
A completely client-side mod cannot reliably keep unopened multiplayer containers synchronized.
Installation
findmyitems requires the Fabric mod loader.
Requirements Fabric API Mod Menu Cloth Config Steps Install Fabric Loader for Minecraft 26.2. Download Fabric API, Mod Menu, and Cloth Config for the same Minecraft version. Download the latest findmyitems-VERSION.jar. Place all four mod files in your Minecraft mods folder. Launch Minecraft using the Fabric profile. Optional integrations Shulker Box Tooltip
Shulker Box Tooltip is also recommended but not required.
findmyitems indexes items stored inside shulker boxes. Shulker Box Tooltip complements this by displaying those contents directly in item tooltips.
Usage
Open any supported container to add it to the index.
Press B to open the catalog.
The keybind can be changed from:
Options → Controls → Key Binds → Miscellaneous
No additional setup is required.
Catalog controls Items view
Each item entry includes three actions:
Icon Action Ender eye Highlight the nearest matching container Hopper Retrieve the requested quantity Chest Deposit matching items from your inventory
Retrieval and deposit are enabled only when the target container is within normal block-interaction range, with one additional block of allowance.
Highlighting remains available from farther away.
Containers view
The Containers view lists every indexed container with:
Container type Block position Distance from the player
Entries are sorted nearest first, except for the player's ender chest, which is placed at the top.
Crafting view
Enter an item name to inspect its material requirements.
Leaving the field empty displays every indexed item that has a supported crafting recipe.
Configuration
Settings are available from the findmyitems entry in Mod Menu.
The configuration file is stored at:
config/findmyitems.json Setting JSON key Default Range Description Rescan interval rescanIntervalSeconds 5 seconds 0–30 How often nearby indexed containers are reread. Set to 0 to disable automatic rescanning. Search distance searchDistanceBlocks 64 blocks 0–512 Maximum distance at which an indexed container may be reread. Set to 0 for unlimited distance.
Automatic rescanning applies only when the container's chunk is currently loaded.
Reducing the search distance may improve frame times in worlds containing very large storage systems.
The catalog keybind is managed by Minecraft's normal key-mapping system and is not stored in this configuration file.
Index storage
Container indexes are stored separately from the main configuration:
config/findmyitems/worlds/ID.json
Each index is associated with both:
The world save directory The player's UUID
This prevents worlds with identical display names from sharing container data and keeps separate players' indexes isolated.
Privacy and server compatibility
All indexing data is stored locally in your Minecraft directory.
findmyitems:
Does not upload container data Does not require a server-side mod Does not inspect unopened containers Does not operate on multiplayer servers Does not modify the world save to store its index
Everything is handled by the local Minecraft client.Deposit is deliberately conservative. It is available only when the destination already contains the exact same item, including its components.
findmyitems will not guess where an unfamiliar item belongs.
Search inside shulker boxes
Items stored inside shulker boxes are indexed even when those shulker boxes are themselves stored inside another container.
Nested shulker boxes are supported up to four levels deep.
Filter container screens
A search field is added above ordinary container screens.
Typing into the field dims slots that do not match the search. This is visual filtering only; no items are moved or rearranged.
Plan crafting materials
The Crafting view breaks an item into the materials required to create it.
The resulting tree shows:
- Sub-crafts as indented rows
- Materials already covered by indexed storage in green
- Missing materials in red
- The remaining quantity you need to obtain
For example, a chest may expand into the planks needed to craft it.
A material is expanded into smaller components only when your indexed storage cannot already cover it.
Only crafting-grid recipes are followed. Processes such as smelting and stonecutting are excluded because their recipe relationships can create ambiguous or circular paths.
Supported containers
findmyitems currently supports:
- Chests
- Double chests
- Trapped chests
- Barrels
- Ender chests
- Shulker boxes placed as blocks
Containers added by other mods are not currently supported.
How indexing works
findmyitems records container contents only after you open them.
It does not inspect:
- Containers you have never opened
- Unloaded chunks
- Arbitrary storage elsewhere in the world
- Server-side inventory data unavailable to the client
Nearby indexed containers can be rescanned while their chunks are loaded. This helps keep the catalog synchronized when hoppers, farms, or other systems change their contents.
Your ender chest is treated specially because all ender chests expose the same personal inventory. It remains available at the top of the Containers view even when empty, unless a search filter is active.
Single-player only
findmyitems is active only in single-player worlds.
When connected to a multiplayer server:
- Containers are not indexed
- Existing index data is not used
- The container filter is not added
- The catalog keybind displays an explanatory message instead of opening
This restriction exists because the index represents what a container held when the client last observed it.
In single-player, only the local player can normally change that storage. On a server, another player or server-side system could modify a container without notifying the client, causing the catalog to report items that are no longer present.
A completely client-side mod cannot reliably keep unopened multiplayer containers synchronized.
Installation
findmyitems requires the Fabric mod loader.
Requirements
- Fabric API
- Mod Menu
- Cloth Config
Steps
- Install Fabric Loader for Minecraft 26.2.
- Download Fabric API, Mod Menu, and Cloth Config for the same Minecraft version.
- Download the latest
findmyitems-VERSION.jar. - Place all four mod files in your Minecraft
modsfolder. - Launch Minecraft using the Fabric profile.
Optional integrations
Shulker Box Tooltip
Shulker Box Tooltip is also recommended but not required.
findmyitems indexes items stored inside shulker boxes. Shulker Box Tooltip complements this by displaying those contents directly in item tooltips.
Usage
Open any supported container to add it to the index.
Press B to open the catalog.
The keybind can be changed from:
Options → Controls → Key Binds → Miscellaneous
No additional setup is required.
Catalog controls
Items view
Each item entry includes three actions:
| Icon | Action |
|---|---|
| Ender eye | Highlight the nearest matching container |
| Hopper | Retrieve the requested quantity |
| Chest | Deposit matching items from your inventory |
Retrieval and deposit are enabled only when the target container is within normal block-interaction range, with one additional block of allowance.
Highlighting remains available from farther away.
Containers view
The Containers view lists every indexed container with:
- Container type
- Block position
- Distance from the player
Entries are sorted nearest first, except for the player's ender chest, which is placed at the top.
Crafting view
Enter an item name to inspect its material requirements.
Leaving the field empty displays every indexed item that has a supported crafting recipe.
Configuration
Settings are available from the findmyitems entry in Mod Menu.
The configuration file is stored at:
config/findmyitems.json
| Setting | JSON key | Default | Range | Description |
|---|---|---|---|---|
| Rescan interval | rescanIntervalSeconds |
5 seconds | 0–30 | How often nearby indexed containers are reread. Set to 0 to disable automatic rescanning. |
| Search distance | searchDistanceBlocks |
64 blocks | 0–512 | Maximum distance at which an indexed container may be reread. Set to 0 for unlimited distance. |
Automatic rescanning applies only when the container's chunk is currently loaded.
Reducing the search distance may improve frame times in worlds containing very large storage systems.
The catalog keybind is managed by Minecraft's normal key-mapping system and is not stored in this configuration file.
Index storage
Container indexes are stored separately from the main configuration:
config/findmyitems/worlds/ID.json
Each index is associated with both:
- The world save directory
- The player's UUID
This prevents worlds with identical display names from sharing container data and keeps separate players' indexes isolated.
Privacy and server compatibility
All indexing data is stored locally in your Minecraft directory.
findmyitems:
- Does not upload container data
- Does not require a server-side mod
- Does not inspect unopened containers
- Does not operate on multiplayer servers
- Does not modify the world save to store its index
Everything is handled by the local Minecraft client.
- Fabric Loader
0.19.3or newer - Fabric API — the shared API library that most Fabric mods, including this one, require
- Mod Menu — adds an in-game mod list and gives this mod its settings screen
- Cloth Config — the library used to build that settings screen
Steps:
- Install Fabric Loader for Minecraft
26.2. - Download Fabric API, Mod Menu, and Cloth Config for the same Minecraft version.
- Download
findmyitems-VERSION.jarfrom the releases page. - Place all four
.jarfiles in yourmods/folder. - Start Minecraft using the Fabric profile.
Optional:
- Shulker Box Tooltip — displays shulker box contents on hover. It is listed as a recommended dependency and is not required. This mod indexes the contents of shulker boxes; that mod displays them in a tooltip.
- Sodium — a rendering optimization mod, listed as recommended and not required.
Usage
Open a container to add it to the index. No other setup is required.
Press B to open the catalog. The keybind can be changed in the vanilla Options → Controls screen, under the Miscellaneous category.
The catalog has three views, selected with the tabs at the top or with keyboard shortcuts:
| View | Shortcut | Contents |
|---|---|---|
| Items | Ctrl+1 |
Every item in the index, with the nearest container holding it |
| Containers | Ctrl+2 |
Every container in the index, nearest first |
| Crafting | Ctrl+3 |
Material breakdown for a chosen item |
On macOS, use Cmd in place of Ctrl.
The Items and Containers views can be shown as a list or as a grid, using the toggle on the right of the tab row.
Items view
Each row shows an item, the number held across all indexed containers, and the position of the nearest container holding it. Each row has three buttons:
- Ender eye — outlines the container in the world for five seconds. The outline is drawn through blocks, so it is visible from a distance and behind walls.
- Hopper — moves the amount in the amount field from the container into your inventory.
- Chest — moves matching items from your inventory back into the container.
Retrieval and deposit require the container to be within block interaction range: the range in which you could right-click it, plus one block of allowance. Rows outside that range show both buttons as disabled; the ender eye button still works.
Deposit is intentionally limited: it is offered only when the target container already holds that exact item, including its components. The mod does not choose a destination for an item it has never seen stored.
When you retrieve an item, the mod sends a normal interaction packet that opens the container on the server, moves the items, and then closes it. The container's lid animation and sound occur as they would if you opened it by hand. The container's own screen is not displayed.
In the grid layout, left-click retrieves and right-click highlights.
Containers view
Lists every indexed container with its type and position, nearest first. Your ender chest is placed at the top of the list and remains listed when it is empty, unless a search term is active.
Crafting view
Type an item name, or leave the field empty to list every item that has a crafting recipe and select one.
The result is a tree of the materials required:
- Indented rows are sub-crafts, for example planks listed beneath a chest.
- A row shown in green is fully covered by items already in your containers.
- A row shown in red is a shortfall you must obtain yourself.
A material is expanded into its own components only when the index cannot already cover it. Recipes that are not crafting-table recipes, such as smelting and stonecutting, are not followed, because those conversions run in both directions and would produce cycles.
Searching
The search field matches item names, item ids, and tooltip text.
- Enchantment levels match in either notation.
smite 4andsmite ivreturn the same item. - Items that differ only by their components are listed separately. Two swords of the same type with different enchantments are two entries, because they are not interchangeable.
Container screen filter
A filter field is added above ordinary container screens. Typing in it dims the slots whose items do not match. It changes only what is drawn; no items are moved.
Configuration
Settings are available in Mod Menu, on the findmyitems entry. They are stored in config/findmyitems.json inside your Minecraft directory.
| Setting | JSON key | Default | Range | Description |
|---|---|---|---|---|
| Rescan interval | rescanIntervalSeconds |
5 |
0–30 |
How often indexed containers near you are re-read, in seconds. 0 disables re-scanning, so entries update only when you open a container. |
| Search distance | searchDistanceBlocks |
64 |
0–512 |
How far from you a container may be and still be re-read. 0 means unlimited. Lower this if re-scanning causes a frame time increase in a large base. |
Re-scanning applies only to containers whose chunks are currently loaded.
The keybind is not stored in this file. It is a standard Minecraft key mapping and is stored with your other controls.
The index itself is stored separately, at config/findmyitems/worlds/ID.json, where ID identifies the world save and player. Index files are keyed by save directory and player UUID, so two saves with the same displayed name do not share an index.


