Changelog - BetterHud

This page documents the version history and changes made to BetterHud across releases.

For the most up-to-date changelog information, visit the GitHub Releases page.

Version 1.14.x

1.14.2

Release Date: Latest

Full changelog

1.14.1

Features:

Added support for Minecraft 1.21.11
Dropped support for ≤1.20.2 clients

Dependency Updates:

Updated Adventure to 4.26.1
Updated Fabric Loader to 0.18.4
Updated ASM to 9.9.1
Updated Netty to 4.2.9.Final
Updated Nexo to 1.16.1
Updated Kyori mod implementation to 6.8.0
Updated MythicMobs to 5.11.1
Updated Skript to 2.13.2
Updated Kotlin to 2.3.0
Updated Dokka to 2.1.0
Updated Polymer to 0.15.1+1.21.11
Updated various build plugins and dependencies

Build Changes:

Updated GitHub Actions checkout to v6
Updated Gradle to 9.2.1
Updated Hangar publish plugin to 0.1.4
Updated run-paper plugin to 3.0.2

Full changelog

1.14.0

Breaking Change: MMOCore API has changed. Update MMOCore if you’re using its placeholders in BetterHud.

Features:

Added support for Minecraft 1.21.9 and 1.21.10
Auto-merge with Nexo and CraftEngine resource packs
Pack hash to avoid generating duplicate resource packs

Dependency Updates:

Updated Adventure to 4.25.0
Updated Kotlin to 2.2.20
Updated HikariCP to 7.0.2
Updated ASM to 9.9
Updated Fastutil to 8.5.18
Updated SnakeYAML to 2.5

Version 1.13.x

1.13.2

Fixes:

Added support for Minecraft 1.21.8 server
Fixed hide exp option
Improved legacy NeoForge compatibility

This is a hotfix release for 1.21.8 server support.

1.13.1

Minor update with bug fixes and improvements.

1.13.0

Major feature release with new capabilities and optimizations.

Version 1.12.x

1.12.2

Patch release with bug fixes.

1.12.1

Patch release with bug fixes.

1.12

Future Compatibility Notice: Due to shader changes in Minecraft snapshot 25w07a, some features may not be compatible with Minecraft 1.22:

Option static-scale
Some text effects

Fixes:

Fixed image name duplication
Fixed popup initialization
Fixed YAML synchronization
Fixed shaders (requires deletion of BetterHud/shaders/text.vsh)
Fixed database issues
Updated BetterCommand to 1.4.3
Updated Adventure to 4.19.0

New Features:

Added flip option in image element
Added reversed option in image layout

Example:

image_armor:
  type: sequence
  flip:
    - y
  files:
    - "armor/armor_empty.png"
    - "armor/armor_half.png"
    - "armor/armor_full.png"

layout_armor:
  images:
    armor:
      name: image_armor
      stack: "armor@t/2-1/10"
      max-stack: 10
      space: 0
      reversed: true

New Placeholders (Bukkit):

mmocore_is_loaded (MMOCore)
mythicmobs_entity_id (MythicMobs)

Version 1.11.x

Multiple patch releases with stability improvements and bug fixes.

Version 1.10.x

1.10.3

Patch release with bug fixes.

1.10.2

Patch release with bug fixes.

1.10.1

Patch release with bug fixes.

1.10

Breaking Change: Support for Oraxen 2.0 has been dropped. Use Nexo instead.

Platform Support:

Added support for Minecraft 1.21.4
Nexo support now available

Major New Features:

Children Image System

Allows dynamic image replacement based on conditions:

children_full:
  type: single
  file: "children/full.png"
  setting:
    children:
      - children_half
      - children_container
    children-mapper:
      children_container:
        1:
          first: health_percentage
          second: 0.33
          operation: "<"
      children_half:
        1:
          first: health_percentage
          second: 0.66
          operation: "<"

Or with wildcard:

children_full:
  type: single
  file: "children/full.png"
  setting:
    children: *  # All available images
    follow: "skript_variable:your_value"

Maven Central Publishing

API now available on Maven Central:

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

Color Overrides

Dynamic color changes based on conditions:

test_layout:
  heads:
    1:
      name: test_head
      align: center
  texts:
    1:
      name: test_text
      pattern: |
        Text1
        Text2
  color-overrides:
    1:
      color: "#FF8080"
      conditions:
        1:
          first: health_percentage
          second: 0.33
          operation: "<"

Static Scale Rendering

test_head:
  heads:
    1:
      name: test_head
      type: fancy
      render-scale:
        x: 3.0
        y: 3.0
        static-scale: true

Placeholder Options

test_text:
  texts:
    1:
      name: unifont
      pattern: |
        [name]
        [health_percentage]%
      placeholder-option:
        evaluate: t * 100
        join: " "
      placeholder-string-format:
        number: "#,###"

New Commands:

hud turn on|off <player> - Control HUD visibility per player

New Config Options:

disable-legacy-offset: false  # Enables correct pixel offset when true

Improvements:

Removed space constraint in text layout
Fixed placeholder comma handling
Fixed Folia adaptation
Fixed layout identifier
Fixed render scale calculation
Optimized text renderer

Dependency Updates:

Updated to BetterCommand 1.4
Updated to Kotlin 2.1.0

Version 1.9.x

1.9.2

Patch release with bug fixes.

1.9.1

Patch release with bug fixes.

1.9

Feature release with enhancements and optimizations.

Version 1.8

Major update with significant new features and improvements.

Version 1.7

Stability and performance improvements.

Earlier Versions

For changelog information on versions prior to 1.7, please refer to the GitHub Releases page or individual changelog files in the repository.

Viewing Full Changelogs

Detailed changelogs for each version are available:

GitHub Releases

Complete release notes with downloadable builds

GitHub Compare

Compare any two versions to see code changes

Release Channels

BetterHud has two release channels:

Release

Stable versions tested for production use

Full changelog and documentation

Recommended for most users

Release versions follow semantic versioning (e.g., 1.14.2).

Snapshot

Bleeding-edge builds with latest features. May be unstable. Use at your own risk.

Snapshot builds are published to Hangar with:

Latest commits and experimental features
Minimal testing
Rapid iteration
Not recommended for production servers

Changelog for snapshots is often the commit message.

Update Guide

When updating BetterHud:

Read the Changelog

Check for breaking changes and new features in the version you’re updating to.

Backup Your Data

Always backup your BetterHud configuration and any custom HUDs before updating.

Test in Development

Test the new version on a development server first if possible.

Update Dependencies

Check if any integrated plugins (MMOCore, etc.) need updates for compatibility.

Review Config Changes

Some updates may add new config options or change existing ones.

Major version updates (e.g., 1.x to 2.x) may contain breaking changes requiring configuration updates.

Deprecation Policy

BetterHud follows these deprecation practices:

Features marked as deprecated will be supported for at least one more major version
Deprecated features will show warnings in logs
Migration guides provided for breaking changes
API changes maintain backward compatibility within major versions when possible

Reporting Issues

Found a bug in the latest version?

Check if it’s already reported in GitHub Issues
Verify you’re using the latest version
Report with full details (see Troubleshooting)

Feature Requests

Have an idea for a future version?

Search existing feature requests
Create a detailed feature request on GitHub
Discuss in the Discord community

Community

Development

​Version 1.14.x

​1.14.2

​1.14.1

​1.14.0

​Version 1.13.x

​1.13.2

​1.13.1

​1.13.0

​Version 1.12.x

​1.12.2

​1.12.1

​1.12

​Version 1.11.x

​Version 1.10.x

​1.10.3

​1.10.2

​1.10.1

​1.10

​Children Image System

​Maven Central Publishing

​Color Overrides

​Static Scale Rendering

​Placeholder Options

​Version 1.9.x

​1.9.2

​1.9.1

​1.9

​Version 1.8

​Version 1.7

​Earlier Versions

​Viewing Full Changelogs

GitHub Releases

GitHub Compare

​Release Channels

​Release

​Snapshot

​Update Guide

​Deprecation Policy

​Reporting Issues

​Feature Requests

Build docs developers (and LLMs) love

Version 1.14.x

1.14.2

1.14.1

1.14.0

Version 1.13.x

1.13.2

1.13.1

1.13.0

Version 1.12.x

1.12.2

1.12.1

1.12

Version 1.11.x

Version 1.10.x

1.10.3

1.10.2

1.10.1

1.10

Children Image System

Maven Central Publishing

Color Overrides

Static Scale Rendering

Placeholder Options

Version 1.9.x

1.9.2

1.9.1

1.9

Version 1.8

Version 1.7

Earlier Versions

Viewing Full Changelogs

Release Channels

Release

Snapshot

Update Guide

Deprecation Policy

Reporting Issues

Feature Requests