ShoulderPets

A small pet on your shoulder: a shrunken, animated copy of a creature the game already has (a Fuling, a wolf, a boar...) sits on your shoulder and goes wherever you go. It is purely visual: no stats, no AI, no drops, no new items.

(Versión en español más abajo.)

What it does

• Press Alt + X to open the pet HUD, drawn in Valheim's own style. On the left you pick the creature from a list (with a search box); on the right you choose the shoulder and adjust the size, height, sideways, forward and turn with sliders. Everything applies at once, so the pet on your own shoulder is the preview. Your choices are saved.
• Animated: the pet plays the creature's own idle animations, and reacts to what you do: it jumps when you jump, swings when you attack, staggers when you stagger and treads water when you swim. It does not walk or run on the spot.
• Seen by friends: players who also have the mod see your pet on you, and you see theirs. Players without the mod see nothing and nothing breaks. Turn it off with Share and ShowOthers.
• Spanish and English: ES / EN buttons in the HUD. By default it follows the game's language.
• Client-side. The server does not need the mod.
• The models are the game's own. The mod carries no game assets: at runtime it makes a visual-only copy of the creature already loaded in the game and strips everything that made it a creature (AI, health, physics, network object), so nothing extra appears in the world.

Configuration

BepInEx/config/com.despr0grammer.shoulderpets.cfg (the HUD edits it for you)

Option	Default	What it does
Keys / MenuKey	X + LeftAlt	Key that opens the HUD (the left Alt only)
Hud / Language	Auto	Auto (the game's language), Spanish or English
Hud / HudScale	1	Size of the HUD
General / Enabled	true	Master switch
General / Pet	Fuling	Creature by prefab name (Fuling = Goblin, Wolf, ...); empty or None for no pet
General / Share	true	Let other players with the mod see your pet
General / ShowOthers	true	Show the pets of other players who share theirs
Placement / Side	Right	Right or Left shoulder
Placement / Scale	0.2	Size compared with the creature in the game
Placement / OffsetRight, OffsetUp, OffsetForward, Yaw	0.17, 0.12, 0, 0	Where the pet stands on the shoulder, and which way it faces
Animation / Animate	true	Play the animations (off: one pose)
Animation / Reactions	true	Jump, swing, stagger and swim along with you
Animation / Speed	1	Animation speed
Debug / LogPrefabNames	false	Write every prefab name to the log

Compatibility and known limitations

• Made for Valheim 1.0.x with BepInEx 5 (BepInExPack_Valheim).
• One pet per player. No weapons or gear on the creature.
• Not every creature looks good at a small size, and some have odd proportions on a shoulder: use the sliders. If a creature cannot be shown, the log says so (ShoulderPets lines in LogOutput.log) and nothing breaks.
• Creature names in the list come from the game, so they appear in the game's language, not the HUD's.
• Seeing other players' pets and the Spanish/English switch are the least tested parts: please report anything odd with the ShoulderPets lines of LogOutput.log.
• Alt + X can be changed in the config; F5, for example, is also the key of Valheim's console if you enable it.

Credits

Written by despr0grammer with the help of Claude, an AI assistant, which is why it is listed under AI Generated.

---

ShoulderPets (español)

Una mascota pequeña en el hombro: una copia reducida y animada de una criatura que el juego ya tiene (un Fuling, un lobo, un jabalí...) se sienta sobre tu hombro y va contigo. Es solo visual: sin estadísticas, sin IA, sin botín, sin objetos nuevos.

Qué hace

• Pulsa Alt + X para abrir el HUD de mascotas, con el estilo de Valheim. A la izquierda eliges la criatura de una lista (con buscador); a la derecha eliges el hombro y ajustas tamaño, altura, lateral, adelante y giro con deslizadores. Todo se aplica al instante, así que la mascota de tu hombro es la vista previa. Tus elecciones se guardan.
• Animada: la mascota usa los idles de la propia criatura y reacciona a lo que haces: salta cuando saltas, ataca cuando atacas, se tambalea cuando te tambaleas y chapotea cuando nadas. No camina ni corre en el sitio.
• La ven tus amigos: los jugadores que también tengan el mod ven tu mascota sobre ti y tú ves la suya. Quien no tenga el mod no ve nada y no se rompe nada. Se apaga con Share y ShowOthers.
• Español e inglés: botones ES / EN en el HUD. Por defecto sigue el idioma del juego.
• Solo cliente. El servidor no necesita el mod.
• Los modelos son los del juego. El mod no lleva ningún archivo del juego: en tiempo de ejecución hace una copia solo visual de la criatura que el juego ya tiene cargada y le quita todo lo que la hacía criatura (IA, salud, físicas, objeto de red), así que no aparece nada extra en el mundo.

Configuración

BepInEx/config/com.despr0grammer.shoulderpets.cfg (el HUD lo edita por ti)

Opción	Por defecto	Qué hace
Keys / MenuKey	X + LeftAlt	Tecla que abre el HUD (solo el Alt izquierdo)
Hud / Language	Auto	Auto (el idioma del juego), Spanish o English
Hud / HudScale	1	Tamaño del HUD
General / Enabled	true	Interruptor general
General / Pet	Fuling	Criatura por su nombre de prefab (Fuling = Goblin, Wolf, ...); vacío o None para ninguna
General / Share	true	Deja que otros jugadores con el mod vean tu mascota
General / ShowOthers	true	Muestra las mascotas de otros jugadores que las comparten
Placement / Side	Right	Hombro Right (derecho) o Left (izquierdo)
Placement / Scale	0.2	Tamaño respecto a la criatura del juego
Placement / OffsetRight, OffsetUp, OffsetForward, Yaw	0.17, 0.12, 0, 0	Dónde se pone la mascota en el hombro y hacia dónde mira
Animation / Animate	true	Reproduce las animaciones (apagado: una sola pose)
Animation / Reactions	true	Salta, ataca, se tambalea y nada contigo
Animation / Speed	1	Velocidad de las animaciones
Debug / LogPrefabNames	false	Escribe en el log el nombre de todos los prefabs

Compatibilidad y límites conocidos

• Hecho para Valheim 1.0.x con BepInEx 5 (BepInExPack_Valheim).
• Una mascota por jugador. Sin armas ni equipo en la criatura.
• No todas las criaturas quedan bien en pequeño y algunas tienen proporciones raras sobre un hombro: usa los deslizadores. Si una criatura no se puede mostrar, el log lo dice (líneas ShoulderPets de LogOutput.log) y no se rompe nada.
• Los nombres de la lista vienen del juego, así que salen en el idioma del juego, no en el del HUD.
• Ver las mascotas de otros jugadores y el cambio español/inglés son lo menos probado: cuéntame lo raro que veas con las líneas ShoulderPets de LogOutput.log.
• Alt + X se puede cambiar en la configuración; F5, por ejemplo, es también la tecla de la consola de Valheim si la activas.

Créditos

Escrito por despr0grammer con ayuda de Claude, un asistente de IA, por eso aparece en AI Generated.