WolfPack

Become a Pack Master: Control all your tame creatures at the same time!

No more bunching, nudging and pushing of following tames!

You've tamed them, fed them, bred them and love them. They love you too, but they're always looking for attention and getting in the way. And you have to pet each of them to get them to do what you want.

What you need is a little obedience training. With WolfPack, one keystroke will get all your tame wolves (or other creatures) to follow or stay at the same time.

New setting to avoid large groups of tames bunching up and pushing or nudging you.

New

• Retains last selected creature between sessions
• Added follow radius configuration to reduce bunching, nudging and pushing of large groups of tames.

Features

• Supports all tame creatures
• Configure a list of creatures to call by name, (e.g., Wolf, Boar, Lox)
• Configure groups of creatures to call with wildcards (e.g., Human*, *Spider*, *)

Configuration

General

• DetectionRange: The maximum distance from a player that creatures will be affected by a Follow or Stay command. Default value is 50. Can be set from 1 to 150.

• TrainableCreatures: a comma delimited list of creature names that will respond to Follow and Stay. Only tamed creatures will be affected. Default value is "wolf". NOTE: Values can be a creature, display, or prefab name.

  • Example 1: [ wolf,boar,lox ] Calls either wolves, boars, or loxes (loxen?), depending on which was the current selection (see CharacterSelectionKey below).

  • Example 2: [ Human*,*dwarf,*spider* ] You can add an asterisk (*) as the first and/or last character in a partial creature name to include all creatures who's name begins with, ends with or contains the partial text.

    • Human*: calls all creatures whose name begins with "Human", e.g., Human Commoners and Human Guards, etc.
    • *dwarf: calls all creatures who's name ends with "dwarf", e.g. Dwarf, Greydwarf, etc.
    • *spider*: calls all creatures who have "spider" somewhere in their name, e.g., Spider, Tree Spider, Jumping Spider, etc.

  • Example 3: [ * ] Calls all tamed creatures.

• PackBehaviorShortcut: The keystroke to toggle between Follow and Stay for the currently selected creature. If you set UseTwoKeys to True (see below), this key will only issue the Follow command. Default is LeftAlt+T

• UseTwoKeys: If set to True will use a separate keystroke for the Stay command as configured in AlternateStayShortcut (see below). Default is False

• AlternateStayShortcut: The keystroke to call creatures to Stay. Only used if UseTwoKeys (above) is set to True. Default is LeftAlt+Y

• CreatureSelectorShortcut: The keystroke to rotate through the list of TrainableCreatures (above). Pressing this key repeatedly will cycle through the configured list. If UseMouseWheel (see below) is set to True, holding this key down while spinning the mouse wheel will cycle through the configured list. The current selected creature will appear in the message area in the center of the screen (or top left under the hot bar as configured by Notifications below). Default is LeftAlt+U

• MinimumCreatureLevel: The 'lowest' level of creature (in 'stars') affected by Follow and Stay. Default is 0. Can be set from 0 to 2. Affects all creatures.

• UseMouseWheel: If set to True, the mouse wheel is used to cycle through the TrainableCreatures list to set the current creature. Hold down the CreatureSelectorShortcut key while spinning the mouse wheel. If you don't have a mouse with a wheel or use another input device that makes this difficult, set to False. Default is True

• Notifications: The location of the creature selector message. Default is "Center" in the middle of the screen. You can also set this value to TopLeft under the hot bar, however the center text has a much quicker response.

• StrictObedience: Sets the amount of 'wandering' when creatures are 'stayed'. If set to 0, creatures will obediently remain in one place. Default is 10. Can be set from 0 to 20. Affects all creatures.

• FollowRadius: The radius in which following creatures will randomly distribute around the player to prevent 'bunching'. Default is 10. Can be set from 3 to 30.

Audio

• UseSound: If set to True, will use the sound configured in PackCallSound (below) whenever creatures are called to follow.

• PackCallSound: The audio clip played when creatures are called to Follow. Default is Whistle.wav. WolfPack is distributed with three audio clips; Whistle.wav, Horn1.wav, and Horn2.wav.

  • Whistle is a sharp finger whistle, Horn1 is a traditional hunting horn, and Horn2 is a deeper battle horn. These clips are located in the same folder as WolfPack.dll (...\BepInEx\plugins\Neobotics-WolfPack)

  • NOTE: You can put your own audio clips in this folder, and set PackCallSound to your file name. Be advised, however, this is 'at your own risk'. WolfPack has only been tested with the three included files, which are 16-bit uncompressed PCM .wav files sampled at 44100. WolfPack will attempt to load .wav, .mp3 and .wma files.

  • If you add your own clips, all players in multiplayer must have the same clip installed locally if they want to hear the calls of their fellow players. WolfPack will play the clip configured by each player, as long as it has that clip present locally in the mod folder.

Utility

• MouseWheelLatency: Controls the mouse wheel spin behavior so 'big' spins don't 'overshoot' the next creature in the configured list. The default is 3, which should be sufficient for most users. Increase this value if the wheel spin is too sensitive and you find yourself 'skipping' over creatures in the list. Decrease this value if you find the wheel's response is too 'sluggish'. Can be set from 0 to 10.

• LogCreatureNames: If set to True, will log all 'found' creatures called with Follow and Stay. This may be useful to identify the creature name when configuring the TrainableCreatures list.

• LogLevel: Controls the level of information contained in the log. Default is 3 (Info)

In-game reconfiguration

• You can use Configuration Manager (or similar) mod to change the configuration without exiting the game. The configuration will reload if you make changes to the config file.

Multiplayer

• DetectionRange and TrainableCreatures are server authoritative settings.
• WolfPack will not allow you to accidentally 'steal' someone else's 'following' creatures when calling them, however, actually petting a 'following' creature will cause it to Stay, regardless of who it's currently following.

Notes

• The FollowRadius setting will allow creatures to 'spread out' while following a player. You may need to set this differently for larger creatures. For example, a radius of 10 may work well with wolves, and 30 with loxes.
• Config settings are server authoritative except those in bold italics
• WolfPack does not modify any interactions with creatures. In other words, it doesn't allow you to individually pet them to Follow or Stay (e.g. Lox) without some other mod such as AllTameable (https://www.nexusmods.com/valheim/mods/1571).
• You may find a 'wander' limit (set by StrictObedience_) of 0 too restrictive. A low, non-zero number gives the creatures a bit of 'wiggle room' while still keeping them grouped together.
• You can mount up and ride at the forefront of a herd of charging Lox!

Compatibility issues & defects

• If you find a compatibility issue you can post it on NexusMods. Be sure to include the mod name and version you think may be incompatible.
• If you have a bug please report it on NexusMods. If you do post a bug report, please make sure to include the following:
  • Your version of this mod
  • What you were doing, or attempting to do when it happened
  • If it's repeatable - i.e., can you duplicate it?
  • The exact behavior you observed (or didn't observe)
  • If possible, post a capture of the log file with errors (errors always begin with this mod's name) on Discord

You can find all Neobotics released mods on:

• Thunderstore: https://tinyurl.com/NeoboticsOnThunderstore
• Nexus Mods: https://tinyurl.com/NeoboticsOnNexus

Your comments and feedback are always welcome. Post on NexusMods or Discord: https://tinyurl.com/NeoboticsOnDiscord