Hip Charms

Equipment slots, craftable quivers, belt charms, a weightless valuables pouch, and a miniature blue wisp lantern for Valheim.

0.3.0 is a test build against Valheim 1.0.15. BepInEx is the only dependency.

Equipment and storage

• Dedicated head, chest, legs, cape, trinket and strength-belt slots, plus three food slots.
• Craft and install up to three leather quivers. Each holds one arrow type; visible arrows use that item's actual native meshes and materials.
• Quivers appear on your back and both hips. Choose BackOnly in configuration to show all three arrow types in one back quiver without changing storage.
• Fit the hip charms upgrade to a worn strength belt for one additional ordinary inventory row and hooks for the swamp key, wishbone and wisplight. The belt retains its native carry-weight bonus.
• The key and wishbone hang from the belt and retain their effects. A miniature native lantern with blue light contains the wisplight and preserves mist clearing.
• Craft and fit a valuables pouch to a worn strength belt for 12 storage cells. It accepts coins and items with the game's trader-sale value. Traders can sell these valuables and spend pouch coins directly.
• Worn equipment and dedicated slot contents are weightless by default. Ordinary backpack items, including the extra belt row, keep their normal weight.

Crafting and discovery

All recipes use a level 1 workbench by default. Materials and required workbench level are configurable.

The belt upgrade recipe is revealed only after your character first obtains a strength belt. Discovery is saved per character and survives selling or removing the belt. Existing characters who already discovered the belt also qualify. The belt is not consumed when crafting the upgrade. Quiver and pouch recipes follow native material/station discovery.

Equipment window

The panel reuses Valheim's native backgrounds, buttons, slot graphics, fonts and text colors. Equipment is grouped by body position. Each quiver pairs its equipment socket with its arrow slot; the pouch opens a separate valuables section with its pouch icon and valuables emblem.

Hold Alt and drag the header or empty window background to reposition the equipment panel. Its position is saved after release and constrained to the screen. Normal item dragging and stack splitting remain available.

Drag items into matching cells. Right-click equipment or storage contents to return them to the backpack; right-click arrows to select them and food to eat it. Default shortcuts are Left Alt + 1/2/3 for arrows and Left Ctrl + 1/2/3 for food. The added panel uses mouse and keyboard; ordinary inventory retains native gamepad navigation.

Configuration

Use a BepInEx-compatible configuration manager or edit BepInEx/config/local.hipcharms.cfg with the game closed.

• Equipment window: saved position, scale, position lock and reset position.
• Quivers: ThreeQuivers or BackOnly, hip positions and rotations, and hip quiver scale. Back placement remains under Placement.
• Crafting: material costs for each item and workbench level. Belt discovery is always required for the upgrade recipe.
• Storage: weight exemption and belt-row settings.
• Lantern / Appearance / Placement: color, glow, light range, charm sizes and attachment positions.

Installation and upgrading

1. With Valheim closed, import HipCharms-0.3.0.zip as a local Thunderstore mod, or copy plugins/HipCharms/HipCharms.dll into your profile's BepInEx/plugins/HipCharms folder.
2. Keep BepInEx enabled. Use one inventory-layout mod at a time. Empty another mod's equipment/storage into chests before switching.
3. Craft the equipment, install it in the new sockets, and add arrows, charms and valuables to their matching cells.

When upgrading from 0.2.0, existing slot identities and stored items are preserved. Craft the new equipment to activate the corresponding storage. Existing contents in unavailable slots remain recoverable; they are not deleted. The previous free belt row now requires the crafted belt upgrade. Recovery space remains until its items can safely move into ordinary inventory.

Removing a quiver, pouch, upgrade or belt checks backpack space first. Dependent contents move only when the entire transaction fits. If inventory is full, make room before removing the equipment.

Before uninstalling, empty every dedicated cell and the extra belt row, remove custom items from characters/world storage as appropriate, remove the belt, and save. An unloaded mod cannot restore custom items or inventory cells.

Multiplayer and validation

Install the same version on all clients and the dedicated server because the quivers, upgrade and pouch are custom networked items. Use matching crafting and gameplay settings; this build does not enforce server configuration. Visual placement can differ per client.

See TESTING.md for automated coverage and remaining playtest steps. Compilation and static verification do not replace in-game checks of rendering, animation, crafting, save/reload and multiplayer. No installed profile or save was modified while preparing this package.

0.4.0

• Enlarges key/wishbone charms and adds weighted sway to charms, lantern and valuables pouch, plus gentler quiver motion.
• Flattens quivers, brings them closer to the body and displays up to nine stored arrow models.
• Adds a separate coin cell beyond the existing 12 valuables cells, removing the normal coin stack cap without changing shared native item definitions.
• Preserves coin overflow, normal-sized withdrawals and stored coins during provider removal, saving and recovery.
• Requires discovered ingredients for custom recipes; recipe-associated empty slots stay hidden until unlocked.
• Makes the equipment panel 56% smaller by area, removes transparent item previews and adds a configurable food/arrow shortcut HUD outside inventory.

0.3.1

• Fixes the equipment window exception and repeated placeholder icons by rendering individual native cells instead of a cloned rectangular inventory grid.
• Resets copied icon presentation so empty-slot hints and pouch decorations display correctly.
• Generates visible quiver, belt-upgrade, pouch and lantern thumbnails without relying on world fog or game-material camera rendering. Blank thumbnails retain a native fallback.
• Restores native Ctrl-click chest transfers, prevents those transfers from filling dedicated slots, and retains provider-removal capacity checks.
• Recovers invalid items from dedicated cells when ordinary space is available, without deleting contents when it is full.
• Adds transfer and thumbnail regressions plus native UI contract checks. Existing crafted items and saved slot identities are preserved.

0.3.0

• Reuses native inventory fonts, colors, buttons and backgrounds in a roomier equipment layout.
• Adds Alt-drag window positioning with saved position, scale, lock and reset settings.
• Adds three craftable quivers, a strength-belt charm upgrade and a functional valuables pouch.
• Reveals the belt upgrade recipe only after first obtaining a strength belt, including prior native discovery.
• Shows actual stored arrow meshes on the back and both hips, with an optional combined back-only quiver.
• Adds configurable crafting costs and quiver placement.
• Preserves existing slot contents during upgrades and protects storage when its equipment is removed.

0.2.0

• Replaces equipment-mod integrations with standalone equipment and storage.
• Adds a functional 12-cell valuables pouch for coins and trader valuables.
• Makes equipped gear and dedicated slot contents weightless.
• Adds an original visible quiver with three arrow cells and three food cells.
• Keeps the belt's extra inventory row and visible key, wishbone and blue wisp lantern.

0.1.0

• Initial test build for the belt storage, three working charm slots, blue miniature lantern, visible key/wishbone and coin pouch.
• Integrates with EquipmentAndQuickSlots 3.1.3 and BetterArchery 2.0.2.
• Protects belt inventory during shrinking and leaves purchased rows unchanged.
• Uses measured vanilla mesh sizes and compensates for the player skeleton's inherited scale.
• Converts a runtime copy of the vanilla lantern's orange emission mask to support blue glow.