What Am I Stepping In? (WAISI)

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

概述
What Am I Stepping In? (WAISI) 是一款客户端 Fabric 模组,旨在回答一个简单的问题:你当前站在哪个方块上?受经典的 WAILA(What Am I Looking At)系列模组启发,WAISI 采用专注的方法,直接显示你脚下方块的信息,而不是你正在注视的方块。
该模组具有可自定义的 HUD,以简洁、不显眼的显示方式展示方块名称、来源模组和物品图标。无论你是探索包含数百种方块的整合包,还是只想快速识别原版地形,WAISI 都能提供即时反馈,而不会使屏幕杂乱无章。
功能
方块识别
WAISI 持续监测玩家脚下的方块,并实时显示相关信息。HUD 会以你配置的文字颜色显示方块名称,以独特的蓝色显示来源模组以便于区分,并提供可选的物品图标以便快速视觉识别。检测系统足够智能,能够处理边缘情况——如果你站在空气中,它会检查你脚部位置的方块作为回退方案,确保无论是在坚实的地面上还是悬浮时行为一致。
自定义系统
该模组包含一个通过 Mod Menu 访问的配置界面,提供丰富的自定义选项,而不会带来过度的复杂性。你可以从三种精心设计的主题预设中选择:带有细微灰色边框的经典深色主题、带有金色点缀的鲜艳紫色主题,或为了最大可见度而设计的鲜明高对比度主题。
通过边框粗细控制(0-5 像素)微调 HUD 的外观,该功能会捕捉到整数值以实现精确调整。透明度系统支持从 0-255 的全范围 Alpha 控制,允许你创建从实心背景到完全不可见但文字浮动的效果。缩放调整范围从 0.5x 到 2.0x,确保 HUD 在任何屏幕分辨率或 UI 缩放设置下看起来都完美无瑕。

定位与布局
WAISI 没有强迫你编辑配置文件或猜测百分比值,而是包含了一个可从设置菜单访问的交互式定位屏幕。只需点击并拖动 HUD 预览到你想要的位置即可——模组会记住你的偏好,并在你移动它时显示实时预览。默认位置(水平 50%,垂直 75%)将 HUD 放置在快捷栏上方,避免与生命值和护甲指示器重叠。
兼容性功能
对于运行多个 HUD 模组(如 Jade 或 HWYLA)的用户,WAISI 提供了一个可选的**“Stepping in:”副标题**,显示在方块名称上方。这个小小的添加有助于将 WAISI 的信息与其他屏幕上的显示区分开来,防止在多个模组同时激活时产生混淆。你可以根据需要开启或关闭此副标题。
视觉设计
HUD 采用圆角设计,呈现出现代、精致的外观,而没有过多的视觉花哨。边框渲染在内容区域之外( outset 风格),保留文本和图标周围的填充空间,同时保持整洁的对齐。当模组被禁用时,配置界面的预览窗格会显示清晰的“MOD DISABLED”消息,提供关于模组状态的即时视觉反馈。

安装
安装 WAISI 遵循标准的 Fabric 模组安装流程:
- 下载并安装适用于 Minecraft 1.21.11 或更高版本的 Fabric Loader
- 下载 Fabric API 并将其放入你的 mods 文件夹
- 下载 Mod Menu(推荐用于轻松访问配置)
- 将
waisi-1.0.0.jar 文件放入你的 .minecraft/mods 文件夹
- 启动 Minecraft,并通过 Mods → WAISI → Settings 访问设置
该模组完全是客户端侧的,不需要在服务器上安装。它在单人游戏和多人游戏环境中都能无缝工作。
用法
安装后,WAISI 会自动工作——无需初始配置。当你站在方块上时,HUD 会出现,并根据你当前的设置显示信息。要自定义模组的外观和行为:
- 按 Escape 打开游戏菜单
- 点击 Mods 打开 Mod Menu
- 在模组列表中找到 WAISI (What Am I Stepping In?)
- 点击 Settings 按钮打开配置界面
在设置界面中,你可以调整所有视觉选项、更改主题并访问定位工具。屏幕右侧的实时预览窗格会随着你的更改实时更新,让你能够在关闭菜单之前确切地看到调整后的效果。如果你希望重新开始,Reset Defaults 按钮会将所有设置恢复为原始值。
配置参考
常规选项
通用设置控制核心功能。启用模组可开启或关闭整个 HUD——如果你希望在不删除文件的情况下暂时禁用该模组,这将非常有用。显示模组名称决定区块名称下方是否显示来源模组。显示物品图标控制出现在文本左侧的 16x16 区块图标。显示“踩在:” 添加可选副标题,以兼容其他 HUD 模组。
外观选项
颜色主题 可在三种预设主题之间切换,每种主题都经过精心搭配的颜色组合。缩放 使用平滑滑块调整 HUD 的整体大小。透明度 控制背景不透明度——设置为 0 表示背景不可见,255 表示完全不透明。边框粗细 仅接受从 0(无边框)到 5 像素(最大可见度)的整数值。
布局选项
调整位置 打开交互式定位界面,你可以将 HUD 拖拽到屏幕上的任意位置。位置会立即保存,并在游戏会话间保持持久化。
默认设置
WAISI 附带了合理的默认设置,旨在大多数场景下都能良好运行:
- 位置:水平居中(50%),垂直位于 75%(热键栏上方)
- 主题:深色(黑色背景,灰色边框,白色文字)
- 缩放:1.0x(原生尺寸)
- 背景透明度:144(半透明,约 56% 不透明度)
- 边框粗细:1 像素
- 副标题:禁用(可用于多 HUD 设置的启用)
- 模组名称:启用
- 物品图标:启用
这些默认设置提供简洁、不突兀的显示效果,自然融入 Minecraft 原版 UI,同时在游戏过程中保持清晰可见。
技术细节
WAISI 基于 Fabric Loader 构建,并依赖 Fabric API。该模组兼容 Minecraft 1.21.x 分支的 1.21.11 及更高版本。运行需要 Java 21 或更高版本。
贡献
欢迎为 WAISI 做出贡献!如果你遇到 bug、有功能建议或想贡献代码:
- 问题反馈:在 GitHub Issues 页面报告 bug 或请求功能
- 拉取请求:通过拉取请求提交代码改进或新功能
- 讨论区:在 GitHub Discussions 板块分享想法和反馈
请确保任何代码贡献遵循现有的代码风格,并包含适当的注释以便于维护。
许可证
本项目采用 MIT License 许可,允许免费使用、修改和分发。完整详情请参阅 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
What Am I Stepping In? (WAISI)

A lightweight Fabric mod that identifies the block underneath your feet.

Overview
What Am I Stepping In? (WAISI) is a client-side Fabric mod designed to answer a simple question: what block are you currently standing on? Inspired by the classic WAILA (What Am I Looking At) family of mods, WAISI takes a focused approach by displaying information about the block directly beneath your feet rather than what you're looking at.
The mod features a customizable HUD that shows the block name, source mod, and item icon in a clean, unobtrusive display. Whether you're exploring a modpack with hundreds of blocks or just want to quickly identify vanilla terrain, WAISI provides instant feedback without cluttering your screen.
Features
Block Identification
WAISI continuously monitors the block beneath your player's feet and displays relevant information in real-time. The HUD shows the block name in your configured text color, the source mod in a distinct blue color for easy differentiation, and an optional item icon for quick visual recognition. The detection system is smart enough to handle edge cases--if you're standing in air, it checks the block at your feet position as a fallback, ensuring consistent behavior whether you're on solid ground or floating.
Customization System
The mod includes a configuration screen accessible through Mod Menu, offering extensive customization options without overwhelming complexity. Choose from three carefully designed theme presets: a classic Dark theme with subtle gray borders, a vibrant Purple theme with gold accents, or a stark High Contrast theme for maximum visibility.
Fine-tune the HUD's appearance with border thickness control (0-5 pixels) that snaps to integer values for precise adjustment. The transparency system supports full alpha control from 0-255, allowing you to create anything from a solid background to completely invisible backing with floating text. Scale adjustment ranges from 0.5x to 2.0x, ensuring the HUD looks perfect on any screen resolution or UI scale setting.

Positioning and Layout
Rather than forcing you to edit config files or guess at percentage values, WAISI includes an interactive positioning screen accessible from the settings menu. Simply click and drag the HUD preview to your desired location--the mod remembers your preference and displays a live preview as you move it. The default position (50% horizontal, 75% vertical) places the HUD just above the hotbar, avoiding overlap with health and armor indicators.
Compatibility Features
For users running multiple HUD mods like Jade or HWYLA, WAISI offers an optional "Stepping in:" subtitle that appears above the block name. This small addition helps distinguish WAISI's information from other on-screen displays, preventing confusion when multiple mods are active. The subtitle can be toggled on or off based on your preference.
Visual Design
The HUD features rounded corners for a modern, polished look without excessive visual flair. Borders are rendered outside the content area (outset style), preserving the padding around text and icons while maintaining clean alignment. When the mod is disabled, the configuration screen's preview pane displays a clear "MOD DISABLED" message, providing immediate visual feedback about the mod's state.

Installation
Installing WAISI follows the standard Fabric mod installation process:
- Download and install Fabric Loader for Minecraft 1.21.11 or later
- Download Fabric API and place it in your mods folder
- Download Mod Menu (recommended for easy configuration access)
- Place the
waisi-1.0.0.jar file in your .minecraft/mods folder
- Launch Minecraft and access settings via Mods → WAISI → Settings
The mod is entirely client-side and does not require installation on servers. It works seamlessly in both single-player and multiplayer environments.
Usage
Once installed, WAISI works automatically--no initial configuration required. The HUD appears whenever you're standing on a block, displaying information based on your current settings. To customize the mod's appearance and behavior:
- Press Escape to open the game menu
- Click Mods to open Mod Menu
- Find WAISI (What Am I Stepping In?) in the mod list
- Click the Settings button to open the configuration screen
From the settings screen, you can adjust all visual options, change themes, and access the positioning tool. The live preview pane on the right side of the screen updates in real-time as you make changes, allowing you to see exactly how your adjustments will look before closing the menu. If you ever want to start fresh, the Reset Defaults button restores all settings to their original values.
Configuration Reference
General Options
The General section controls core functionality. Mod Enabled toggles the entire HUD on or off—useful if you want to temporarily disable the mod without removing the file. Show Mod Name determines whether the source mod appears below the block name. Show Item Icon controls the 16x16 block icon that appears to the left of the text. Show 'Stepping in:' adds the optional subtitle for compatibility with other HUD mods.
Appearance Options
Color Theme cycles through the three preset themes, each with carefully chosen color combinations. Scale adjusts the overall size of the HUD using a smooth slider. Alpha controls background transparency—set to 0 for invisible backgrounds, or 255 for fully opaque. Border Thickness uses integer-only values from 0 (no border) to 5 pixels for maximum visibility.
Layout Options
Adjust Position opens the interactive positioning screen where you can drag the HUD to any location on your screen. The position is saved immediately and persists across game sessions.
Default Settings
WAISI ships with sensible defaults designed to work well in most scenarios:
- Position: Centered horizontally (50%), positioned at 75% vertical (just above the hotbar)
- Theme: Dark (black background, gray border, white text)
- Scale: 1.0x (native size)
- Background Alpha: 144 (semi-transparent, approximately 56% opacity)
- Border Thickness: 1 pixel
- Subtitle: Disabled (can be enabled for multi-HUD setups)
- Mod Name: Enabled
- Item Icon: Enabled
These defaults provide a clean, unobtrusive display that integrates naturally with Minecraft's vanilla UI while remaining clearly visible during gameplay.
Technical Details
WAISI is built using Fabric Loader and requires Fabric API as a dependency. The mod is compatible with Minecraft 1.21.11 and later versions on the 1.21.x branch. It requires Java 21 or newer to run.
Contributing
Contributions to WAISI are welcome! If you encounter bugs, have feature suggestions, or want to contribute code:
- Issues: Report bugs or request features on the GitHub Issues page
- Pull Requests: Submit code improvements or new features via pull requests
- Discussions: Share ideas and feedback in the GitHub Discussions section
Please ensure any code contributions follow the existing code style and include appropriate comments for maintainability.
License
This project is licensed under the MIT License, allowing free use, modification, and distribution. See the LICENSE file for complete details.
Credits and Acknowledgments
WAISI builds upon the legacy of block identification mods in the Minecraft community:
- WAILA (What Am I Looking At) - The original mod that pioneered in-game block identification
- HWYLA (Here's What You're Looking At) - A spiritual successor that continued WAILA's mission
- Jade - The modern evolution of block identification mods
Built with Fabric, the lightweight modding toolchain that makes modern Minecraft modding accessible and performant.
Cross The Desert Interactive | Website | GitHub
评论 0
登录后参与评分
还没有评论,来抢沙发吧