ValheimHolster
Keep your chosen weapons on your body: hips, back, crossed in an X, plus a quiver. Smooth holstering, tap R to swap, hold R (or gamepad) for a weapon wheel.ValheimHolster
by Morgnar
Keep your chosen weapons on your body — hips, back, crossed in an X, plus a quiver — with smooth holstering and an animated weapon wheel.
Suas armas no corpo — cintura, costas, cruzadas em X e aljava — com animação suave e uma roda de armas animada.
☕ Support the project · Apoie o projeto
Enjoying the mod? Buy me an energy drink (or a new keyboard, if you're feeling generous) so I can keep this beautiful project going! ⚡⌨️
Gostou do mod? Me paga um energético (ou um teclado novo, se estiver se sentindo generoso) pra eu continuar esse projeto lindo!
Choose your language · Escolha o idioma 👇
🇺🇸 English
Your weapons stay on your character's body — and you choose which ones. Sword on the hip, greatsword and staff crossed on the back, bow hanging, shield behind... plus an animated wheel to swap weapons fast.
⚔️ How to use
| Action | What it does |
|---|---|
| H in the inventory (hovering a weapon) | Marks/unmarks the weapon. An orange dot shows on the slot. Marked weapons stay on your body and show up in the wheel. |
| R (tap) | Go back to the weapon you were using before. |
| R (double tap) | Empty your hands. |
| R (hold) | Open the weapon wheel. Move the mouse sideways (or scroll) to spin it, release R to equip. Right click cancels. With ValheimDualWield: left/right click picks the hand and middle click cancels. |
| Gamepad (hold the hide button) | Opens the wheel. Right stick (or D-pad) spins, release to equip, B cancels. |
| F7 | Adjust mode: left drag moves, right drag rotates, scroll moves forward/back. Arrows give small exact steps (Alt + arrows rotate), Shift = precise, Ctrl = fast. PgUp/PgDn pick the hip sword, knife, axe, mace/sledge on the back, quiver or shield; Backspace resets; F7 saves and exits. |
| F8 | Body map: saves your body measurements and where each weapon sits to BepInEx/config/ValheimHolster/BodyMap.txt — send it along with bug reports about weapon positions. |
✨ Features
- Many weapons on the body at once: hips (both sides), back, bow, atgeir and shield spots — using the game's own attach points, so everything sits where it should.
- Crossed in an X: two big weapons (staffs, greatswords, atgeirs, bows) on the same spot are crossed on your back.
- One-handed weapons on the hip: swords, axes, maces and knives hang straight on the hip, all in the same pose (adjustable). Axes and maces hang head up, like through a belt loop. Swords and knives go on the left side, axes on the right; maces and sledges hang diagonally on the back like atgeirs.
- Quiver on the back: with a marked (or equipped) bow or crossbow, a quiver shows up with the arrows/bolts you carry — empty if you have none.
- Hides when it makes sense: sitting, lying in bed, swimming or indoors (each one is an option).
- Fixed spots: each weapon keeps its place on the body — drawing or swapping weapons doesn't shuffle the others.
- Your choice: only marked weapons stay on the body — the rest just leave your hands.
- Straight shields on the back: shields are lined up by their model, so shields from other mods don't hang crooked.
- Smart shield: comes along with your one-handed weapon (optional: not with axes, so you can chop trees without the movement penalty) and leaves when you put the weapon away.
- Tools never on the body: hammer, hoe, cultivator, pickaxe, fishing rod and torch stay out (configurable).
- Smooth motion: weapons slide between your hand and your body instead of popping in and out.
- Animated weapon wheel: carousel with smooth spin, highlighted pick and the weapon name + type in the middle. Works with mouse and gamepad.
- Main menu: menu characters show their marked weapons on the body with free hands.
- Better crossbows: put it away loaded, take it out loaded; reload while running; configurable reload speed.
- Marks are saved on the item itself — they work on any world or server.
- Translatable: texts follow the game language. English and Portuguese come built in, and anyone can add their language (see below).
🌐 Multiplayer
- Client-side — the server doesn't need the mod.
- Players with the mod see all weapons on your body. Players without it see the two the game already shows.
- Minimal traffic: only sends data when your weapons change.
🤝 Compatibility
- ValheimMenu: characters sitting by the campfire show their weapons on the body.
- Valheim Races: weapons follow each race's size (Dvergar, Orcs, Æsir...).
- AzuExtendedPlayerInventory: weapons on the body use the weapon transmog (vanity) look.
- May not play well with other mods that also change where weapons are holstered — use only one.
📦 Install
Mod manager (recommended): install with r2modman, Thunderstore Mod Manager or Gale.
Manual: drop ValheimHolster.dll into BepInEx/plugins/.
Requires BepInExPack Valheim.
⚙️ Config
File: BepInEx/config/ValheimHolster/ValheimHolster.cfg — or use the Configuration Manager (F1). Visual changes apply instantly. Every option has an English and a Portuguese description. Upgrading from an older version keeps your settings: the old (Portuguese) option names are moved to the new ones automatically.
🌍 Translations
All in-game texts live in BepInEx/config/ValheimHolster/Translations/. To translate: copy English.txt, rename it to your language using the same name the game uses (Spanish.txt, German.txt, French.txt, Russian.txt...) and translate the text after each =. Keep {0} {1} {2} and \n. Missing lines fall back to English. The mod picks the file matching the game language automatically (or set 1 - General → Language to the file name). Send me your file and I'll ship it with the mod!
💬 Bugs & suggestions
Reach me on Discord.
🇧🇷 Português
Suas armas ficam penduradas no corpo do personagem — e você escolhe quais. Espada na cintura, espadão e cajado cruzados nas costas, arco pendurado, escudo atrás... e uma roda animada pra trocar de arma rapidinho.
⚔️ Como usar
| Ação | O que faz |
|---|---|
| H no inventário (mouse em cima da arma) | Marca/desmarca a arma. Uma bolinha laranja aparece no slot. Armas marcadas ficam no corpo e entram na roda. |
| R (um toque) | Volta pra arma que você estava usando antes. |
| R (dois toques) | Esvazia as mãos. |
| R (segurar) | Abre a roda de armas. Mova o mouse pros lados (ou use o scroll) pra girar, solte o R pra equipar. Botão direito cancela. Com o ValheimDualWield: botão esquerdo/direito escolhe a mão e o do meio cancela. |
| Controle (segurar o botão de guardar) | Abre a roda. Analógico direito (ou D-pad) gira, soltar equipa, B cancela. |
| F7 | Modo de ajuste: arrastar com o botão esquerdo move, com o direito gira, scroll leva pra frente/trás. Setas dão passinhos exatos (Alt + setas gira), Shift = preciso, Ctrl = rápido. PgUp/PgDn escolhem espada, faca, machado, maça/marreta nas costas, aljava ou escudo; Backspace volta ao padrão; F7 salva e sai. |
| F8 | Mapa do corpo: grava as medidas do corpo e onde cada arma está em BepInEx/config/ValheimHolster/BodyMap.txt — mande junto quando reportar problema de posição. |
✨ Recursos
- Várias armas no corpo ao mesmo tempo: quadril (os dois lados), costas, arco, atgeir e escudo — usando os pontos de encaixe do próprio jogo, então tudo fica no lugar certo.
- Cruzadas em X: duas armas grandes (cajados, espadões, atgeirs, arcos) no mesmo lugar ficam cruzadas nas costas.
- Arma de uma mão na cintura: espadas, machados, maças e facas ficam retas no quadril, todas na mesma pose (ajustável). Machados e maças ficam de cabeça pra cima, como num passador do cinto. Espadas e facas vão do lado esquerdo, machados do direito; maças e marretas ficam na diagonal nas costas, igual atgeir.
- Aljava nas costas: com um arco ou besta marcado (ou na mão), aparece uma aljava com as flechas/virotes que você carrega — vazia se não tiver nenhuma.
- Esconde quando faz sentido: sentado, deitado na cama, nadando ou dentro de casa (cada um é uma opção).
- Lugar fixo: cada arma tem o seu lugar no corpo — sacar ou trocar de arma não embaralha as outras.
- Você escolhe: só as armas marcadas ficam no corpo — as outras simplesmente saem da mão.
- Escudo reto nas costas: os escudos são alinhados pelo modelo, então escudos de outros mods não ficam tortos.
- Escudo inteligente: vem junto com a arma de uma mão (opcional: não com machado, pra cortar árvore sem penalidade) e sai junto quando você guarda a arma.
- Ferramentas nunca no corpo: martelo, enxada, cultivador, picareta, vara de pesca e tocha ficam de fora (configurável).
- Animação suave: a arma desliza da mão pro corpo e de volta, em vez de sumir e aparecer do nada.
- Roda de armas animada: carrossel com giro suave, destaque na arma escolhida e o nome + tipo da arma no centro. Funciona no mouse e no controle.
- Menu principal: os personagens do menu aparecem com as armas marcadas no corpo e as mãos livres.
- Besta melhorada: guardou carregada, volta carregada; dá pra recarregar correndo; velocidade de recarga configurável.
- A marcação fica salva no próprio item — vale em qualquer mundo ou servidor.
- Traduzível: os textos seguem o idioma do jogo. Inglês e português já vêm prontos, e qualquer um pode adicionar o seu idioma (veja abaixo).
🌐 Multiplayer
- Só cliente — o servidor não precisa ter o mod.
- Quem tem o mod vê todas as armas no seu corpo. Quem não tem vê as duas que o jogo já mostra normalmente.
- Tráfego mínimo: só envia algo quando suas armas mudam.
🤝 Compatibilidade
- ValheimMenu: os personagens sentados na fogueira aparecem com as armas no corpo.
- Valheim Races: as armas acompanham o tamanho de cada raça (Dvergar, Orcs, Æsir...).
- AzuExtendedPlayerInventory: as armas no corpo usam a aparência do transmog de armas (vanity).
- Pode não combinar com outros mods que também mudam onde as armas ficam guardadas no corpo — use só um.
📦 Instalação
Com mod manager (recomendado): instale pelo r2modman, Thunderstore Mod Manager ou Gale.
Manual: coloque ValheimHolster.dll em BepInEx/plugins/.
Requer BepInExPack Valheim.
⚙️ Configuração
Arquivo: BepInEx/config/ValheimHolster/ValheimHolster.cfg — ou pelo Configuration Manager (F1). Mudanças visuais aplicam na hora.
| Seção | Destaques |
|---|---|
| General | Ligar/desligar, idioma, log detalhado, tecla do modo de ajuste |
| Body | Tecla de marcar, só armas marcadas, máximo de armas, maças/marretas nas costas (com ajuste), cruzar em X, ferramentas, animação suave, esconder sentado/dormindo/nadando/em casa |
| Hide key (R) | Toque, dois toques, tempo, roda, roda no controle |
| Hip | Cintura, os dois lados, lado por tipo de arma, inclinação, giro, altura, frente, distância do corpo, machado/maça de cabeça pra cima (com posição própria), pose da faca |
| Shield | Escudo automático, exceto machado, escudo acompanha a arma, alinhar nas costas, posição/rotação nas costas |
| Hotbar | Número da hotbar só equipa |
| Menu | Armas no menu, mãos livres |
| Reload | Continua carregada, recarregar correndo, velocidade de recarga, só recarrega com munição |
| Quiver | Aljava, quantidade de flechas, posição, rotação, tamanho |
Os nomes das opções estão em inglês; toda opção tem a descrição em inglês e em português. Quem vem de uma versão antiga não perde nada: as opções antigas (em português) são passadas pros nomes novos sozinhas.
🌍 Traduções
Todos os textos do jogo ficam em BepInEx/config/ValheimHolster/Translations/. Pra traduzir: copie o English.txt, renomeie pro seu idioma com o mesmo nome que o jogo usa (Spanish.txt, German.txt, French.txt...) e traduza o texto depois de cada =. Mantenha os {0} {1} {2} e o \n. O que faltar fica em inglês. O mod escolhe sozinho o arquivo do idioma do jogo (ou coloque o nome do arquivo em 1 - General → Language). Me manda o arquivo que eu coloco junto no mod!
💬 Bugs e sugestões
Fala comigo no Discord.