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)

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)

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.