BetterHealthBar is a high-performance, strictly optimized fork of BetterHealthBar3, engineered specifically for the BTC Studio infrastructure. This fork drops support for legacy platforms (Spigot, versions older than 1.21.11) to provide native, blazingly fast integration with Paper and Folia.
Warning
PLATFORM COMPATIBILITY NOTICE This fork is STRICTLY for Paper 1.21.11+ and Folia 1.21.11+. Legacy compatibility layers have been removed to maximize performance. If you are not running modern Paper/Folia, this plugin will not function.
- Folia Native Support: Leverages
FoliaSchedulerfor correct Regionized Multithreading support, ensuring health bars update safely and efficiently across parallel regions. - Asynchronous Processing: Heavy lifting like health bar creation and packet construction is handled asynchronously to prevent main-thread stalls.
- Java 21 Native: Leveraging the latest JVM optimizations for maximum throughput and memory efficiency.
- Paper/Folia Exclusive: Removed legacy NMS adapters (1.19.4 - 1.21.9) and Spigot compatibility code. The plugin now interacts directly with the server internals for 1.21.11+.
- Efficient Sight Tracing: ray-tracing logic optimized for performance (
look-degree,look-distance) to ensure health bars appear only when relevant without lag.
- Core Shaders: Custom shader support to fix z-fighting issues, ensuring health bars render cleanly.
- Stack System: Advanced stack system support for buff/debuff visualization.
- ModelEngine Compatibility: Native support for ModelEngine with automatic height detection.
- Seamless Support: Native integration with BTC Mobs, mirroring the deep compatibility found with MythicMobs.
- Auto-Hide: Automatically hides default BTC Mob nameplates/text displays to let BetterHealthBar take over.
- Placeholders:
%btcmobs%: Displays the mob's internal name (or display name if available).%btcmobs_level%: Displays the mob's current level.
BetterHealthBar is primarily tuned via config.yml.
| Key | Default | Description |
|---|---|---|
pack-type |
FOLDER |
How the resource pack is generated (FOLDER or ZIP). |
look-distance |
15.0 |
Maximum distance to render health bars. |
look-degree |
20.0 |
Angle field of view for showing health bars. |
use-core-shaders |
true |
Enables custom shaders to fix z-fighting (Recommended). |
enable-self-host |
false |
Enables built-in HTTP server for resource pack hosting. |
self-host-port |
8163 |
Port for the self-hosted resource pack server. |
show-me-healthbar |
true |
Toggles visibility of your own health bar. |
disable-to-invisible-mob |
true |
Hides health bars for invisible mobs. |
Requires Java 21.
# Clean and compile the project
./gradlew clean buildThis project is built upon the innovation of the broader Minecraft development community:
- BetterHealthBar3 - The original project by toxicity188.
- Custom BTC-CORE Patches: Proprietary to BTC Studio.
- Upstream Source: Original licenses apply to their respective components from BetterHealthBar3.
Fork maintained by BTCSTUDIO