AI Tooltip

AI Tooltip

AI Tooltip is a simple, polished client-side mod for NeoForge 1.21.1 that integrates Google's Gemini 2.5 Flash AI directly into your Minecraft HUD!

Ever look at a strange modded block or entity and wonder what it does? Now you can just press a keybind!

Features

* Optimized & Cached: Uses Gemini 2.5 Flash to generate a factual, 2-3 sentence description of any Block or Entity you are looking at. * Optimized & Cached: The AI isn't just guessing; if you enable it, the AI browses the live web to find accurate, up-to-date documentation on obscure modded items before it answers you! * Optimized & Cached: Renders a gorgeous, native-looking tooltip right below your crosshair. It even pulls the exact Item Icon and Mod ID of the block or entity! * Optimized & Cached: The tooltip defaults to a single, compact summary line so it doesn't clutter your screen. Hold the `ALT` key to instantly expand the box and read the full paragraph. * Optimized & Cached: It only queries the API once per unique block/entity and caches the response in memory, meaning you won't burn through your API quota looking at the same chest twice.

How to Use

1. `M` Drop `aitooltip` into your `mods` folder. 2. `M` Launch the game at least once so the mod can generate its configuration file. 3. `M` * Go to your Minecraft folder and open `config/aitooltip_config.json`. * Get a free API key from Google AI Studio (https://aistudio.google.com/). * Replace `"PUT_YOUR_GEMINI_KEY_HERE"` with your actual key and save the file. 4. `M` * Join a world or server. * Press `M` (by default, can be changed in Options > Controls) to toggle the AI Tooltip HUD on or off. * Look at something!

Configuration (`config/aitooltip_config.json`)

```json { "geminiApiKey": "YOUR_KEY_HERE", "useWebSearch": true } ``` * `geminiApiKey`: Your Google Gemini API key. * `useWebSearch`: Set to `true` (default) to allow the AI to browse the internet for better answers on modded content. Set to `false` if you want slightly faster, but potentially less accurate, responses.

Credits

Made by arthurus36.