流明提示

流明提示

一个高度可定制的提示框模组,用于扩展提示框、修复漏洞并提升性能。

装备

Lumen Tooltips Logo

Lumen Tooltips

一个面向 Minecraft: Java 版的客户端提示框增强与视觉预览模组。

Modrinth Downloads GitHub Source Discord Join


概述

Lumen Tooltips 是一个功能强大的客户端模组,它增强了 Minecraft 的提示框,直接在物品栏中为提示框添加细节、动态尺寸和视觉预览。它旨在让你一目了然地获取更多信息,通过将饥饿值状态、容器预览和装备对比整合到一个无缝的包中,取代了对多个独立模组的需求。


主要特性

  • 增强的提示框数据 - 耐久度、食物状态、附魔描述和装备对比。
  • 视觉预览 - 无需放置或使用即可查看容器、书籍、烟花和刷怪蛋的内部内容。
  • 物品栏操作 - 使用直观的热键滚动、换行并与提示框交互。
  • 文本安全 - 包含针对翻译崩溃(Translation Crash)的补丁,其适用范围不仅限于提示框。
  • 完全可配置 - 在游戏内更改功能、激活模式、按键绑定和控制提示,无需重启。
  • 跨加载器支持 - 完全兼容 Fabric 和 NeoForge。
  • 无缝集成 - 使用可配置的按键绑定编辑物品,或将物品直接保存到 Item Editor 存储中。

安装

前置要求

  • Minecraft(兼容 Fabric 或 NeoForge 的版本)
  • Fabric API(如果使用 Fabric)

步骤

  1. 安装 Fabric Loader 或 NeoForge
  2. 下载以下文件:
  3. 将所有 .jar 文件放入你的 mods 文件夹
  4. 启动游戏
  5. 通过游戏内的 /lumen 命令,或 Minecraft 设置菜单中的 Lumen Tooltips 按钮进行配置。

功能分类

配置

  • 游戏内访问:通过 /lumen 或 Minecraft 设置中的 Lumen Tooltips 按钮打开。
  • 即时更改:选项无需保存按钮或重启即可生效。
  • 轻松导航:紧凑的图标分类、选项搜索和可折叠的高级设置。
  • 清晰的更改标记:已更改值的标记,以及每个选项和当前菜单的重置按钮。
  • 按键绑定中心:在一个地方重新绑定或取消绑定每个 Lumen 快捷方式,并提供冲突警告。
  • 实时示例:视觉选项会显示格式化前后的提示框预览。
  • 控制提示:可配置预览、打开、编辑和保存提示,而无需禁用其快捷方式。

提示框信息

  • 耐久度百分比:添加在原版调试提示框之上。
  • 耐久度着色:基于耐久值(可配置阈值)。
  • 饥饿值与饱和度:食物图标(取自 AppleSkin)。
  • 状态效果:食物和迷之炖菜的效果。
  • 附魔描述:附魔作用的简要描述。
  • 数字附魔:使用数字等级而非罗马数字(默认禁用)。
  • 装备对比:悬停物品与当前装备物品的对比。
  • 原版标记:为每个已注册的原版 hidden_components 标记提供单独开关。

导航

  • 地图探索:已填充地图/已探索地图百分比。
  • 地图外方向:玩家在地图外时的方向。
  • 未探索区域:最近未探索地图区域的方向。
  • 磁石目标:目标维度和坐标。
  • 追溯指针:死亡位置。
  • 维度警告:当指南针目标位于另一个维度时发出警告。

额外统计

默认禁用;每个统计项均可单独启用。

  • 燃料与堆肥:熔炉燃烧时长和堆肥桶成功几率。
  • 物品属性:使用冷却、附魔能力和铁砧先前工作惩罚。
  • 方块属性:硬度、爆炸抗性和附魔台能量。
  • 工具属性:数据驱动的挖掘等级和最高的有限基础挖掘速度。
  • 物品来源:注册该物品的模组显示名称。
  • 显示控制:始终显示、按住按键显示或高级提示框激活,以及秒/刻单位。

提示框布局

  • 屏幕边界:将提示框保持在屏幕边界内。
  • 文本换行:对过宽的提示框文本进行换行。
  • 最大宽度:自动和/或显式配置的最大宽度。
  • 滚动:对高于屏幕的提示框使用鼠标滚轮滚动。
  • 滚动速度:可配置的滚动速度/步长。
  • 控制提示:为可用操作提供可配置的控制提示。

视觉预览

可配置按键绑定,默认 Left Shift

  • 潜影盒:与潜影盒颜色匹配的内容网格。
  • 通用容器:容器和箱子的内容网格。
  • 收纳袋:内容物,包含选中物品高亮和类似原版的满载进度条。
  • 已填充地图:来自客户端已知地图数据的实时地图图像和标记。
  • 旗帜、盾牌和装饰罐:放大的原版物品渲染,并显示存储的图案。
  • 药水和药箭:可选的的原版效果图标、等级、颜色和持续时间;默认禁用。
  • 末影箱:当前世界中最后打开的末影箱的仅会话预览。
  • 画和告示牌:画实体以及带有存储文本的告示牌或悬挂告示牌。
  • 玩家头颅:使用存储的配置文件和皮肤放大的原生头部模型。
  • 成书和书与笔:第一页预览和页数,以及作者旁的头像。
  • 烟花:动画火箭和烟花之星模拟、飞行时间、爆裂数量、形状、颜色、轨迹和闪烁。
  • 刷怪蛋:带有存储数据的实体渲染。
  • 生物桶:带有存储桶数据的实体渲染。
  • 刷怪笼:来自 SpawnData 的实体渲染和生成潜力。
  • 动画:动画生物实体和 TNT 引信动画。
  • 区域效果云:半径、药水信息和动画粒子。
  • 展示实体:方块、物品和文本展示实体。
  • 物品展示框:物品展示框和荧光物品展示框。
  • 下落方块:下落方块渲染,包括末地传送门和折跃门。
  • 实体定位:为展示实体可配置的固定偏航角和俯仰角。
  • 实体适配:自动实体适配,包括特殊的马匹尺寸处理。
  • 隐形实体:为隐形实体显示 custom_name 作为后备。
  • 外观:紧凑、原版和舒适密度,以及完整/压缩的容器内容。
  • 提示框样式:在适用情况下尊重自定义 tooltip_style 背景和边框。
  • 预览颜色:可配置的容器色调、数量、标题和物品派生颜色。
  • 无障碍:色盲耐久度颜色以及减少动态效果的实体和烟花预览。

打开物品

可配置按键绑定,默认 Left Alt

  • 容器内容:作为只读容器界面打开。
  • 成书:在 Minecraft 原生书籍查看器中打开。
  • 书与笔:以只读方式打开,不进行签名或修改。
  • 大箱子:支持最多六排原版箱子。
  • 物品栏支持:可从普通物品栏、创造模式物品栏和 Lumen 打开的容器界面中使用。
  • 嵌套导航:在打开存储容器时显示面包屑导航和原生返回按钮。
  • 原生反馈:返回父级时播放对应的箱子、末影箱或潜影盒关闭音效。

文本安全

  • 递归保护:针对恶意递归翻译组件的保护,高度可配置。
  • Component.visit:可选的全局 Component.visit 保护。

额外

  • Item Editor:与 Item Editor 深度 API 集成,包括编辑和保存悬停物品的快捷方式。
  • 存储路由:保存到第一个可用槽位、页码或命名页面,可选页面创建和页码反馈。

截图

Entity Preview Book Preview
Gear Comparison Firework Preview
Firework Details Configuration Menu

支持的语言

语言 本地名称 代码
英语 English en_us

贡献

欢迎贡献!请随时:


相关项目与灵感来源

如果你喜欢 Lumen Tooltips,你可能也会对其部分功能的灵感来源项目感兴趣:

  • AppleSkin:原始饥饿值和饱和度可视化的来源(得益于 AppleSkin 的 Unlicense 许可,Lumen Tooltips 以相同方式实现了此功能)。
  • Meteor Client:潜影盒网格和旋转实体预览创意的来源。
  • Item Editor:Lumen Tooltips 与 Item Editor 深度集成,允许你从查看物品提示框无缝过渡到编辑其组件。

许可证

本项目依据 LICENSE 文件中指定的许可证条款授权。


Modrinth • GitHub • Discord