ValheimHolster

🇧🇷 Português · 🇺🇸 English

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.

✨ 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 no quadril, inclinadas pra trás (ajustável). Machados e maças ficam de cabeça pra cima, como num passador do cinto.
• 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).
• Você escolhe: só as armas marcadas ficam no corpo — as outras simplesmente saem da mão.
• 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.
• Textos em português ou inglês, seguindo o idioma do jogo.

🌐 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...).
• 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
Body	Tecla de marcar, só armas marcadas, máximo de armas, 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, inclinação, giro, altura, frente, distância do corpo, machado/maça de cabeça pra cima, pose da faca
Shield	Escudo automático, exceto machado, escudo acompanha a arma
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.

☕ Apoie o projeto

Gostou do mod? Me paga um energético (ou um teclado novo, se estiver se sentindo generoso) pra eu continuar esse projeto lindo! ⚡⌨️

💬 Bugs e sugestões

Fala comigo no Discord.

---

🇺🇸 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.

✨ 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 sit on the hip, tilted back (configurable). Axes and maces hang head up, like through a belt loop.
• 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).
• Your choice: only marked weapons stay on the body — the rest just leave your hands.
• 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.
• Texts in English or Portuguese, following the game language.

🌐 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...).
• 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.

☕ Support the project

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! ⚡⌨️

💬 Bugs & suggestions

Reach me on Discord.