A Minetest mod which replaces the default health and breath bar by nice-looking HUD bars and provides a powerful API for modders to add custom HUD bars. https://content.minetest.net/packages/Wuzzy/hudbars/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Wuzzy dd2a9a008d Add mailmap for Wuzzy 4 months ago
locale Add Spanish translation 3 years ago
textures Revert "12×12 textures, compress textures" 2 years ago
.mailmap Add mailmap for Wuzzy 4 months ago
API.md Allow to specify number format strings explicitly 3 years ago
README.md Version 2.3.3 1 year ago
default_settings.lua Move default settings into new Lua file 5 years ago
init.lua Fix massive hud_change spam (hide/unhide) 1 year ago
mod.conf Move description into mod.conf 4 years ago
screenshot.png Use new screenshot with 3:2 aspect ratio 6 years ago
settingtypes.txt Move statbars 2 pixels up 6 years ago


HUD bars


This mod changes the HUD of Minetest. It replaces the default health and breath symbols by horizontal colored bars with text showing the number.

Furthermore, it enables other mods to add their own custom bars to the HUD, this mod will place them accordingly.

Important: Keep in mind if running a server with this mod, that the custom position should be displayed correctly on every screen size.

Current version

The current version is 2.3.3. It works for Minetest 5.3.0.

This software uses semantic versioning, as defined by version 2.0.0 of the SemVer standard.


This mod can be configured quite a bit. You can change HUD bar appearance, offsets, ordering, and more. Use the advanced settings menu in Minetest for detailed configuration.


The API is used to add your own custom HUD bars. Documentation for the API of this mod can be found in API.md.

License of source code

Author: Wuzzy (2015)

Also: This mod was forked from the “Better HUD” [hud] mod by BlockMen.


  • German: Wuzzy
  • Portuguese: BrunoMine
  • Turkish: admicos
  • Dutch: kingoscargames
  • Italian: Hamlet
  • Malay: muhdnurhidayat
  • Russian: Imk
  • Spanish: wuniversales

This program is free software. It comes without any warranty, to the extent permitted by applicable law. You can redistribute it and/or modify it under the terms of the MIT License.

Licenses of textures

  • hudbars_icon_health.png—celeron55 (CC BY-SA 3.0), modified by BlockMen
  • hudbars_bgicon_health.png—celeron55 (CC BY-SA 3.0), modified by BlockMen
  • hudbars_icon_breath.png—kaeza (MIT License), modified by BlockMen, modified again by Wuzzy
  • hudbars_bgicon_breath.png—based on previous image, edited by Wuzzy (MIT License)
  • hudbars_bar_health.png—Wuzzy (MIT License)
  • hudbars_bar_breath.png—Wuzzy (MIT License)
  • hudbars_bar_background.png—Wuzzy (MIT License)

License references