
Hidden description
Item description hidden, hold shift to view
About this Mod
feat(tooltip): Implement conditional tooltip expansion with Shift key
This commit introduces a new client-side quality-of-life feature that
modifies how item tooltips are displayed in the game. When a player is
viewing an item's tooltip, a placeholder message "Hold Shift for
details..." is shown by default. Pressing and holding the Shift key
reveals the full, complete tooltip, providing an organized and clean
inventory browsing experience.
Background / Problem:
- Tooltips in Minecraft can become excessively long, especially in
modded environments where items often carry detailed descriptions,
enchantment information, and mod-specific metadata. - A cluttered tooltip obstructs the player's view and makes inventory
management cumbersome, as crucial information is always visible
whether needed or not. - There is currently no vanilla or standard Forge method to toggle
tooltips or hide them behind a modifier key.
Implementation Details:
- Created a new event handler that listens to the
ItemTooltipEvent
(Forge's API event for tooltip construction). - When the event is triggered, the handler checks the state of the
Shift key usingScreen.hasShiftDown()(client-side) to determine
if the player is holding the key while hovering over the item. - If the key is pressed, the original, unmodified tooltip text list
(List) is added to the tooltip, showing every line of
information. - If the key is not pressed, the default tooltip is cleared and
replaced with a single-line component: "Hold Shift for details...". - The tooltip is automatically updated and re-rendered each time the
player's key state changes while the item is hovered over.
Changes in Behavior:
- Players can now quickly glance at an item without being overwhelmed
by lengthy text. - The full tooltip is instantly revealed when needed, without any
additional keybinds or configuration menus. - The placeholder text is localized and can be adapted or
internationalized by future updates. - This feature works on all items, including those from other mods,
because it intercepts the tooltip event at a generic level.
Testing Performed:
- Verified on Forge 1.20.1 with both vanilla and modded items (e.g.,
items with enchantments, modded equipment). - Confirmed that the Shift key detection works reliably in all game
screens (inventory, creative menu, containers). - Tested the responsiveness of the tooltip when the key is pressed,
released, and pressed again while the mouse remains on the same
item. - Ensured compatibility with other mods that also modify
ItemTooltipEventthrough event priority adjustments.
Additional Notes:
- This mod is fully client-side and does not require any server-side
installation. - The
Screen.hasShiftDown()method is used overkeyBindSneakto
accurately reflect GUI-related key presses without interfering
with movement controls. - Future consideration: Adding a configurable keybind to toggle this
behavior or customize the placeholder message.
Resolves: #ISSUE-42 (Replace with actual issue ticket number if applicable)
Available Versions
How to Install Hidden description on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set forge Loader
In the panel under "Egg", select the forge loader and matching Minecraft version (1.20.6).
Install Mod
Open the mod browser in the dashboard and search for "Hidden description". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.20.6, 1.20.5, 1.20.4 (+3 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Hidden description server crashes on startup – what to do?
Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.6). You can switch loaders with one click in the panel.
Is Hidden description compatible with forge?
Hidden description officially supports forge for Minecraft 1.20.6, 1.20.5, 1.20.4. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Hidden description – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Hidden description consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Rent Modded Server
Install Hidden description with just one click on your server.