Mob Health Display

Mob Health Display is a highly configurable client-side target health HUD mod for Fabric.

When your crosshair points at a living entity, when you attack an entity, or when an entity attacks you, the mod automatically displays a target information HUD. The HUD includes an entity model preview, current and maximum health, a colored health bar, armor information, and recent damage feedback.

The mod also provides animated target outlines, hit tint effects, configurable combat particles, and a complete in-game configuration menu.

Why Use This Mod?

Mob Health Display makes it easier to understand an entity's current combat status without opening additional interfaces.

It is suitable for players who want:

• Clear target health and armor information
• Immediate visual feedback after dealing damage
• A customizable HUD that matches different screen layouts
• More expressive normal-hit and critical-hit effects
• A client-side mod that does not require server installation
• Chinese and English configuration interfaces

Main Features

Target Information HUD

• Displays the target's current and maximum health
• Displays health values in numerical form
• Displays a smooth green-to-yellow health bar
• Displays a delayed red damage indicator after the target takes damage
• Displays target armor information
• Displays a real-time entity model preview
• Automatically adapts the entity preview to targets of different sizes
• Supports configurable HUD position, scale, and transparency

Target Detection

• Selects living entities under the crosshair
• Automatically locks onto entities attacked by the player
• Automatically locks onto entities that attack the player
• Supports configurable target detection range
• Supports configurable target lock duration
• Automatically removes invalid, dead, or unloaded targets

Visual Effects

• Animated cyan, blue, purple, and pink target outlines
• Pink and blue hit tint effects
• Configurable outline animation speed
• Configurable hit tint duration
• Individual switches for visual effects

Combat Particles

• Colorful particle bursts for normal attacks
• Enhanced particle effects for critical hits
• Optional replacement for the vanilla critical-hit effect
• Optional replacement for the vanilla damage-heart effect
• Configurable normal-hit particle quantity
• Configurable critical-hit particle quantity
• Configurable high-speed critical particle quantity
• Configurable particle speed
• Configurable particle gravity
• Configurable particle air drag
• Configurable particle size
• Configurable particle lifetime
• Configurable inheritance of target movement
• Particle ground collision and physical movement

Configuration Menu

The mod includes a complete in-game configuration menu.

Configuration options are divided into the following pages:

• HUD and Target
• Visual Effects
• Particles and Physics

The menu allows players to adjust:

• Target detection range
• Target lock duration
• HUD position
• HUD scale
• HUD transparency
• Entity preview visibility
• Armor bar visibility
• Damage indicator behavior
• Outline effects
• Hit tint effects
• Normal-hit particles
• Critical-hit particles
• Particle quantity and physics

Settings are saved automatically to:

config/mobhealthdisplay.json

The reset button only restores the default settings of the currently selected configuration page.

Interface Languages

The configuration menu supports Simplified Chinese and English.

Three interface language modes are available:

• Follow Minecraft
• 简体中文
• English

When Follow Minecraft is selected, the mod automatically chooses its interface language according to the current Minecraft language.

Players can also force the mod to use Simplified Chinese or English without changing Minecraft's global language.

The configuration screen refreshes immediately after changing the interface language. A game restart is not required.

The selected language mode is saved automatically, and configuration files created by earlier versions remain compatible.

How to Use

The target HUD appears automatically when:

• Your crosshair points at a living entity
• You attack a living entity
• A living entity attacks you

Open the Minecraft Options screen and select the Mob Health Display settings button to access the configuration menu.

No additional key binding is required for normal use.

Requirements

• Minecraft 26.1.2
• Fabric Loader
• Fabric API
• Java 25

Installation

1. Install Fabric Loader for Minecraft 26.1.2.
2. Install the matching version of Fabric API.
3. Place the Mob Health Display JAR file in the mods folder.
4. Start Minecraft using the Fabric profile.

This mod only needs to be installed on the client.

Servers do not need to install this mod.

Performance

High particle quantities, large particle sizes, and long particle lifetimes may reduce performance during frequent combat.

Players using lower-end hardware should reduce:

• Normal-hit particle quantity
• Critical-hit particle quantity
• High-speed critical particle quantity
• Particle lifetime
• Particle size

Target outlines and some rendering effects can also be disabled individually.

Compatibility

The main features have been tested in both clean and heavily modded environments.

The mod has also been tested alongside commonly used client-side rendering and interface mods. However, compatibility with every HUD, shader, rendering, entity-outline, or interface replacement mod is not guaranteed.

When using Iris with certain shader packs, target outlines may produce rendering warnings or visual differences. If this occurs, disable the world target outline option in the configuration menu.

Beta Notice

This project is currently in public beta.

The main features are available and functional, but additional compatibility problems or display issues may still be discovered.

When reporting a problem, please include:

• Minecraft version
• Fabric Loader version
• Fabric API version
• Mob Health Display version
• Installed mod list
• latest.log
• A screenshot or video showing the problem

License

Copyright © MoyuHero.

All Rights Reserved.

Modification, redistribution, re-uploading, or commercial distribution is not permitted without the author's permission.

---

中文介绍

Mob Health Display 是一款高度可配置的 Fabric 客户端目标血条模组。

当准星指向存活生物、玩家攻击生物，或玩家受到生物攻击时，模组会自动显示目标信息界面。界面包含目标模型预览、当前生命值、最大生命值、彩色生命条、护甲信息和近期伤害反馈。

模组还提供动态目标轮廓、受击染色、可调节的战斗粒子，以及完整的游戏内配置菜单。

为什么使用本模组？

Mob Health Display 可以帮助玩家更加直观地了解目标当前的战斗状态，不需要打开额外界面。

本模组适合希望获得以下功能的玩家：

• 清晰的目标生命值与护甲信息
• 造成伤害后的即时视觉反馈
• 能够适应不同屏幕布局的自定义 HUD
• 更有表现力的普通攻击和暴击效果
• 不需要服务器安装的客户端模组
• 中文和英文配置界面

主要功能

目标信息 HUD

• 显示目标当前生命值和最大生命值
• 使用数字显示具体生命值
• 显示绿色至黄色的平滑渐变生命条
• 目标受伤后显示延迟消退的红色伤害残留条
• 显示目标护甲信息
• 显示实时生物模型预览
• 自动适配不同体型目标的模型预览
• 支持调节 HUD 位置、大小和透明度

目标检测

• 选择准星指向的存活生物
• 自动锁定玩家攻击的生物
• 自动锁定攻击玩家的生物
• 支持调节目标检测距离
• 支持调节目标锁定时间
• 自动移除无效、死亡或已卸载的目标

视觉效果

• 青色、蓝色、紫色和粉色动态目标轮廓
• 粉蓝色受击染色效果
• 可调节目标轮廓动画速度
• 可调节受击染色持续时间
• 各项视觉效果均可单独开启或关闭

战斗粒子

• 普通攻击彩色粒子迸发
• 强化暴击粒子效果
• 可选择替换原版暴击效果
• 可选择替换原版受击心形效果
• 可调节普通攻击粒子数量
• 可调节暴击主体粒子数量
• 可调节暴击高速核心粒子数量
• 可调节粒子初始速度
• 可调节粒子重力
• 可调节粒子空气阻力
• 可调节粒子大小
• 可调节粒子生存时间
• 可调节粒子继承目标移动速度的比例
• 粒子具有地面碰撞和物理运动效果

配置菜单

本模组提供完整的游戏内配置菜单。

配置选项分为以下页面：

• HUD 与目标
• 视觉效果
• 粒子与物理

玩家可以在菜单中调节：

• 目标检测距离
• 目标锁定时间
• HUD 位置
• HUD 大小
• HUD 透明度
• 生物预览显示
• 护甲条显示
• 伤害残留条行为
• 目标轮廓效果
• 受击染色效果
• 普通攻击粒子
• 暴击粒子
• 粒子数量和物理参数

配置会自动保存至：

config/mobhealthdisplay.json

恢复默认设置按钮只会重置当前配置页面，不会影响其他页面的设置。

界面语言

配置菜单支持简体中文和英文。

提供三种界面语言模式：

• 跟随游戏
• 简体中文
• English

选择“跟随游戏”后，模组会根据 Minecraft 当前使用的语言自动选择配置界面语言。

玩家也可以在不修改 Minecraft 全局语言的情况下，强制让本模组使用简体中文或英文。

切换界面语言后，当前配置页面会立即刷新，不需要重新启动游戏。

语言模式会自动保存，并兼容旧版本生成的配置文件。

使用方法

出现以下情况时，目标 HUD 会自动显示：

• 准星指向存活生物
• 玩家攻击存活生物
• 存活生物攻击玩家

打开 Minecraft 的“选项”界面，然后点击 Mob Health Display 的设置按钮，即可进入配置菜单。

正常使用不需要设置额外快捷键。

运行要求

• Minecraft 26.1.2
• Fabric Loader
• Fabric API
• Java 25

安装方法

1. 安装适用于 Minecraft 26.1.2 的 Fabric Loader。
2. 安装对应版本的 Fabric API。
3. 将 Mob Health Display 的 JAR 文件放入 mods 文件夹。
4. 使用 Fabric 游戏配置启动 Minecraft。

本模组只需要安装在客户端。

服务器不需要安装本模组。

性能说明

较高的粒子数量、较大的粒子尺寸和较长的粒子生存时间，可能会在连续战斗时降低游戏性能。

配置较低的电脑可以优先降低：

• 普通攻击粒子数量
• 暴击主体粒子数量
• 暴击高速核心粒子数量
• 粒子生存时间
• 粒子大小

目标轮廓和部分渲染效果也可以单独关闭。

兼容性

本模组的主要功能已经在纯净环境和多模组环境中完成测试。

模组也与部分常用客户端渲染和界面模组进行了组合测试，但目前无法保证与所有 HUD、光影、渲染、实体轮廓或界面替换模组完全兼容。

在部分 Iris 光影环境下，目标轮廓可能产生渲染日志警告或显示差异。遇到这种情况时，可以在配置菜单中关闭“大世界目标轮廓”。

测试版说明

当前项目仍处于公开测试阶段。

主要功能已经可以正常使用，但后续仍可能发现新的兼容性问题或显示问题。

反馈问题时，请提供：

• Minecraft 版本
• Fabric Loader 版本
• Fabric API 版本
• Mob Health Display 版本
• 已安装的模组列表
• latest.log
• 能够展示问题的截图或视频

许可证

版权所有 © MoyuHero。

保留所有权利。

未经作者许可，不得修改后重新发布、搬运、再次上传或用于商业分发。