Requirements
- Minecraft 1.21.11
- Fabric Loader
- Fabric API (required dependency)
- Java 21 or higher
Installation
- Install Fabric Loader on your server
- Download and install Fabric API
- Download BetterHud from Modrinth
- Place both JARs in your server’s
modsfolder - Start your server
Platform-Specific Features
Fabric Bootstrap
Access the Fabric-specific bootstrap:Event System
BetterHud provides a custom event system for Fabric:Pre-Reload Event
Post-Reload Event
Fabric Event Triggers
Create custom triggers using Fabric events:Built-in Fabric Events
BetterHud provides several built-in Fabric events:PlayerAttackEntityEvent
PlayerDamageByEntityEvent
PlayerKillEntityEvent
PlayerDeathEvent
Mixins
BetterHud uses Mixin to integrate with Minecraft:Building from Source
To build the Fabric mod:dist/build/libs/.
API Usage
Add BetterHud to your Fabric mod:Fabric Mod Integration
Integrate BetterHud into your Fabric mod:Configuration
Fabric-specific configuration options:Resource Pack Generation
BetterHud automatically generates resource packs on Fabric:config/BetterHud/build/.
Performance
Mixin Performance
BetterHud’s mixins are optimized for minimal performance impact:- Entity mixins only inject where necessary
- Packet handling is asynchronous where possible
- Event callbacks are cached
Memory Usage
Fabric implementation uses efficient data structures:Compatibility
Other Fabric Mods
BetterHud is compatible with most Fabric mods. If you encounter issues:- Check mixin conflicts in logs
- Ensure Fabric API is up to date
- Report compatibility issues on GitHub
Client-Side Mods
BetterHud is server-side only. Clients don’t need any mods installed, just the resource pack.Debugging
Enable detailed logging:config/BetterHud/logs/.
Next Steps
Triggers
Learn about Fabric event triggers
Placeholders
Create custom placeholders
API Reference
Explore the full API
Example Mod
View example implementations
