Hysk-Tooltips

# Hysk Tooltips Project Overview !(https://cdn.modrinth.com/data/cached_images/f0501bacf363fb8f8c4385a077d6a179a42e565e.png) - legendary-tooltips+Assembled-Legendary-Tooltips-resourcepacks 26.2+ !(https://cdn.modrinth.com/data/cached_images/9f7c18a0dcec187300b0c760685951fa2e3300a6_0.webp) Hysk Tooltips is a Fabric client-side mod that displays the vanilla item tooltip near the center of the screen when you look at a dropped item on the ground. It offers extensive customization options including position offset, anchor point, display delay, and automatically adapts to the fancy rendering styles of (https://modrinth.com/mod/obscure-tooltips) and (https://modrinth.com/mod/enhancedtooltips). This mod was developed with the assistance of Deepseek and is a public welfare mod for the Qing Xin Heng Yue Time-Space Server. - **Producer**: YkinLing - **Auxiliary AI**: Deepseek - **QQ Group**: 783492491 (For obtaining the source code) ## Project Structure Below is a list of all source code and related configuration files of this mod: | File | Description | |------|-------------| | `ModConfig.java` | Configuration class defined using Cloth Config API, containing all adjustable options. | | `ModMenuIntegration.java` | Integrates the config screen with Mod Menu, allowing players to open the configuration screen via Mod Menu. | | `ExampleMixin.java` | Example Mixin class (not actually used), demonstrating Mixin injection. | | `HudTooltipPicker.java` | Core logic class: responsible for raycasting dropped items, handling look delay, tracking item states, and maintaining multi-item mode. | | `HudTooltipRenderer.java` | Implements `HudRenderCallback`, renders tooltips according to current mode (single/multi/forced), and automatically detects the presence of Obscure Tooltips to switch rendering styles. | | `Hysktooltips.java` | Mod main entry point (ModInitializer), only outputs initialization logs. | | `HysktooltipsClient.java` | Client initialization entry: registers configuration, HUD rendering callback, key binding (force show key), and listens for key state changes. | | `HysktooltipsDataGenerator.java` | Data generation entry (unused). | | `en_us.json` | English language file. | | `zh_cn.json` | Chinese language file. | | `fabric.mod.json` | Fabric mod metadata file, defining mod ID, version, entrypoints, dependencies, etc. | | `hysk-tooltips.mixins.json` | Mixin configuration file, declaring the Mixin classes used. | | `README_CN.md` / `README_EN.md` | User documentation in Chinese and English. | ## Core Features - **Basic Display**: When the player's crosshair points at a dropped item (`ItemEntity`), the item tooltip is shown at a configurable screen position. - **Position Customization**: Via `tooltipXOffset`, `tooltipYOffset` and `anchor` settings, you can freely adjust the tooltip's offset and anchor relative to the screen center. - **Look Delay**: Enable `enableDelay` and set `delayTimeMs` to prevent the tooltip from flickering. - **Follow Mode**: When `followEnabled` is on, the tooltip follows the item's movement on screen and can linger after looking away (`followDelayMs`). - **Multi-Item Support**: Enable `multiItemEnabled` to display up to 5 item tooltips simultaneously, each independently managing its own look delay and disappear delay (`multiItemDelayMs`, `multiItemDisappearDelayMs`). - **Super Range Tooltips**: Enable `superRangeEnabled` to allow looking at distant dropped items while sneaking (distance set by `superRangeDistance`, default 128 blocks). In force mode, distance limit is also ignored. - **Avoid Overlap**: Enable `avoidOverlap` to automatically reposition multiple tooltips (radial search) to prevent overlapping in multi-item mode. - **Force Display Mode**: Press the configured key (default Left Shift) to forcibly show tooltips for nearby dropped items. Behavior controlled by `shiftEnabled` and `shiftRequiresTarget`, and limited by `forceMaxItems` (closest to your view, default 15). - **Automatic Tooltip Enhancement Mods Adaptation**: If Obscure Tooltips or Enhanced Tooltips is installed, the tooltips automatically use their enhanced styles (gradients, animations, particles, etc.); otherwise, they fall back to the vanilla style. ## Configuration Options Explained The fields in the `ModConfig` class correspond to the following options (can be edited directly in `config/hysk-tooltips.json` or via the Mod Menu interface): | Option | Type | Default | Description | |--------|------|---------|-------------| | `enabled` | boolean | true | Whether the mod is enabled. | | `tooltipYOffset` | int (-100~100) | 0 | Vertical offset of the tooltip (pixels, positive moves down). | | `tooltipXOffset` | int (-100~100) | 0 | Horizontal offset of the tooltip (pixels, positive moves right). | | `anchor` | enum | TOP_LEFT | Anchor point of the tooltip relative to screen center (Top Left, Top Ri