Skip to main content

​
Get Connected

BetterHud has a vibrant community across multiple platforms. Join us to get support, share your creations, and stay updated on the latest developments!

​
Discord

Join our Discord server for real-time community support, discussions, and announcements.

BetterHud Discord

Chat with other users, get help from the community, and share your HUD creations.
The Discord server is the best place to:
  • Get quick help with setup and configuration
  • Share screenshots and videos of your HUDs
  • Discuss feature requests and suggestions
  • Connect with other server owners using BetterHud
  • Get early news about updates and releases

​
GitHub

The official BetterHud repository is where development happens.

BetterHud Repository

View source code, report bugs, request features, and contribute to development.
On GitHub, you can:
  • Report Bugs: Submit detailed bug reports with logs and reproduction steps
  • Request Features: Suggest new features and improvements
  • Contribute Code: Submit pull requests to improve BetterHud
  • Track Development: Follow the development progress and roadmap
  • Read Releases: View detailed changelogs for each version

​
Download Platforms

BetterHud is available on multiple plugin/mod distribution platforms:

SpigotMC

Download for Bukkit/Spigot/Paper servers

Hangar

Official PaperMC plugin repository

Modrinth

Modern plugin and mod platform

GitHub Releases

All platforms and versions

​
Project Resources

​
Documentation

Official Wiki

Legacy wiki with additional guides and information

This Documentation

Comprehensive documentation for all BetterHud features

​
Code Quality & Metrics

CodeFactor

Code quality analysis and metrics

bStats

Plugin usage statistics and metrics

​
Contributing

BetterHud is open source and welcomes contributions from the community!

​
Ways to Contribute

Report Bugs

Found an issue? Report it on GitHub Issues with detailed information.

Suggest Features

Have an idea? Create a feature request on GitHub.

Contribute Code

Developer? Submit pull requests to improve BetterHud.

Share Examples

Created an awesome HUD? Share it with the community on Discord!

Write Guides

Help others by writing tutorials and guides.

Answer Questions

Support other users in Discord and GitHub Discussions.
See the Contributing Guide for detailed information on how to contribute to BetterHud.

​
Community Guidelines

To keep our community welcoming and productive, please:
Be respectful and kind to all community members
Search for existing issues before creating new ones
Provide detailed information when asking for help
Share your knowledge and help others when you can
Give credit when using others’ HUD designs or code
Please avoid:
  • Asking about unsupported platforms (Bedrock, ArcLight, etc.)
  • Requesting support for closed-source mods (Optifine, ItemsAdder)
  • Posting personal server issues unrelated to BetterHud
  • Demanding features or immediate responses

​
API & Developer Resources

For developers building integrations or plugins:

​
Maven Central

BetterHud API is published to Maven Central: 
repositories {
    mavenCentral()
}

dependencies {
    compileOnly("io.github.toxicity188:BetterHud-standard-api:VERSION")
    compileOnly("io.github.toxicity188:BetterHud-bukkit-api:VERSION") // Bukkit
    // or
    modCompileOnly("io.github.toxicity188:BetterHud-fabric-api:VERSION") // Fabric
    compileOnly("io.github.toxicity188:BetterCommand:VERSION")
}

​
Example Projects

Bukkit Example

Example Bukkit plugin integrating with BetterHud

Fabric Example

Example Fabric mod integrating with BetterHud

​
API Documentation

For detailed API documentation:
  • See the API Reference section of this documentation
  • Build Javadocs locally: ./gradlew javadocJar
  • Check example projects for real-world usage patterns

​
Stay Updated

​
Release Channels

BetterHud has two release channels:
  • Release: Stable, tested versions for production use
  • Snapshot: Bleeding-edge builds with latest features (may be unstable)
Follow releases on:
  • GitHub Releases: All versions with detailed changelogs
  • Discord: Announcements channel for release notifications
  • Hangar/Modrinth: Automatic notifications if you follow the project

​
Changelog

View the full version history and changes in the Changelog.

​
Support the Project

If you enjoy using BetterHud, consider supporting the developer:

GitHub Sponsors

Support BetterHud development through GitHub Sponsors
You can also support by:
  • Starring the repository on GitHub
  • Writing positive reviews on plugin sites
  • Sharing BetterHud with other server owners
  • Contributing code or documentation improvements
  • Helping other users in the community

​
Credits

BetterHud is developed and maintained by toxicity188.

​
Libraries & Dependencies

BetterHud is built using many excellent open-source libraries:
  • Kotlin - Modern JVM language
  • Adventure - Component library by KyoriPowered
  • BetterCommand - Multi-platform command framework
  • exp4j - Mathematical expression parser
  • Gson - JSON parser/writer
  • SnakeYAML - YAML parser
  • HikariCP - Database connection pooling
  • ExpiringMap - Cache implementation
  • semver4j - Semantic versioning
  • bStats - Plugin metrics
See the README for the complete list.
A huge thank you to all contributors and community members who make BetterHud better every day!

Build docs developers (and LLMs) love

Get started for freeTalk to us