Diamond HUD

A diamond-shaped HUD for playing Valheim with a controller. Four slots around a diamond, everything on the d-pad, plus the shortcuts a gamepad really needs: one button for your light, one for your shield, and spears that reload themselves.

Works on your game only. Your friends don't need it, the server doesn't need it, and it doesn't have to match anyone else's version.

Install

1. Install BepInExPack Valheim (the mod manager grabs it for you).
2. Install this, launch, play. Layout = Auto checks which gamepad layout you use in the game's own Controls settings and puts the shortcuts on buttons that layout leaves free. Switch layout while playing and it keeps up, no restart.

Everything else is optional. The config file is BepInEx/config/viktor.diamondhud.cfg, and changes take effect straight away, so you can tweak the HUD with a config manager while you're standing in game.

The four slots

The diamond is four slots plus an ammo window, and each one pulls from a different place:

Slot	What's in it	Comes from
up	weapons - melee and magic	your hotbar
left	shields, bows, crossbows	your hotbar
right	food, meads, bombs	your hotbar
down	tools - axe, pickaxe, hammer, hoe, rod	your whole bag
ammo window	arrows, bolts, bait	your whole bag

The idea is that your hotbar is your fighting kit. What you put on it is what you can reach in a fight, and that's a decision you make before the fight, not during it. So weapons, shields and food only come from the bar.

Tools and ammo are the opposite. A pickaxe is dead weight on the bar and you still want it to hand, and nobody wants to spend a hotbar slot on arrows. Those read your whole bag.

Same for the things on their own shortcuts, which don't take up a slot at all: torches and lanterns, your belt items, and the Dverger circlet all come from the bag. So does the spear that slides in when you throw one - it comes out of your bag and into the hotbar slot the old one left.

Controls

Input	What it does
d-pad up	cycle weapons - melee and magic
d-pad down	cycle tools
d-pad left	cycle your off hand: shields, bows, crossbows
d-pad right	cycle food, meads and bombs
hold d-pad left	light on, light off
hold d-pad down	sit down, stand up
hold d-pad right	skip to the first thing you can actually eat or drink
heavy attack	scroll through your ammo, or your bait with a rod out
X (Classic) / B (Alt1, Alt2)	eat or drink whatever the food slot is showing
guard + X	shield on, shield off, or jump back to your last sword and shield
guard + Y	put your weapons away, take them back out
both left shoulder buttons	cycle your belt: Megingjord, Wishbone, anything in the utility slot
tap the holster button (Alt1, Alt2)	crouch
L3 + R3 (Classic)	forsaken power

Each direction on the d-pad does two things. A tap cycles that slot, a hold does the one shortcut that belongs to it. Up is the odd one out: no hold, so you can keep it pressed to scroll through your weapons like normal.

What it does

One button for your light. Hold d-pad left and you light up. If you're carrying a Dverger circlet it goes on your head and you keep both hands free. If not, you get a torch or a lantern, and here's the good part: you keep the weapon you were holding. Had a sword and shield? The shield steps aside and comes straight back when you put the torch away. Had a two-hander or a bow? It draws your last one-hander first so the torch has a hand to go in. Hold again and you're back exactly where you started. While the light is on, d-pad left switches between the lights you're carrying.

Shields that remember. Equip a sword next to a shield once and the mod notices. After that, drawing that sword brings its shield along. Guard + X is the quick swap: if your shield is up it comes off, and if you're holding a two-hander or a bow it puts your sword and shield back in one press. Got no shields on the bar? Then it just draws your first weapon, so the button always does something. Taking a shield off with guard + X is also how you tell it to forget that pair.

The pairs are saved in a plain text file for each character, one weapon = shield per line, so you can open it and edit it.

Spears that reload. The weapon slot shows how many of that spear you're carrying in total, not just the one in your hand. Throw it and the next one comes out of your bag, into the slot the old one left, and straight into your hand. You keep throwing instead of stopping to dig around. Different upgrade levels stack together in the count, and the slot shows the level of the one you're actually holding. The Abyssal harpoon is left out, since you don't throw it away.

Bombs sit with the food. A bomb is something you use up, not something you switch to, so it shares that slot. D-pad right scrolls past them along with your meads, and the use button puts one in your hand ready to throw. Bombs never get paired with a shield. If you've got a pile of them in the way, hold d-pad right and you'll skip straight to the first thing you can actually drink.

Your hatchet knows what it's for. Keep a one-handed axe on the hotbar and it's a weapon, so it shows up with your weapons. Leave it in your bag and it's a tool, so it shows up with your tools. Move it and it swaps sides. Nothing to configure.

Fishing. Pull out the rod and your first bait loads on its own. Your baits show up in the ammo window, the same place arrows show up for a bow, so you flick through them with the heavy attack button. Bait takes a moment to equip, unlike arrows, so it goes on the hook once you stop scrolling rather than on every press. Put the rod away and your arrows come back exactly where they were.

Ammo counter. A small window shows up above your off-hand slot whenever you're holding something that uses ammo, with how much you've got left. Arrows, bolts, and bait when you're fishing. Scroll it with the heavy attack button, which no bow, crossbow or rod uses anyway.

Your belt. Press both left shoulder buttons to cycle your utility items. Whatever you're wearing shows in the middle of the diamond, and its icon gets taken out of the status bar, since the diamond is already telling you.

No animation pile-ups. Tapping a direction just moves the highlight - the actual swap happens 300ms after you stop. Scroll past five weapons and you pay for one animation, not five. Holding guard locks your weapon and tool swaps but leaves food and ammo alone, so you can't fumble your kit mid-block.

Immersive mode (on by default). The diamond fades out after three seconds of nothing happening and comes back the moment something does. It won't disappear during a fight. The one exception is a lit torch: that slot stays up, because the durability bar on it is how much light you've got left. F1 turns the whole thing on and off.

Biome colours. The slot frames pick up a colour from wherever you are - green in the meadows, gold in the plains, deep red in the ashlands. Change them per biome or turn it off.

Settings worth knowing

• Layout - Auto by default. Lock it to Classic, Alt1 or Alt2 if you'd rather, or use Custom and put every shortcut where you want it.
• AnchorX / AnchorY / PixelOffsetX / PixelOffsetY - where the diamond sits.
• DPadHoldSeconds - how long a hold takes. Set it to 0 to turn all three holds off and get normal scrolling back on every direction.
• EquipDelay - the pause before what you picked actually gets equipped.
• ImmersiveMode, ImmersiveIdleSeconds, RequireGamepad, BiomeTint.
• ShowTorchWindow - a separate torch window that never fades. Off by default, since the off-hand slot already shows that bar.
• ExtraToolNames, TorchNames, RodNames, CircletNames, ExtraBombNames, SpearExcludeNames - add modded items here if the mod doesn't sort them correctly on its own.

Compatibility

Tested on Valheim 1.0.15 with BepInExPack Valheim 5.4.2351.

The mod borrows three bits of the normal HUD instead of drawing its own, so another UI mod that moves the same things will argue with it. Each one has a switch:

• the normal hotbar is hidden while the diamond is up - HideVanillaHotbar
• the status effect icons move next to the forsaken power, smaller, filling left to right - MoveStatusList
• the forsaken power can sit in the middle of the diamond - GuardianPowerInCentre, off by default

It also takes a few controller buttons off the game so the shortcuts can use them: sit, crouch, the automatic weapon-holstering, and the face buttons while you're holding guard. SuppressVanillaSit, SuppressVanillaCrouch, SuppressVanillaAutoHolster and GuardOwnsMacroButtons give them back one at a time.

Building a Custom layout? Set DebugButtons = true and the log will print every button as you press it, so you can see what your controller has spare.