A sleek HUD mod for Minecraft: Java Edition using Fabric mod loader.
Automated dev builds available from Actions tab.
Reviews by Niche Duck: main mod (v1.2.2), config (v1.2.2). Mob arena gameplay with customized OneBar (v2.3.1) by agata_m
- Install Minecraft 1.16 or later
- Install Fabric Loader
- Download OneBar, Fabric API, Cloth Config API
- Place the JARs you downloaded to your Minecraft's mods folder
- Run the game!
Currently also works on Quilt, though no effort has yet been made to explicitly support it. See #21.
- Mod Menu - mod info, config GUI shortcut
- Catalogue - mod info, config GUI shortcut
- Sodium - mod version, config GUI shortcut
Previous versions compatible with
- Auto HUD - automatically shows and hides certain elements of OneBar as needed
- Raised - moves OneBar and hotbar upwards, height of both can be adjusted
- OneBar + MCC Island Compat (unofficial) - disables OneBar when you have no health bar on MCC Island
- Head-down display - partial compatibility for the auto-hide feature, does not hide OneBar elements
- Exordium (beta) - improve HUD performance
OneBar is meant to be contextual, showing the values and bars only when you need them. Tips:
- The positive effects, including health itself, are displayed left-to-right; negative effects are displayed right-to-left.
- If you get hungry, the hunger overlay is displayed over the health by its value.
- If you eat, you'll lose the overlay and the value, because you no longer need it.
- If you are also underwater, the water bar is displayed on top of health and hunger because it is the most important value in this case.
- Health is always the first number and hunger is almost always the last number (except when you have the hunger effect).
- Everything in between is an estimate, additional health or damage source (can be disabled).
- You can also enable "Show additional symbols" in options to get icons for those
- Remember old Minecraft without hunger and experience? This mod gives you a visually similar experience without losing modern functionality.
The mod only uses client-side data, so it is never needed on a server. There are also a lot of settings for configuring the colors and visibility of various elements.
- 1 represents any number.
- All emoji are white and look a bit different in-game. Text is shown when emoji are disabled (recommended for unicode or custom fonts).
- Estimates are a best guess based on what the client knows at the time, can change by server-side changes or natural occurences, displayed in italic. Can be disabled in options.
| Effect | Color | Bar | Emoji | Text | Description/comment |
|---|---|---|---|---|---|
| Health | Red | █ | 1 | 1 | Number indicates your health points. |
| Health boost | Red | █ | 1 | 1 | Bar width adapts to maximum health. |
| Health/health boost (extra symbols) | Red | █ | ❤1 | he1 | Shown when "Show additional symbols" is enabled in Text options. |
| Natural regeneration | Yellow | █ | →1 | →1 | Number indicates the resulting health. |
| Regeneration | Pink | █ | →1 | →1 | Number indicates the resulting health. |
| Absorption | +1 | +1 | Number indicates your absorption health points. | ||
| Absorption (extra symbols) | +💟1 | +ab1 | Shown when "Show additional symbols" is enabled in Text options; in-game the emoji looks like a heart in picture frame. | ||
| Resistance | +⛨1% | +re1% | Number indicates the player's resistance percentage (effect level × 20%). | ||
| Invisibility | +🫥 | +in | Crossed out when wearing armor pieces, an offhand item, or have glowing effect or arrow(s) stuck in you. | ||
| Totem of Undying | +ቶ1 | +tu1 | Opt-in, shows the amount of Totem of Undyings in your inventory; crossed out when these are not held in main or offhand. | ||
| Fire resistance | - |
- |
1× - burning, 2× - in fire, 3× - in soul fire, 4× - in lava, only shown while on fire. | ||
| Water Breathing, Conduit Power | Blue | █ | - |
- |
The bar is only shown if you got the effect after losing air, text is only shown while you are in water. |
| Breath of the Nautilus | Blue | █ | -⭘1⏸️ | -ap1 | The bar is only shown if you got the effect after losing air, text is only shown if you are in water, text is crossed if combined with water breathing-like effect. |
| Held food restored hunger: exact/less | Green | █ | →1 | →1 | Overlaid on hunger bar; number indicates the resulting hunger (like AppleSkin). |
| Held food restored hunger: wasted | Orange | █ | →-1 | →-1 | Overlaid on hunger bar; number indicates the waste of hunger (how much more than needed). |
| Saturation | Orange | ▁ | Below OneBar | Opt-in |
| Effect | Color | Bar | Emoji | Text | Description/comment |
|---|---|---|---|---|---|
| Hunger | Brown | █ | -1 | -1 | Number is 20 minus food points (e.g. if you had 15 food points, it would show 5). |
| Hunger (extra symbols) | Brown | █ | -🍖1 | -hu1 | Shown when "Show additional symbols" is enabled in Text options. |
| Hunger effect | Yellowish brown | █ | →1 | →1 | Number indicates the resulting hunger. |
| Getting hungrier | ↓ | ↓ | Opt-in, shown when saturation is zero. | ||
| Air | Blue | █ | -⭘1 | -ai1 | Number indicates the amount of air bubbles missing in vanilla. |
| Freezing | Light gray | █ | -❄1 | -fr1 | Number indicates the frost fading screen effect state. |
| Burning | Orange | █ | -🔥1× | -bu1× | 1× - burning, 2× - in fire, 3× - in soul fire, 4× - in lava |
| Poison | Yellowish green | █ | →1 | →1 | Number indicates the resulting health. |
| Wither | Dark gray | █ | →1 | →1 | Number indicates the resulting health. |
| Warden anger | Dark teal | █ | -💢1 | -wa1 | Number indicates the closest warden's anger level towards the player. 20-11 - angry, chasing; 10-6 - agitated, 5-0 - calm, can despawn. |
| Levitation | Dark purple | █ | -⏏1 | -le1 | Number indicates the effect time in seconds; crossed out while in water. |
| Fall height (experimental) | -⊻1 | -fa1 | Opt-in, number indicates the amount of blocks you're about to fall in-air/with levitation effect/while sneaking on an edge. Currently does not consider the target block type, your effects and enchants. | ||
| Glowing | -☀ | -gl | |||
| Infested | -💔🐛 | -Hin | Having the infested effect may summon silverfish upon getting hit. | ||
| Bad Omen | -👹?1× | -bo1× | Number indicates the effect level. | ||
| Impending death | →0 | →0 | Drowning, freezing damage, burning in fire/lava, starvation, suffocation, angry warden. Zero is the resulting health (death) | ||
| Hardcore mode | -☠ | -HC | The vanilla world state, not to be confused with the UHC mode of OneBar | ||
| Weaving | -😵🕸 | -Dwe | Opt-in, having the weaving effect may summon cobwebs upon death. | ||
| Oozing | -😵▪▪ | -Doo | Opt-in, having the oozing effect may summon two slimes upon death. | ||
| Wind Charged | -😵💨 | -Dwi | Opt-in, having the wind charged effect may summon a wind charge upon death. | ||
| Raid Omen | -👹🪓1w | -ro1w | Number indicates the total amount of raid waves. | ||
| Trial Omen | -👹🗝1m | -to1m | Number indicates the remaining minutes of ominous trial. |
| Effect | Color | Bar | Emoji | Text | Where | Description/comment |
|---|---|---|---|---|---|---|
| Mount health | Orange | █ | 1 | 1 | Above OneBar | Similar to OneBar itself |
| Mount health (extra symbols) | Orange | █ | 💝1 | mh1 | Above OneBar | When enabling "Show additional symbols" in Text options |
| Mount jump | Brown | ▄▄ or █ | 1.0 | 1.0 | Below crosshair | Vertical (horse and others) or horizontal (camel) bar, number shows approximate height of blocks the mount can jump (no est. for camels yet) |
| Camel cooldown | Orange-red | ▄▄ | -1 | -1 | Below crosshair | Decreasing horizontal bar, number shows time in seconds before the camel can jump or move again |
| Effect | Color | Bar | Emoji | Text | Where | Description/comment |
|---|---|---|---|---|---|---|
| Armor | White | ▔ | Above OneBar, above mount health | Equivalent of vanilla's armor indicator; also shown for horses if applicable | ||
| Armor durability | Light blue | ▔ | Overlaid on armor bar | Opt-in, width adapts to armor bar or armor bar segment | ||
| Segmented armor | White | ▔ | Above OneBar | Opt-in, similar to normal bar but each armor piece is a separate bar | ||
| Elytra durability | Purple | ▔ | Armor bar area | Normal armor bar: displayed as a full-width overlay only when flying; segmented armor bar: displayed constantly as a diamond-width bar at chest segment. | ||
| Shield durability | Gray | ▔ | Armor bar area | Opt-in, full-width durability bar overlaying armor bar only when holding up a shield | ||
| Shield cooldown | Orange | ▔ | Armor bar area | Opt-in. Holding delay: shield durability bar with cooldown color; axe-nerfed: cooldown bar until you can use shield again | ||
| Mob head indicator | +a☻1 | +aH1 | OneBar | Opt-in, "a" represents each mob's initial, except e̲nderman (carved pumpkin) and g͟olden (any golden armor or piglin head) and l͟ocator (player, dragon and wither skeleton head - these only affect locator bar). Number indicates the minimum amount of blocks the player can safely stand from the mob when wearing its head (rounded, considers sneaking and invisibility). |
| Effect | Color | Bar | Text | Where | Description/comment |
|---|---|---|---|---|---|
| Experience bar | Green | ▁ | 1 | Next to hotbar | Shown only when you have any XP (configurable) |
| Lapis Lazuli counter | Blue | 1 or 1× | Next to experience bar | Opt-in, shows either the raw count or times enchantable maxed out (XP level 30+) | |
| Saturation | Orange | ▁ | Below OneBar | Opt-in | |
| Locatability indicator | -🔍 or -lo | On OneBar | Opt-in, shows when locator bar is available on the server (even if you hide it) and you are visible to others. | ||
| Mending indicator | Pink | 🔧 or md | Next to experience bar | Opt-in, shown when holding something with mending enchant that needs repair |
Q: Why do I have to download Cloth Config API separately?
A: Because it's big, gets updated a lot and you probably have a mod or two that requires it anyway. If one of your mods already bundles it, you don't have to download it at all :)
Q: How do I edit the colors?
A: Click Esc → Mods → OneBar → config button. Colors are formatted as opacity + RGB in HEX, so choose an opacity from this list and use any HEX color picker for choosing a color. For example if I want 80% opacity (CC) on blue (0000FF), I will enter #CC0000FF.
Q: Can I use this with minigames?
A: Yes! There are options to disable hunger display or enable UHC mode, plus you can toggle those or entire OneBar with a keybind (if you set one).
Q: Can I use this in my favorite server?
A: Yes. If things like AppleSkin and effect HUDs are allowed, you can use the full featureset of OneBar. If they are not, just disable effect estimates to use it for essentially only health and hunger.
Q: (Neo)Forge support?
A: No. Feel free to fork according to the license or check out my resource pack that inspired this.
Q: Backports?
A: No. There are old versions available down to 1.16.5 though.
Q: Snapshots?
A: Maybe. If I have time, I might do targeted updates, but otherwise as long as you have the latest Cloth Config and Fabric API, it could run anyway.
Q: April Fool's versions?
A: Yes, every April Fool's snapshot since 2022 is supported and marked as such on Modrinth.