Skip to main content

What is BetterHud?

BetterHud is a powerful server-side HUD implementation for Minecraft that allows you to create custom HUDs, popups, and compass markers without requiring client-side mods. It automatically generates resource packs and supports multiple platforms.

Server-Side

No client mods required - everything runs on the server

Auto Resource Pack

Automatically generates and distributes resource packs to players

Multi-Platform

Works on Bukkit, Velocity, and Fabric servers

Key Features

Display Elements

  • Images: Display static images, PNG sequences, and animated content
  • Text: Render custom text with custom fonts
  • Player Heads: Show player heads dynamically
  • Animations: Create smooth animations using mathematical equations

Platforms Supported

Supports Minecraft versions 1.20.4 - 1.21.11No dependencies required - works out of the box.
Supports Velocity versions 3.3 - 3.4Perfect for proxy-level HUD management across multiple servers.
Supports Minecraft 1.21.11Requires Fabric API to be installed.

Use Cases

Custom Health & Hunger Bars

Replace vanilla UI elements with custom designs

Boss Bars & Indicators

Create dynamic boss health displays

Compass & Waypoints

Add navigation markers and directional indicators

Popups & Notifications

Display temporary notifications and alerts

Built-in Integrations

BetterHud includes support for popular plugins and frameworks:
  • PlaceholderAPI: Use PAPI placeholders in your HUD elements
  • Skript: Create HUD logic using Skript syntax
  • Database Support: MySQL integration with HikariCP for data persistence

Example: Skript Integration

command /pointadd:
    trigger:
        # Add compass markers
        point add location at 0, 0, 0 in world "world" named "test1" to player
        point add location at 10, 0, 0 in world "world" named "test2" with icon "other" to player

command /popup:
    trigger:
        # Show popup with custom variables
        set {_o::rand} to random integer between 1 to 100
        show popup "test_popup" to player with variable of {_o::*}

Technical Foundation

BetterHud is built with modern technologies:
  • Kotlin: Functional programming for better performance
  • Adventure API: Multi-platform component support
  • exp4j: Mathematical equation evaluation for animations
  • Gson & SnakeYAML: Configuration parsing

Next Steps

Installation

Install BetterHud on your server

Quick Start

Create your first custom HUD

Build docs developers (and LLMs) love