LeashMe Valheim Mod

Lead up to 5 tamed animals on one leash.

LeashMe adds a craftable leash. Equip it in your off-hand, walk up to a tamed animal and press Use: the animal follows you, connected by a visible leash, even through water and portals. Lead up to 5 animals at once. It uses the normal Valheim follow behaviour and pathfinding. The mod works on all tameable animals, except creatures summoned by the spirit caller staff (they follow you anyway).

Leashed animals do not fight! A leashed animal ignores enemies completely, even when it is attacked, and it can die - enemies still attack it. Before a fight, unleash your animals (press Use on them or put the leash away) so they can defend themselves.

Quick start

1. Craft the leash at a workbench (level 3) from 10 leather scraps.
2. Equip it in your off-hand.
3. Look at a tamed animal and press Use (Leash). Repeat for up to 5 animals.
4. Walk. The animals follow.
5. Press Use on an animal again (Unleash) to let it stay.

New in 1.2.0: the pack saddle turns your lox into a pack animal with its own inventory (see Pack saddle).

Version: 1.2.0

Languages: English and German.

Mod pages: Nexus, Hexium

Installation instructions

Vortex / mod manager: install LeashMe and its requirements.

Manual:

1. Install BepInExPack for Valheim
2. Install Jotunn
3. Copy LeashMe.dll into <Valheim>/BepInEx/plugins.
4. Start the game.

For a dedicated server, install the same way into the server's BepInEx/plugins folder.

Multiplayer: every player and the server need LeashMe (same minor version). Players without it, or with a different version, are rejected on connect with an error message (Jotunn).

Uninstalling: remove LeashMe.dll. Leashes in inventories disappear. Paw markers you placed yourself become standard markers (see Map markers).

Main features

The leash

Crafted at the workbench and upgraded there like any vanilla item. Stronger animals need a stronger leash:

• Level 1 (craft, workbench level 3): 10 leather scraps. Boar, hen.
• Level 2 (upgrade, workbench level 4): 5 leather scraps, 5 fenris hair. Also wolf.
• Level 3 (upgrade, workbench level 5): 5 leather scraps, 5 linen thread. Also lox, asksvin, moose, and all other tamed animals.

If your leash is too weak, the animal shows This animal needs a stronger leash when you look at it with your leash equipped. Unknown tameable animals (for example from other mods) need level 3.

• No durability.
• Equipped in the shield / off-hand slot, shown as a rope wrapped around your left hand. It does not block or parry. You can use one-handed items in your main hand while using the leash. Equipping two-handed items or putting your weapons away will unleash all animals.
• Can be hung on item stands (coiled on a horizontal stand, hanging on a wall stand), but not on armor stands.

Leading animals

• A visible rope runs from your hand to each animal's head, with slight sag when close.
• From 12 m you cannot walk further away from a leashed animal (no pulling the animals, but walking towards it or sideways still works).
• Beyond 18 m (lox: 30 m) (e.g. the animal is stuck or being moved away from you) the animal is released and you get a message. Lox get a longer leash because they often need a detour in tight spots.
• A leashed animal ignores enemies. It neither attacks nor flees, not even when it is hit, and keeps following you. Quickly unleash your animals with the Hide key (put hand items away) if you want them to flee or fight.
• Careful with lox in tight spaces (houses, narrow paths, between buildings): vanilla pathfinding often finds no way for such a big animal. The lox then seems to run off in another direction while it searches for a detour to you. Lead lox through open terrain where possible.

The leash ends automatically and the animals stay in place when:

• you unequip the leash, drop it or equip a shield, two-handed weapon or tool (e.g. building hammer) in its place
• you put your hand items away manually (Hide)
• you or the animal die, or you log out / disconnect
• the animal is more than 18 m (lox: 30 m) away (only this animal)

Swimming, crafting at a station or the barber hide your hand items only temporarily: the leash stays active and you take it back in hand afterwards. Sitting and steering a ship keep the leash in your hand.

Portals

Leashed animals travel through portals with you and appear in front of you at the exit.

• Stone portal: all tamed animals
• Wooden portal: all tamed animals except lox, asksvin and moose, they are too big. If one of your leashed animals does not fit, the portal does not activate and you get a message. Your animals stay leashed.
• Animals are not affected by the item teleport restrictions (metals etc.).
• Dungeon entrances and non-portal teleports do not take animals along, and if you enter, the leash will be released with a message.

Pack saddle

A saddle for lox with its own inventory. It turns the lox into a pack animal. You cannot ride on it - lead the lox on the leash instead.

• Crafted at the same station and level as the vanilla lox saddle: 10 black metal, 20 leather scraps, 10 linen thread, 20 wood. Cannot be upgraded.
• Put it on like the vanilla saddle: put it in your hotbar, look at a tamed lox and press its number key. Only lox, and only one saddle per lox (pack saddle or vanilla saddle).
• Look at the pack saddle: Use opens the inventory, Shift + Use takes the saddle off (only when the inventory is empty). Both work with or without the leash in your hand.
• Personal: only the player who put the saddle on can open it and take it off. For everyone else it behaves like the lox itself. Wards do not lock it.
• Same size as a wooden chest. The content stays on the lox, also after logout and server restart.
• The more you load, the more bags you see on the lox. The bedroll shows as soon as anything is inside.
• The cargo does not slow the lox down.
• If the lox dies, all cargo drops in floating cargo crates (like a sinking ship) and the pack saddle falls next to them. Anyone can empty the crates; they disappear when empty.
• Can be put on a horizontal item stand, not on wall stands or armor stands.

Map markers

• Paw markers: all tamed animals in your currently loaded area are marked on the map and minimap, no matter who tamed them, so you can find your Hen in the forest again. These markers are not saved and they move with the animals. You can turn them off by right-clicking the paw icon in the bottom right of the large map.
• Your own paw markers: the paw is available as a marker like the vanilla markers. Select it and double-click the map to place one (it will be saved, can be named and removed like vanilla markers). Right-click the paw in the marker bar to show/hide all manual and automatic paw markers.
• Paw map markers you place yourself are saved with the character's map. If the character is loaded without LeashMe, Valheim shows them as a standard marker (name and position are kept). Once saved without LeashMe, they stay standard markers, also after reinstalling the mod. The same applies to markers shared via a cartography table.

Vanilla interactions

While you hold the leash, tamed animals show only Leash / Unleash instead of the vanilla actions (pet, follow/stay, ride). To use those, unequip the leash first. Exception: the pack saddle actions (open, take off) also work with the leash. Without the leash equipped, LeashMe does not change any animal interaction.

A leashed animal cannot be switched between follow/stay by anyone, including its holder - it always follows.

Multiplayer

• Other players can see your leash. They cannot take over or command an animal you are leading. They can still pet it of course. As in vanilla, tamed animals are not owned by the player who tamed them. Another player can therefore leash any tamed animal that is not already leashed or following another player.
• When an animal is ridden by a player, it CAN be leashed by another player. While the rider gives commands like direction, the leash does not have any effect as the rider commands override the leash commands. If the rider does not give any commands, the animal can be led around by the leash with the rider on top. If the rider steers the animal more than 18 m (lox: 30 m) away, the animal will be auto-unleashed with a message to the player holding the leash.

Known issues

• Vanilla behaviour from item stands affects this mod: if you put an equipped leash (or any shield) on an item stand and take it back, the inventory still marks it as equipped although it is not in your hand, so you cannot leash animals. Unequip and equip it again.
• As mentioned above, Lox and especially 5 of them on a leash are very difficult to control because of pathfinding issues in narrow spaces (between a house and a wall, on bridges, etc.) where they cannot mow down tiny things like fully grown trees and such. They turn around to pathfind a lot which can be super annoying. If you plan on keeping them at your base, make sure you have a wide entrance to their enclosure.
• Not compatible with LoxSaddleBags: its saddle can be put on a lox that already wears a pack saddle.

Requirements

• BepInExPack for Valheim: Nexus, Hexium, Thunderstore
• Jotunn, the Valheim Library: Nexus, Hexium, Thunderstore

Tested with Valheim 1.0.16, BepInExPack 5.4.2350 and Jotunn 2.30.2.

Every player and the server need LeashMe (same minor version).

Compatibility: I am a software developer and I have 1000+ hours in Valheim. I love this game. I do use some mods which were all active when I developed and tested this mod:

• Willybachs HD Valheim and Badgers HD Terrain <3
• Advize Plant Everything
• CraftFromContainers
• CraftingStationTweakz
• ExtendedPlayerInventory
• FloatingItems
• PlanBuild
• QuickStackStore
• Sakey's My Kvastur
• ValheimBuildCamera

Changelog

• 1.2.0 – New: pack saddle for lox (own inventory, visible cargo, cargo crates on death). Moose: leash level 3, too big for the wooden portal, rope at the head. Spirit caller summons are no longer leashable and get no paw marker. Paw marker slightly darker. All players and the server need the new version.
• 1.1.0 – Lox are released at 30 m instead of 18 m, so they have room for pathfinding detours. Fixed: an animal that was hit while leashed now fights back right after you unleash it. All players and the server need the new version.
• 1.0.0 – First release.