Lumen Tooltips
Minecraft: Java Edition 的客户端提示框增强与视觉预览模组。
概览
Lumen Tooltips 是一款强大的客户端模组,通过添加详细信息、动态调整大小和直接显示在物品栏中的视觉预览来增强 Minecraft 的提示框。它旨在让你一目了然地获取更多信息,通过将饥饿值统计、容器预览和装备对比整合到一个无缝的整体中,取代了多个独立模组的需求。
主要功能
- 增强的提示框数据 - 耐久度、食物属性、附魔描述以及装备对比。
- 视觉预览 - 无需放置或使用即可查看容器、书籍、烟花和刷怪蛋内部的内容。
- 物品栏操作 - 使用直观的快捷键对提示框进行滚动、换行和交互。
- 文本安全 - 包含针对“翻译崩溃”(Translation Crash)的修复补丁,其适用范围不仅限于提示框。
- 完全可配置 - 在游戏中即可更改功能、激活模式、键位和控制提示,无需重启游戏。
- 跨加载器支持 - 完全兼容 Fabric 和 NeoForge。
- 无缝集成 - 编辑物品或直接将其保存到 Item Editor 存储中,支持自定义快捷键。
安装指南
前置要求
- Minecraft(兼容 Fabric 或 NeoForge 的版本)
- Fabric API(如果使用 Fabric)
步骤
- 安装 Fabric Loader 或 NeoForge
- 下载以下文件:
- Lumen Tooltips(本模组)
- Fabric API(如果使用 Fabric)
- 将所有
.jar文件放入你的mods文件夹 - 启动游戏
- 在游戏内通过
/lumen命令或在 Minecraft 设置菜单中的Lumen Tooltips按钮进行配置。
功能分类
配置
- 游戏内访问:通过
/lumen命令或 Minecraft 设置中的 Lumen Tooltips 按钮打开。 - 即时生效:选项修改后无需保存按钮或重启即可应用。
- 便捷导航:紧凑的图标分类、选项搜索以及可折叠的高级设置。
- 清晰的变更指示:变更值标记以及每个选项和当前菜单的重置按钮。
- 键位中心:在一个地方重新绑定或解除绑定所有 Lumen 快捷键,并附带冲突警告。
- 实时示例:可视化选项展示格式化前后的提示框预览效果。
- 控制提示:配置预览、打开、编辑和保存的提示,而不会禁用其快捷键。
提示框信息
- 耐久度百分比:叠加在原版调试提示框之上显示。
- 耐久度着色:基于生命值状态(阈值可配置)。
- 饥饿与饱和度:食物图标(取自 AppleSkin 模组)。
- 状态效果:食物和可疑炖汤的效果。
- 附魔描述:简要说明该附魔的作用。
- 数值化附魔等级:以数字而非罗马数字显示等级(默认禁用)。
- 装备对比:鼠标悬停物品与当前装备物品的对比。
- 原版标签:为每个注册的原版
hidden_components标签提供单独的开关。
导航
- 地图探索:已填充地图 / 已探索地图的百分比。
- 地图外方向:当玩家处于地图范围之外时显示的方向。
- 未探索区域:指向最近的未探索地图区域的方向。
- 导向针目标:目标维度与坐标。
- 回溯指针:死亡位置。
- 维度警告:当指南针目标位于其他维度时发出警告。
额外统计数据
默认禁用;每项统计均可单独启用。
- 燃料与堆肥:熔炉燃烧时长与堆肥桶成功概率。
- 物品属性:使用冷却时间、可附魔性以及铁砧先前的工作惩罚。
- 方块属性:硬度、防爆性和附魔台力量。
- 工具属性:数据驱动的挖掘等级和最高的有限基础挖掘速度。
- 物品来源:注册该物品的模组名称。
- 显示控制:始终显示、按住按键显示或高级提示框激活,以及秒/刻的单位。
提示框布局
- 屏幕边界:将提示框保持在屏幕边界内。
- 文本换行:自动换行过宽的提示框文本。
- 最大宽度:自动计算和/或显式配置的最大宽度。
- 滚动:对于高于屏幕高度的提示框,支持鼠标滚轮滚动。
- 滚动速度:可配置的滚动速度/步长。
- 控制提示:为可用操作配置可自定义的控制提示。
视觉预览
可配置按键,默认为 左Shift
- 潜影盒:带有匹配潜影盒颜色的内容网格。
- 通用容器:容器和箱子内容的网格。
- 绑带:选中物品高亮显示以及类似原版的填充条。
- 已填充地图:来自客户端已知地图数据的实时地图图像和标记。
- 旗帜、盾牌与装饰罐:放大原版物品渲染并展示存储的图案。
- 药水与附魔箭:可选的原版效果图标、等级、颜色和持续时间;默认禁用。
- 末影箱:仅在当前会话中预览当前世界中最近打开过的末影箱。
- 画作与告示牌:展示带有存储文本的画作实体、告示牌或悬挂式告示牌。
- 玩家头颅:使用存储的玩家资料和本地皮肤模型放大显示的头颅。
- 书写页与可书写书:第一页预览和页数统计,作者旁显示玩家头颅。
- 烟花火箭:动画火箭和烟花星模拟,包括飞行时间、爆炸数量、形状、颜色、轨迹和闪烁效果。
- 生物刷新生蛋蛋:使用存储数据渲染实体。
- 生物桶:使用存储的桶数据渲染实体。
- 刷怪笼:从 SpawnData 和生成潜力中渲染实体。
- 动画:动画化的活体实体以及 TNT 引信动画。
- 区域效果云:半径、药水信息以及动画粒子。
- 显示实体:方块、物品和文本显示实体。
- 物品展示框:普通物品展示框和发光物品展示框。
- 下落方块:下落方块渲染,包括末地传送门和末地折跃门。
- 实体定位:为显示实体配置固定的偏航角(yaw)和俯仰角(pitch)。
- 实体适配:自动适配实体尺寸,包括特殊的马匹尺寸调整。
- 隐形实体:对隐形实体显示 custom_name 回退文本。
- 外观:紧凑、原版和舒适三种密度选项,以及完整/压缩的容器内容显示。
- 提示框样式:在适用情况下尊重自定义
tooltip_style的背景和边框。 - 预览颜色:可配置容器色调、计数、标题以及基于物品的颜色。
- 无障碍性:色盲耐久度颜色以及减少运动的实体和烟花预览。
打开物品
可配置按键,默认为 左Alt
- 容器内容:以只读方式打开容器界面。
- 书写页:在 Minecraft 的原版书籍查看器中打开。
- 可书写书:以只读方式打开,不签署或修改内容。
- 大型箱子:支持最多六行原版箱子布局。
- 库存支持:适用于普通背包、创造模式背包以及通过 Lumen 打开的容器界面。
- 嵌套导航:在打开存储的容器时显示面包屑导航和原生返回按钮。
- 原生反馈:返回父级界面时会播放对应的箱子、末影箱或潜影盒关闭音效。
文本安全
- 递归保护:防止恶意递归翻译组件的保护机制,高度可配置。
- Component.visit:可选的全局
Component.visit保护。
其他功能
- 物品编辑器:与 Item Editor 深度集成,包括编辑和保存悬停物品的快捷方式。
- 存储路由:保存到第一个可用槽位、指定页码或命名页面,支持可选的页面创建和页码反馈。
截图
支持语言
| 语言 | 本地名称 | 代码 |
|---|---|---|
| English | English | en_us |
贡献
欢迎贡献!请随时:
- 通过 GitHub Issues 报告错误
- 提交功能请求
- 加入 Discord 参与讨论
相关项目与灵感
如果您喜欢 Lumen Tooltips,您可能也对启发其部分功能的项目感兴趣:
- AppleSkin:用于原始饥饿度和饱和度可视化(Lumen Tooltips 借助 AppleSkins Unlicense 实现了完全相同的功能)。
- Meteor Client:用于潜影盒网格和旋转实体预览的概念。
- Item Editor:Lumen Tooltips 与 Item Editor 深度集成,允许您无缝地从查看物品提示符过渡到编辑其组件。
许可证
本项目根据 LICENSE 文件中指定的条款进行许可。
Lumen Tooltips
A client-side tooltip enhancement and visual preview mod for Minecraft: Java Edition.
Overview
Lumen Tooltips is a powerful client-side mod that enhances Minecraft's tooltips adding details, dynamic sizing, and visual previews directly in your inventory. Designed to give you more information at a glance, it replaces the need for multiple standalone mods by integrating hunger stats, container previews, and gear comparisons into one seamless package.
Key Features
- Enhanced Tooltip Data - Durability, food stats, enchantment descriptions, and gear comparisons.
- Visual Previews - See inside containers, books, fireworks, and spawn eggs without placing or using them.
- Inventory Actions - Scroll, wrap, and interact with tooltips using intuitive hotkeys.
- Text Safety - Includes a patch for the Translation Crash, which applies beyond just Tooltips.
- Fully Configurable - Change features, activation modes, keybinds, and control hints in-game without restarting.
- Cross-Loader Support - Fully compatible with both Fabric and NeoForge.
- Seamless Integration - Edit items or save them directly to Item Editor storage with configurable keybinds.
Installation
Requirements
- Minecraft (Fabric or NeoForge compatible version)
- Fabric API (if using Fabric)
Steps
- Install Fabric Loader or NeoForge
- Download the following files:
- Lumen Tooltips (this mod)
- Fabric API (if using Fabric)
- Place all
.jarfiles into yourmodsfolder - Launch the game
- Configure via the
/lumencommand in-game, or theLumen Tooltipsbutton in Minecraft's settings menu.
Feature Categories
Configuration
- In-Game Access: Open with
/lumenor the Lumen Tooltips button in Minecraft's settings. - Immediate Changes: Options apply without a save button or restart.
- Easy Navigation: Compact icon categories, option search, and collapsible advanced settings.
- Clear Changes: Changed-value markers plus per-option and current-menu reset buttons.
- Keybind Center: Rebind or unbind every Lumen shortcut with conflict warnings in one place.
- Live Examples: Visual options show formatted before-and-after tooltip previews.
- Control Hints: Configure preview, open, edit, and save hints without disabling their shortcuts.
Tooltip Information
- Durability Percentage: Added over Vanilla debug tooltip.
- Durability Coloring: Based on health (configurable thresholds).
- Hunger & Saturation: Icons for food (taken from AppleSkin).
- Status Effects: Food and Suspicious Stew effects.
- Enchantment Descriptions: Brief description of what the Enchantment does.
- Numeric Enchantments: Numeric levels instead of Roman numerals (disabled by default).
- Equipment Comparison: Hovered vs currently equipped item comparison.
- Vanilla Flags: Individual toggles for every registered vanilla
hidden_componentsflag.
Navigation
- Map Exploration: Filled map / explored map percentage.
- Off-Map Direction: Direction when the player is outside the map.
- Unexplored Areas: Direction of the nearest unexplored map area.
- Lodestone Target: Target dimension and coordinates.
- Recovery Compass: Death location.
- Dimension Warning: Warning when a compass target is in another dimension.
Extra Statistics
Disabled by default; every statistic can be enabled separately.
- Fuel and Composting: Furnace burn duration and Composter success chance.
- Item Properties: Use cooldown, enchantability, and anvil prior-work penalty.
- Block Properties: Hardness, blast resistance, and Enchanting Table power.
- Tool Properties: Data-driven mining level and highest finite base mining speed.
- Item Source: Display name of the mod that registered the item.
- Display Controls: Always, hold-key, or advanced-tooltip activation and seconds/ticks units.
Tooltip Layout
- Screen Boundaries: Keeps tooltips inside screen boundaries.
- Text Wrapping: Wraps overly wide tooltip text.
- Maximum Width: Automatic and/or explicitly configured maximum width.
- Scrolling: Mouse wheel scrolling for tooltips taller than the screen.
- Scroll Speed: Configurable scroll speed/step.
- Control Hints: Configurable control hints for available actions.
Visual Previews
Configurable keybind, default Left Shift
- Shulker Boxes: Content grid with matching shulker color.
- Generic Containers: Container and chest content grids.
- Bundles: Contents with selected-item highlighting and fullness bar like vanilla.
- Filled Maps: Live map image and markers from client-known map data.
- Banners, Shields, and Decorated Pots: Enlarged vanilla item rendering with stored patterns.
- Potions and Tipped Arrows: Optional vanilla effect icons, levels, colors, and durations; disabled by default.
- Ender Chests: Session-only preview of the last Ender Chest opened in the current world.
- Paintings and Signs: Painting entities and signs or hanging signs with stored text.
- Player Heads: Enlarged native head models using stored profiles and skins.
- Written and Writable Books: First-page preview and page count, plus player heads beside author.
- Fireworks: Animated rocket and firework-star simulation, flight time, burst count, shapes, colors, trails, and twinkle.
- Spawn Eggs: Entity rendering with stored data.
- Mob Buckets: Entity rendering with stored bucket data.
- Spawners: Entity rendering from SpawnData and spawn potentials.
- Animations: Animated living entities and TNT fuse animation.
- Area-Effect Clouds: Radius, potion information and animated particles.
- Display Entities: Block, item, and text display entities.
- Item Frames: Item frames and glow item frames.
- Falling Blocks: Falling-block rendering, including end portals and gateway.
- Entity Positioning: Configurable fixed yaw and pitch for display entities.
- Entity Fitting: Automatic entity fitting, including special horse sizing.
- Invisible Entities: Shows custom_name fallback for invisible entities.
- Appearance: Compact, Vanilla, and Comfortable density plus full/compacted container contents.
- Tooltip Styles: Custom
tooltip_stylebackgrounds and frames are respected where applicable. - Preview Colors: Configurable container tint, counts, titles, and item-derived colors.
- Accessibility: Colorblind durability colors and reduced-motion entity and firework previews.
Opening Items
Configurable keybind, default Left Alt
- Container Contents: Open as read-only container screens.
- Written Books: Open in Minecraft’s native book viewer.
- Writable Books: Open read-only without signing or modifying them.
- Large Chests: Supports up to six vanilla chest rows.
- Inventory Support: Works from normal inventories, the Creative inventory, and Lumen-opened container screens.
- Nested Navigation: Shows breadcrumbs and a native back button while opening stored containers.
- Native Feedback: Returning to the parent plays the matching chest, Ender Chest, or Shulker Box close sound.
Text Safety
- Recursive Protection: Protection against malicious recursive translation components, highly configurable.
- Component.visit: Optional global
Component.visitprotection.
Extra
- Item Editor: Deep API integration with Item Editor, including shortcuts for editing and saving hovered items.
- Storage Routing: Save to the first available slot, a page number, or a named page, with optional page creation and page-number feedback.
Screenshots
Supported Languages
| Language | Native name | Code |
|---|---|---|
| English | English | en_us |
Contributing
Contributions are welcome! Please feel free to:
- Report bugs via GitHub Issues
- Submit feature requests
- Join the Discord for discussion
Related Projects & Inspirations
If you enjoy Lumen Tooltips, you might also be interested in the projects that inspired some of its features:
- AppleSkin: For the original hunger and saturation visualization (Lumen Tooltips implements this identically thanks to AppleSkins Unlicense).
- Meteor Client: For the shulker-box grid and rotating entity preview ideas.
- Item Editor: Lumen Tooltips features deep integration with Item Editor, allowing you to seamlessly transition from viewing an item's tooltip to editing its components.
License
This project is licensed under the terms of the license specified in the LICENSE file.
下载 Lumen Tooltips
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Lumen Tooltips
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Lumen Tooltips
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Lumen Tooltips
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Lumen Tooltips
下载 Lumen Tooltips
下载 Lumen Tooltips
下载 Lumen Tooltips
下载 Lumen Tooltips
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Lumen Tooltips
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
build-8
- 为容器预览添加了紧凑槽位
- 添加了模组菜单集成
- 添加了容器预览对齐功能
- 改进了紧凑容器预览并修复了其底部边框
- 终于将搜索栏居中了 :P
- 修复了在 26.1+ 版本加入世界前配置图标缺失的问题。
- 修复了在 26.2 和 26.3 版本中打开配置、容器或书籍时的屏幕过渡闪烁问题
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
缓冲的原始输入和线程化的事件轮询
模组
可定制的鞘翅模组,支持装饰纹饰、旗帜图案等更多功能!
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
原版世界生成优化模组
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
评论 0
登录后参与评分
还没有评论,来抢沙发吧