chestray

a minecraft java mod that shows you where nearby chests, trapped chests, barrels, shulkers, hoppers, droppers, and ender chests are using their icons. once opened, the contents of the storage container is also displayed (default hotkey is x, can be configured in hotkey settings)

by house, of houseofmates

modrinth link

modrinth

features

• storage detection: shows location of nearby chests, trapped chests, barrels, shulkers, hoppers, droppers, and ender chests.
• inventory hud: displays container contents as a high-fidelity 9x3 or 9x6 grid once opened.
• toggle keybind: press x to enable/disable (default).
• distance scaling: icons scale with distance for perfect readability.

installation tutorial

⚠ recommended setup ( linux + prism launcher )

the absolute best way to play minecraft (java ofc) is on linux using prism launcher. it is faster, more secure, and easier to manage than any other method.

1. install prism launcher from your linux package manager (flatpak, pacman, apt, etc).
2. create a new instance (select minecraft 1.21.8, 1.21.9, 1.21.10, or 1.21.11 (recommended) and select fabric loader).
3. right-click your new instance and click "edit".
4. go to the "mods" tab on the left.
5. click "add" and select the chestray*.jar file you downloaded (don't forget fabric api too).
6. launch and enjoy superior performance.

---

windows

prism launcher (highly recommended)

1. download prism launcher for windows.
2. create a new instance (1.21.1 + fabric).
3. right-click the instance > edit > mods > add.
4. select chestray*.jar and fabric api.

official launcher

1. install fabric loader for 1.21.1.
2. press win + r on your keyboard.
3. type %appdata%\.minecraft\mods and hit enter.
4. drag chestray*.jar and fabric api into this folder.

curseforge app

1. open your profile.
2. click the three dots menu > open folder.
3. open the mods folder.
4. drag chestray*.jar inside.

modrinth app

1. click on your profile.
2. click the folder icon to open the instance folder.
3. open mods and drop chestray*.jar inside.

multimc

1. right-click your instance > edit instance.
2. select "loader mods" on the left.
3. click "add" and select chestray*.jar.

---

macos

prism launcher (highly recommended)

1. download prism launcher for macos.
2. create a new instance (1.21.1 + fabric).
3. right-click the instance > edit > mods > add.
4. select chestray*.jar and fabric api.

official launcher

1. install fabric loader.
2. open finder and press cmd + shift + g.
3. type ~/Library/Application Support/minecraft/mods.
4. drag chestray*.jar and fabric api into this folder.

multimc

1. right-click your instance > edit instance.
2. select "loader mods".
3. drag chestray*.jar into the window.

---

linux

prism launcher (native & recommended)

see the recommended setup section at the top. this is the way.

official launcher

1. install fabric loader.
2. open your terminal or file manager.
3. navigate to ~/.minecraft/mods.
4. paste chestray*.jar and fabric api here.

atlauncher / gdlauncher / others

1. open the instance settings or folder view.
2. locate the mods directory.
3. drop chestray*.jar inside.

using

press x, or change the hotkey in your minecraft hotkey settings, to toggle the mod :)

building from source

./gradlew build

...ps... if you're a fan of friendly dupe servers with free OP kits & items, consider joining dupemates.playit.pub ;)


### housekeeping

Temporary scripts and LLM session notes are ignored by git. Use `./gradlew purgeUnneeded` to delete them from the workspace.

See `LLM_NOTES.md` for the designated notes file.

See `CONTRIBUTING.md` for development guidelines and LLM workflow.