
Krool World UI
HUD and UI additions: skill XP (experience) bars with level-up text, a carry weight / encumbrance bar, food timer reminders and notifications, and max health lost to food decay. Client-side; every feature toggles in an F7 settings menu.
Small HUD additions for Valheim that show what the game keeps hidden: how close a skill is to its next level, how much you are carrying, how much health your food has lost, and when to eat.
- Client-side only. The server and other players do not need it.
- Read-only. It reads game state for display and never changes your character or world.
- Pick what you want. Every feature has its own on/off switch in an in-game settings window (F7). No other config mod needed.
At a glance
| Feature | What you get | On by default |
|---|---|---|
| Skill XP bars | A skill icon with an XP bar that fills as you earn XP, plus a floating +0.8% Swords |
Yes |
| Carry weight | A vertical weight bar beside your food, styled like the health bar | Yes |
| Food max health | A faint red segment on the health bar: the max health your food has lost as it wears off | Yes |
| Food reminders | A toast when food runs low, a message while you have none, and an optional "can eat again" | Yes ("can eat again" off) |
| Settings window | Every option in game, with a live preview | Press F7 |
Skill XP bars
Swing an axe and a Woodcutting tile appears at the bottom right of the screen, just above the key hints: the skill's icon, with its XP bar underneath.
- See every gain. The darker part of the bar is where you were when the tile appeared. The lighter part is what you have earned since, so each swing visibly adds to it, carrying over through a level-up.
- Lines up neatly. Each skill gets its own tile, side by side (up to 4). After 3 seconds without XP a tile fades out and the others slide over.
- Stays clear of the game's own UI. It sits above the attack, block and build key hints, and only ever moves up to make room, so it does not hop when you equip something.
- Floating text. A blue
+0.8% Swordsfloats up over your character like a damage number. Only you see it. Quick gains are added together. Set it to Level Up Only or Off if you prefer. - Your layout:
- Style: Tiles (icon over bar, default) or Rows (a wide bar with the skill name, level and
+12%gained on it). - Tile size, an optional level number in the tile's corner, bar color.
- Placement: Bottom Right, Below Stamina, Right Side (clear of the minimap), or Custom, plus nudge offsets.
- Style: Tiles (icon over bar, default) or Rows (a wide bar with the skill name, level and
- Hides while the inventory, the big map or the menu is open.
Carry weight
Your weight, always on screen, without opening the inventory. It sits left of the food icons and is built like the health bar beside it: a weight icon next to the fork, a bar rising above it, and your weight over your max on top.
- Exact numbers. Matches the inventory screen, including your strength belt and the extra slots and backpacks from other mods.
- Grows with you. The bar is 110 pixels tall at the normal 300 max and grows with your capacity: a Megingjord (+150) makes it half again as tall. You can turn the growth off.
- Reads at a glance:
- Thresholds (default): your fill color, orange from 80% full, red when over.
- Gradient: blends through the three as you fill up.
- Single: one color.
- Over capacity it flashes, like the inventory does. All three colors can be changed.
- Text: weight over max (default), weight only, percent, or none, at any size.
- When to show it: Always, Near Limit (only when you are close to full), or When Changed (a few seconds after you pick up or drop something).
- Bar length, thickness and position are adjustable.
Food max health
Valheim quietly shrinks each food's health bonus as it wears off. A food at half its time gives only about 81% of its health, and the drop speeds up near the end.
- The health bar continues past its end in a faint red segment: the max health you have lost this way.
- That is exactly what eating fresh food would give back, so you can tell when a top-up is worth it.
- Color and opacity are adjustable.
Food reminders
A small toast at the top of the screen with the food's icon, its name and the time left. Each kind has its own switch:
| Reminder | Default | When |
|---|---|---|
| Running out | On | A food drops under 4 minutes (adjustable) |
| Can eat again | Off | A food passes half its time, the point where the game lets you eat it again |
| No food | On | Stays up while you have no food, until you eat or press Backspace |
- The no-food message waits until a new character has arrived, and shows again after you respawn. Set it to Any Slot Empty to be told whenever a food slot is free.
- A soft two-note chime plays with each reminder. It follows the game's sound volume, and can be turned down or off.
- Timed reminders show once per food and fade after 6 seconds. They do not repeat until you have eaten that food again.
- The countdown uses fixed-width digits, so it holds still.
- Moves down to clear the raid banner, and hides while the inventory, the big map or the menu is open.
Settings window
Press F7 in game.
- One section per feature, each with its own On/Off on the header. Click a section's name to open or close it; the window remembers which are open.
- Hover any setting to see what it does, its default and its range.
- Every option in one place: sliders for sizes and timings, click-to-cycle buttons for choices, and a color swatch with an editable hex value.
- Reset sits next to anything you changed, and Reset all on a section's header.
- Preview on HUD shows sample skill tiles for your top skills, the food reminders and a sample max-health segment (and plays the chime once), so you can place and size things live.
- Esc or F7 closes it. While it is open your character ignores input, and the mouse wheel scrolls the window instead of zooming the camera.
The same settings are in BepInEx/config/krool.kroolworldui.cfg (in r2modman: Config editor). Colors there are hex RRGGBBAA; the last two digits are opacity.
Full settings list
Generated from the mod's code on every build, so it always matches the F7 window.
General
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| Settings Key | F7 | Any key | Key that opens this settings window. |
Skill XP Bars
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| Enabled | On | Show a skill on the HUD while you gain XP in it. | |
| Style | Tiles | Tiles, Rows | Tiles: the skill icon with its XP bar underneath, side by side. Rows: a wide bar with the icon on the left, stacked. |
| Placement | Bottom Right | Bottom Right, Below Stamina, Right Side, Custom | Bottom Right: above the key hints, growing left. Below Stamina: centered under the stamina bar. Right Side: right edge of the screen, below the minimap. Custom: placed by Anchor X and Anchor Y. |
| Tile Size | 64 | 40 to 128 | Tiles: width in HUD pixels. The tile is a third taller than it is wide. |
| Tile Level | Off | Tiles: show the skill level in the tile's corner. | |
| Labels | Name And Level | Name And Level, Icon Only | Rows: Name And Level shows the skill name and level on the bar. Icon Only: just the icon and the bar. |
| Show Gain Text | On | Rows with Name And Level: show the XP gained since the bar appeared, as a percent of a level. | |
| Bar Width | 220 | 100 to 500 | Rows: width of one bar in HUD pixels. |
| Bar Height | 22 | 12 to 48 | Rows: height of one bar in HUD pixels. |
| Bar Color | DBA847FF |
Hex RRGGBBAA (AA = opacity) | Bar color. Progress you had is a darker shade, new XP a lighter one. |
| Hold Seconds | 3 | 0.5 to 30 | Seconds a bar stays fully visible after the last XP gain. |
| Fade Seconds | 0.6 | 0 to 5 | Seconds the fade-out takes. |
| Max Bars | 4 | 1 to 10 | Most skills shown at once (fewer if they would not fit on screen). The stalest one is reused past this. |
| Offset X | 0 | -400 to 400 | Nudge left (-) or right (+), in HUD pixels. |
| Offset Y | 0 | -400 to 400 | Nudge down (-) or up (+), in HUD pixels. |
| Anchor X | 0.5 | 0 to 1 | Custom placement: horizontal center (0 = left of screen, 1 = right). |
| Anchor Y | 0.3 | 0 to 1 | Custom placement: top edge (0 = bottom of screen, 1 = top). |
| Floating Text | Every Gain | Off, Every Gain, Level Up Only | Float each XP gain over your character like a damage number, seen only by you. Level Up Only: just new levels. |
| Floating Text Color | 73B8FFFF |
Hex RRGGBBAA (AA = opacity) | Color of the floating XP text. |
Weight
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| Enabled | On | Show your carry weight on the HUD, left of the food icons. | |
| Show | Always | Always, Near Limit, When Changed | Always. Near Limit: only at or above Near Limit Percent. When Changed: for a few seconds after your weight changes. |
| Near Limit Percent | 80 | 10 to 100 | Percent of max weight where the bar turns to the near-limit color (and where it appears, in Near Limit mode). |
| Changed Seconds | 3 | 1 to 15 | When Changed mode: seconds the bar stays after a change. |
| Colors | Thresholds | Thresholds, Gradient, Single | Thresholds: fill color, near-limit color past Near Limit Percent, over color when overweight. Gradient: blends from fill to near-limit to over as you fill up. Single: always the fill color. |
| Fill Color | CC9E4CFF |
Hex RRGGBBAA (AA = opacity) | Bar color under the limit. |
| Near Limit Color | FF8C1FFF |
Hex RRGGBBAA (AA = opacity) | Bar color near the limit. |
| Over Color | DB291FFF |
Hex RRGGBBAA (AA = opacity) | Bar color when overweight. |
| Text | Current And Max | Current And Max, Current, Percent, None | Numbers above the bar: current over max, current only, percent, or none. |
| Text Size | 16 | 10 to 28 | Font size of the numbers. |
| Bar Length | 110 | 40 to 220 | Bar length in HUD pixels at the normal 300 max weight. |
| Bar Thickness | 16 | 6 to 32 | Bar thickness in HUD pixels (the health bar is 32). |
| Scale With Max Weight | On | Grow the bar with your max weight: a Megingjord (+150) makes it 50% longer. | |
| Offset X | 0 | -200 to 200 | Nudge left (-) or right (+), in HUD pixels. |
| Offset Y | 0 | -200 to 300 | Nudge down (-) or up (+), in HUD pixels. |
Food Max Health
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| Enabled | On | Extend the health bar with a faint segment showing max health your foods have lost as they wear off. | |
| Color | BF2E2473 |
Hex RRGGBBAA (AA = opacity) | Color of the lost-health segment. Lower the last two digits to make it fainter. |
Food Reminder
| Setting | Default | Range or choices | What it does |
|---|---|---|---|
| Enabled | On | Food reminders on the HUD. The switches below pick which ones. | |
| Running Out | On | Remind when a food has less than Threshold Minutes left. | |
| Threshold Minutes | 4 | 1 to 15 | Running-out reminder: minutes left that trigger it. |
| Can Eat Again | Off | Remind when a food can be eaten again (the game allows it once half its time has passed). | |
| No Food Message | On | Keep a message up while you have no food, until you eat or press Dismiss Key. Shows on a new character after the arrival, and after respawning. | |
| No Food When | No Food | No Food, Any Slot Empty | No Food: only when all your food is gone. Any Slot Empty: whenever a food slot is free. |
| Dismiss Key | Backspace | Any key | Hides the no-food message until you next eat. |
| Show Seconds | 6 | 2 to 20 | How long a reminder stays on screen. |
| Sound | On | Play a soft chime with each reminder. | |
| Sound Volume | 0.35 | 0.05 to 1 | Chime volume (also follows the game's sound settings). |
| Anchor X | 0.5 | 0 to 1 | Horizontal position of the reminder's center (0 = left, 1 = right). |
| Anchor Y | 0.84 | 0 to 1 | Vertical position of the reminder's top edge (0 = bottom, 1 = top). It moves down on its own to clear the raid banner. |
Settings saved by an older version keep their values. Removed settings are ignored.
Install
- r2modman / Thunderstore Mod Manager: search for Krool World UI and install. BepInEx comes with it.
- Manual: install BepInExPack Valheim, then put
KroolWorldUI.dllinBepInEx/plugins.
Compatibility and tips
- Used in a modpack with EpicLoot, ExtraSlots, AdventureBackpacks, Quick Stack, MultiUserChest, PlantEverything and Warfare.
- Something overlaps? Other mods like the bottom-left corner too. Every element has nudge offsets in F7, and Preview on HUD shows where things land.
- Floating text too busy while running or sneaking? Set FloatingText to Level Up Only.
- Updated and the defaults look off? Settings you saved earlier are kept. Use Reset in F7 to take the new defaults.
Source, issues and changelog: github.com/Krool/KroolWorldUI. MIT licensed.