WAISI(我踩到了什么)

WAISI(我踩到了什么)

What Am I Stepping In? 是一个 Minecraft 模组,用于告诉玩家他们正站在什么上面,或正踩进什么里面!受 Waila/Hwyla/Jade 启发。

工具

我踩在什么上面?(WAISI)

模组图标,显示一只靴子踩在草方块上,旁边有一个放大镜,似乎在疑问踩到的是什么方块。

一个轻量级的 Fabric 模组,用于识别你脚下的方块。

Minecraft HUD 上方的"我踩在什么上面"信息框,显示草方块

概述

我踩在什么上面?(WAISI)是一个客户端 Fabric 模组,旨在回答一个简单的问题:你当前站在什么方块上?受经典的 WAILA(What Am I Looking At,我在看什么)系列模组启发,WAISI 采取了专注的方式,显示你正脚下方的方块信息,而不是你正在看的方块。

该模组具有可自定义的 HUD,以简洁、不显眼的方式显示方块名称、来源模组和物品图标。无论你是在探索包含数百种方块的整合包,还是只想快速识别原版地形,WAISI 都能提供即时反馈,而不会让你的屏幕变得杂乱。

功能

方块识别

WAISI 持续监测你玩家脚下的方块,并实时显示相关信息。HUD 以你配置的文字颜色显示方块名称,以独特的蓝色显示来源模组以便区分,并提供可选的物品图标用于快速视觉识别。检测系统足够智能,能够处理边界情况——如果你站在空气中,它会检查你脚部位置的方块作为后备方案,确保无论你站在实地上还是悬浮在空中,行为都保持一致。

自定义系统

该模组包含一个可通过 Mod Menu 访问的配置界面,提供丰富的自定义选项,而不会过于复杂。可从三种精心设计的主题预设中选择:经典的深色主题(带有微妙的灰色边框)、鲜艳的紫色主题(带有金色点缀),或极致的高对比度主题(以获得最大可见性)。

通过边框厚度控制(0-5 像素)微调 HUD 的外观,该控制会吸附到整数值以实现精确调整。透明度系统支持 0-255 的完整 Alpha 控制,允许你创建从实心背景到完全不可见的浮动文字背景的任何效果。缩放调整范围为 0.5 倍到 2.0 倍,确保 HUD 在任何屏幕分辨率或 UI 缩放设置下都看起来完美。

我踩在什么上面的配置界面

定位与布局

WAISI 不会强迫你编辑配置文件或猜测百分比数值,而是包含一个可从设置菜单访问的交互式定位界面。只需点击并拖动 HUD 预览到所需位置——模组会记住你的偏好,并在移动时显示实时预览。默认位置(水平 50%,垂直 75%)将 HUD 放置在快捷栏正上方,避免与生命值和护甲指示器重叠。

兼容性功能

对于运行多个 HUD 模组(如 Jade 或 HWYLA)的用户,WAISI 提供了一个可选的 "Stepping in:" 副标题,显示在方块名称上方。这个小添加有助于将 WAISI 的信息与其他屏幕显示区分开来,防止在多个模组同时激活时产生混淆。副标题可根据你的偏好开启或关闭。

视觉设计

HUD 采用圆角设计,外观现代精致,而不会过度花哨。边框渲染在内容区域外部(外扩样式),在保持文本和图标周围内边距的同时维持整洁对齐。当模组被禁用时,配置界面的预览窗格会显示清晰的"MOD DISABLED"(模组已禁用)消息,提供关于模组状态的即时视觉反馈。

我踩在什么上面的 Mod Menu 设置入口

安装

安装 WAISI 遵循标准的 Fabric 模组安装流程:

  1. 下载并安装适用于 Minecraft 1.21.11 或更高版本的 Fabric Loader
  2. 下载 Fabric API 并将其放入你的 mods 文件夹
  3. 下载 Mod Menu(推荐,便于访问配置)
  4. 将 waisi-1.0.0.jar 文件放入你的 .minecraft/mods 文件夹
  5. 启动 Minecraft,通过 Mods → WAISI → Settings 访问设置

该模组完全是客户端侧的,不需要在服务器上安装。它在单人游戏和多人游戏环境中都能无缝运行。

使用

安装后,WAISI 会自动运行——无需初始配置。当你站在方块上时,HUD 会出现,根据你当前的设置显示信息。要自定义模组的外观和行为:

  1. 按 Escape 打开游戏菜单
  2. 点击 Mods 打开 Mod Menu
  3. 在模组列表中找到 WAISI (What Am I Stepping In?)
  4. 点击 Settings 按钮打开配置界面

在设置界面中,你可以调整所有视觉选项、更改主题并访问定位工具。屏幕右侧的实时预览窗格会在你做出更改时实时更新,让你在关闭菜单之前就能确切看到调整后的效果。如果你想重新开始,Reset Defaults(重置默认值)按钮会将所有设置恢复为原始值。

配置参考

通用选项

通用部分控制核心功能。Mod Enabled(模组已启用)切换整个 HUD 的开启或关闭——如果你想临时禁用模组而不删除文件,这很有用。Show Mod Name(显示模组名称)决定来源模组是否显示在方块名称下方。Show Item Icon(显示物品图标)控制出现在文字左侧的 16x16 方块图标。Show 'Stepping in:'(显示"Stepping in:")添加可选副标题,以兼容其他 HUD 模组。

外观选项

Color Theme(颜色主题)在三种预设主题之间循环切换,每种都有精心选择的颜色组合。Scale(缩放)使用平滑滑块调整 HUD 的整体大小。Alpha(透明度)控制背景透明度——设为 0 为不可见背景,或设为 255 为完全不透明。Border Thickness(边框厚度)使用仅限整数的值,从 0(无边框)到 5 像素,以获得最大可见性。

布局选项

Adjust Position(调整位置)打开交互式定位界面,你可以将 HUD 拖动到屏幕上的任何位置。位置会立即保存,并在游戏会话之间保持。

默认设置

WAISI 附带合理的默认值,设计为在大多数场景下良好运行:

  • 位置:水平居中(50%),垂直位置 75%(快捷栏正上方)
  • 主题:深色(黑色背景、灰色边框、白色文字)
  • 缩放:1.0 倍(原始大小)
  • 背景透明度:144(半透明,约 56% 不透明度)
  • 边框厚度:1 像素
  • 副标题:禁用(可为多 HUD 设置启用)
  • 模组名称:启用
  • 物品图标:启用

这些默认值提供了干净、不显眼的显示,与 Minecraft 的原版 UI 自然融合,同时在游戏过程中保持清晰可见。

技术细节

WAISI 使用 Fabric Loader 构建,需要 Fabric API 作为依赖项。该模组兼容 1.21.x 分支上的 Minecraft 1.21.11 及更高版本。运行需要 Java 21 或更新版本。

贡献

欢迎为 WAISI 做出贡献!如果你遇到错误、有功能建议或想贡献代码:

  • 问题:在 GitHub Issues 页面报告错误或请求功能
  • 拉取请求:通过拉取请求提交代码改进或新功能
  • 讨论:在 GitHub Discussions 部分分享想法和反馈

请确保任何代码贡献遵循现有代码风格,并包含适当的注释以便维护。

许可证

本项目根据 MIT 许可证授权,允许自由使用、修改和分发。完整详情请参阅 LICENSE 文件。

致谢与鸣谢

WAISI 建立在 Minecraft 社区方块识别模组的传统之上:

  • WAILA(What Am I Looking At,我在看什么)- 开创游戏内方块识别的原始模组
  • HWYLA(Here's What You're Looking At,你正在看什么)- 延续 WAILA 使命的精神继承者
  • Jade - 方块识别模组的现代演进

使用 Fabric 构建,这是一个轻量级模组工具链,使现代 Minecraft 模组开发变得易于访问且高性能。


Cross The Desert Interactive | 网站 | GitHub