BetterHud

Multiplatform server-side HUD implementation of Minecraft

This project implements a server-side HUD.

• Supports auto-generating resource pack.
• Supports display image(include png sequence), text, head.
• Supports animation.

Platform

• Bukkit(with Folia) 1.21–26.1.x
• Velocity 3.3-3.5
• Fabric server 26.1.x

Library

• kotlin stdlib: Implements better functional programming.
• adventure: Implements multi-platform component.
• bstats: Implements metrics.
• exp4j: Implements equation.
• snakeyaml: Implements yaml parser.
• gson: Implements json parser/writer.
• better command: Implements multi-platform supporting command.
• expiring map: Implements cache map.
• HikariCP: Implements comfortable DB handling.
• mysql-connector-j: Implements MySQL connector.
• semver4j: Implements semver parser and comparator.

Dependency

• Bukkit: No
• Velocity: No
• Fabric server: Fabric API

Build

Requires Java 25 Eclipse Adoptium.

• Build all available jar: ./gradlew build
• Build Bukkit plugin: ./gradlew pluginJar
• Build Velocity plugin: ./gradlew velocityJar
• Build Fabric server side mod: ./gradlew fabricJar
• Build source code jar: ./gradlew sourcesJar
• Build dokka-based docs jar: ./gradlew javadocJar

API

Bukkit example plugin
(BetterHud for Bukkit)

repositories {
    mavenCentral()
}

dependencies {
    compileOnly("io.github.toxicity188:BetterHud-bukkit-api:VERSION") //Bukkit api
}

Fabric example mod
(BetterHud for Fabric)

repositories {
    mavenCentral()
}

dependencies {
    compileOnly("io.github.toxicity188:BetterHud-mod-api:VERSION") //Platform api
}

Use BetterHud with Skript

Go to download Skript

command /pointadd:
    trigger:
        #compass marker add
        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 /pointremove:
    trigger:
        #compass marker remove
        point remove "test1" to player
        point remove "test2" to player

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