🧰 Vanilla Helper

Quality-of-life helpers for vanilla Minecraft — fair-play, client-side only, compatible with any server.

Vanilla Helper adds the small conveniences vanilla always needed, without ever giving you an unfair advantage. Everything runs on your client: install it, join any vanilla or modded server, and it just works. Every feature can be toggled and fine-tuned individually from an in-game settings screen (default key: V).

✨ Features

🔍 Container search

A search bar above every container screen — chests, barrels, shulker boxes, furnaces, your inventory...

• Non-matching items are dimmed (or matches highlighted) so they stand out instantly
• Matches item names (including anvil-renamed items), item IDs and tooltips — search mending to light up the right enchanted books
• Even searches inside closed shulker boxes and bundles
• Ctrl+F to focus the bar, Esc to leave it

📊 Mini-HUD

Coordinates, facing direction, biome, FPS and an in-game clock. Pick the screen corner, reorder the lines, and choose from 9 text colors.

🛡️ Protections

• Durability alert — sound + message when a tool or armor piece drops below a threshold
• Tool break protection — blocks mining/attacking with a nearly-broken tool
• Drop confirmation — double-press the drop key to throw away valuables, with your own custom item list
• Entity misclick protection — never accidentally hit villagers, iron golems, or named/tamed animals

Sneak to bypass any protection.

🔭 Zoom

Hold (or toggle) C to zoom your view, with an adjustable factor (×2 to ×6).

⏱️ Item despawn timer

A color-coded countdown above dropped items before they despawn. Exact in singleplayer; on servers it is a safe estimate based on when the item appeared on your screen (the real timer can only be shorter).

🧰 More

• Death coordinates — your death spot posted in chat on respawn, with a warning before your items despawn
• Copy coordinates — F6 copies your position to the clipboard (plain or as a /tp command)
• Item counter — tooltips show how many of an item you own across your inventory and the open container

⚖️ Fair play by design

The settings screen groups features into two categories:

• Fair play — everywhere: honest helpers, fine on any server
• Singleplayer only: features that would be unfair in multiplayer (exact phantom timer, weather forecast…) live here, and are automatically disabled when you join a server — whatever the config says

🗺️ Planned

One-click chest sorting, quick-stack to containers, ModMenu integration, and more.

📦 Installation

1. Install Fabric Loader for Minecraft 26.2
2. Drop Fabric API and the Vanilla Helper jar into your mods folder
3. That's it — client-side only, nothing to install on the server

Downloads are on Modrinth.

🛠️ Development

The project uses Fabric Loom with Mojang mappings, Java 25, and split client/main source sets.

./gradlew build        # build the mod (output in build/libs)
./gradlew runClient    # launch a dev client
./gradlew runDatagen   # regenerate generated assets (lang files) — run it on its own, not combined with build

Translations live in the datagen providers (VHEnglishProvider / VHFrenchProvider), not in handwritten JSON. To add a feature, add an entry to the VHFeature enum plus its translation keys — it shows up automatically in the settings screen and the config file (config/vanilla-helper.json).

📄 License

Vanilla Helper is licensed under the MIT License.

---

Le mod est intégralement traduit en français. 🇫🇷