StashFinder

v0.1.0 — 2026-03-15

🎉 Initial Release

StashFinder is a lightweight, client-side Fabric mod that automatically indexes every chest you open, so you can instantly search for any item and navigate directly to it.

---

✨ Features

📦 Automatic Chest Indexing

• Every chest you open is silently indexed in the background — no extra steps needed
• Chest contents are updated automatically on each open
• If contents haven't changed since last open, the chest is skipped (no unnecessary writes)
• Supports single and double chests
• Data is stored per-world at .minecraft/config/stashfinder/<world>/chests.json
• Corrupted data files are automatically backed up to chests.json.bak

🔍 Search Overlay [F]

• Press F to open a compact search overlay
• Live filtering as you type — results appear instantly
• Results show item icon, quantity, chest name, coordinates, distance and direction arrow
• Results from your current dimension are prioritized — chests in other dimensions appear below, dimmed
• Scroll through results with ↑ ↓ or the mouse wheel — up to 4 rows visible at once with a scrollbar
• Press Enter or click a result to start navigating to that chest

🔃 Sort Button

• A sort button in the top-right of the search overlay lets you change result ordering
• Four modes:
  • 📍 Nearest first — closest chest at the top (default)
  • 📅 Recently indexed — last opened chest at the top
  • 🔢 Most items — fullest chest at the top
  • 🔤 Alphabetical — sorted by chest name
• Sort preference is saved per world and persists between sessions

🕐 Search History

• Recent searches are shown when the overlay is empty
• Click a history entry or press Enter to re-apply it instantly
• Remove individual entries with the ✕ button
• History is saved per world (up to 8 entries by default)

🗂 Chest Records Screen [G]

• Press G to open the full chest records screen
• Left panel: scrollable list of all indexed chests with name, coordinates and distance
• Scroll with mouse wheel or ↑ ↓ keys — scrollbar appears when list overflows
• Right panel: full 27 or 54 slot grid showing exact chest contents
• Hover over any slot to see item name and quantity as a tooltip
• Dimension badge (Overworld / Nether / The End) shown in the top-right corner
• Last updated timestamp shown below the slot grid

✏️ Renaming Chests

• Click the ✏ button next to any chest in the records list to rename it
• Custom names appear in search results, the compass HUD and the records list
• Max 32 characters — clear the name to revert to auto-assigned number (e.g. Chest #3)

🗑️ Deleting Records

• Delete any chest record with confirmation from the records screen
• Deleting a record only removes it from StashFinder's data — the chest in the world is unaffected
• If you open the chest again it will be re-indexed automatically

🧭 Navigation HUD

• After selecting a chest, a compass strip appears at the top-center of the screen
• The strip shows cardinal directions and a cyan marker pointing toward the target chest
• When the target is off-screen, a ◀ or ▶ arrow appears at the strip edge
• An info bar below shows the chest name and distance in meters
• Auto-clears when you come within 5 blocks — shows a "Destination Reached!" toast

🔔 Toast Notifications

• A subtle text notification appears on screen when a chest is indexed or updated
• Chest Indexed (green) — first time a chest is opened
• Chest Updated (cyan) — chest was previously indexed and contents changed
• Destination Reached! (green) — arrived within 5 blocks of navigation target
• Stacks repeated toasts with a ×N counter
• Slow fade-out (800ms) — no background box, clean overlay

⚙️ Settings Screen (Mod Menu)

• StashFinder has a dedicated settings screen accessible via Mod Menu
• Chest Indexing — toggle indexing on or off without removing the mod
• Max Search Results — number of results visible at once in the search overlay (1–12)
• Max Search History — how many recent searches to remember per world (1–20)
• Toast Notifications — toggle toasts on or off
• Toast Position — Top Left / Top Right / Bottom Left / Bottom Right
• Compass Position — Top Left / Top Right
• Keybinds — remappable in Options → Controls → Key Binds → StashFinder

---

🌍 Localization

• English (en_us)
• Turkish (tr_tr)

---

📋 Notes

• Client-side only — no server mod required
• Works in singleplayer and multiplayer
• Barrel, Shulker Box and Ender Chest support planned for a future release