HUD
Keep useful information on your players' screens at all times: money, level, compass, coordinates, region, time or your own text.
The HUD module shows information on your players' screens all the time, without any chat message: their money, level, a compass, coordinates, the region they are in, the time of day or any text you want. With the resource pack, the HUD sits at the top of the screen with icons and elements placed left, center and right. Players can hide it whenever they want with /hud.
This module requires the complete edition. See editions.
Features
- Ready to use layouts: Survival (money, compass and level), Explorer (coordinates, compass, region and time), Minimal (just the compass) and Complete (everything on two rows).
- Element types: Money, Level, Compass, Coordinates, Region, Time and Text.
- Free placement. Each element is anchored left, center or right, can be shifted in pixels, and goes on row 1 or row 2.
- Icons. Put an image from your resource pack next to any element. Coin, level, pin, clock and flag icons are added to your pack the first time.
- Live preview in the web editor, with real sample values.
- Fallback for players without the pack. Players who refuse the resource pack see a simple line above the hotbar instead.
- Smart pause. When the HUD is above the hotbar and InglisCore shows a message in the same spot, the HUD steps aside for a few seconds.
- Per player choice. Players hide or show the HUD with
/hud, and their choice is remembered.
Setting it up
Open HUD in the web editor. Pick a ready to use layout or click Add an element, then move the sliders and watch the preview.
Elements
You can add up to 24 elements. For each one:
| Field | What it does |
|---|---|
| Type | Money, Level, Compass, Coordinates, Region, Time or Text. |
| Row | Row 1 or row 2. Two rows only show at the top of the screen. |
| Text | What is shown. Colors, pack images and placeholders work. Each type comes with the right placeholder already filled in. |
| Icon | An image from your resource pack shown before the text, or No icon. Most types come with a matching icon. |
| Anchor | Left, Center or Right. |
| Shift | Moves the element in pixels from its anchor. |
An element whose placeholder returns nothing is hidden, for example the level when its module is disabled.
General
| Setting | What it does | Default |
|---|---|---|
| Display | Top of the screen uses the resource pack. Above the hotbar is simpler and works without it. | Top of the screen |
| Refresh (ticks) | How often the HUD updates. 20 ticks = 1 second. | 10 |
| HUD width | Space in pixels used by the elements placed left and right. | 400 |
| Hidden bar color | This boss bar color becomes invisible for players. Change it only if another plugin uses it. | Yellow |
| Worlds without HUD | Worlds where the HUD is not shown. | Empty |
At the top of the screen, the HUD is drawn in a boss bar made invisible by the resource pack. If another plugin shows yellow boss bars, choose another Hidden bar color so its bars stay visible.
Commands
| Command | What it does | Permission |
|---|---|---|
/hud |
Hides or shows your HUD. | inglis.hud.use (everyone) |
/hud on |
Shows your HUD. | inglis.hud.use |
/hud off |
Hides your HUD. | inglis.hud.use |
Permissions
| Permission | What it grants |
|---|---|
inglis.hud.use |
See the HUD and use /hud. Given to everyone by default. Remove it from a rank to hide the HUD for that rank. |
Placeholders
The HUD module adds these placeholders. They work in the HUD and anywhere PlaceholderAPI placeholders are accepted. See placeholders for the full list.
| Placeholder | Shows |
|---|---|
%ingliscore_hud_compass% |
A compass centered on the direction the player faces. |
%ingliscore_hud_direction% |
The direction the player faces, such as N or SE. |
%ingliscore_hud_coords% |
The player's X, Y and Z coordinates. |
%ingliscore_hud_x% |
The player's X coordinate. |
%ingliscore_hud_y% |
The player's Y coordinate. |
%ingliscore_hud_z% |
The player's Z coordinate. |
%ingliscore_hud_region% |
The name of the region the player is in, or Wilderness. |
%ingliscore_hud_time% |
The time of day in the player's world, such as 14:30. |
%ingliscore_hud_level% |
The player's level: the progression level when that module is on, otherwise the Minecraft experience level. |
%ingliscore_hud_xpbar% |
A bar showing the progress to the next level. |
Tips
- Players who just joined see the HUD once their resource pack has loaded. If the pack does not load within 45 seconds, they get the line above the hotbar.
- Placing elements left and right at the top of the screen needs Minecraft 1.19 or newer on the server. On older versions, the elements are shown side by side.