Summon Commander

A Valheim mod (BepInEx 5) for tracking and commanding your summons: skeletons from the Dead Raiser and spirit animals (wolf, boar, moose, bear) from the Spirit Caller. It is the successor of Skeleton Commander: everything that mod does for skeletons now works for spirits too, and summons no longer box you in.

Client-side: only the players who want to use the mod need to install it. It is not required on dedicated servers or by other players.

Summon Commander replaces Skeleton Commander, which you can uninstall (BepInEx/plugins/SkeletonCommander/). If both are installed, Summon Commander takes over: Skeleton Commander 1.10.0 and later does not load, and older versions are turned off at startup. Your Skeleton Commander settings are copied on the first launch.

Features

• No more getting stuck in your summons – you walk through Spirit Caller spirits instead of being blocked by them (Movement.PassThroughSpirits, on by default; also for skeletons with Movement.PassThroughSkeletons). Only the collision between you and the summons is removed; they still fight, get hit and collide with each other and the world.
• Following at a distance – following summons stop Movement.FollowDistance (4 m) away from you, measured from their edge, so a big moose or bear keeps more room than a skeleton, and summons arriving from different sides spread around you instead of crowding onto your position. A summon closer than Movement.PersonalSpace (1.5 m), e.g. after you walked into the group, steps away.
• Commands and hotkeys – follow, stay and dismiss for all summons at once, only skeletons or only spirits (chat command), or only the one you are aiming at (the hover text shows the hotkeys).
• Minimap pins – each summon gets a pin (skeleton trophy for skeletons, Spirit Caller icon for spirits, in the species' HUD color); the label on the large map shows the species and whether it stays.
• HUD – below the minimap: how many skeletons and spirits you have (optionally how many are following or staying), how many spirits of each species you have against the Spirit Caller's limit (Spirits: wolf 2/3 · boar 3/3 · moose 1/3 · bear 0/3, full species highlighted), and a panel per species – skeletons, wolves, boars, moose, bears – each in its own color, with its count against the limit and a compact row per summon: number, name (if you renamed it) or weapon (skeletons), an HP bar colored by health, the Staff of Protection barrier, distance and (optionally) whether it stays. Spirits are called by their species (e.g. Wolf). The panels are as wide as the longest name needs, or as wide as you set (HUD.PanelWidth), with the content fitted to that width. With a full pack the list shrinks to fit on the screen. Every part can be hidden.
• Choosing the spirit species – make the Spirit Caller always summon a wolf, boar, moose or bear instead of a random species (Summon.NextSpirit, or Left Alt + K in game); the HUD shows your choice.
• English and Polish – the mod's texts follow the game's language (Polish in a Polish game, English otherwise); creature names come from the game's own translations.
• Health bars, glow and death notifications for your summons.
• Skeleton team loadout – choose the weapons of your skeleton team in SkeletonTeam.Slot1–Slot4; each new skeleton gets the weapon the team is missing.
• Summon limit fix – summons told to stay count toward the staff's summon limit, so you cannot exceed it by leaving summons behind. As in the base game, each creature type has its own limit: the Spirit Caller picks a random species on every cast and allows N of each species at upgrade level N (e.g. 2 wolves, 2 boars, 2 moose and 2 bears at level 2), the Dead Raiser N skeletons. Over the limit the summon with the least HP is dismissed (Summon.DismissWeakest). Summons far away or outside the area the game simulates are dismissed, also when you use a portal or die, unless another player is near them (Summon.KeepNearOtherPlayers).

Controls

Hotkeys

When you aim at one of your summons, Follow / Stay / Dismiss affect only that one. Hotkeys are ignored while typing in chat and in menus, the inventory and the large map. While a hotkey's modifier is held, the game ignores that hotkey's key (Left Alt + F / G do not trigger the Forsaken power or emote wheel).

Chat commands

Type in chat (Enter), or in the F5 console without the slash. The last word is optional (all by default).

The commands do not require devcommands. They affect summons in the area loaded by the game.

Configuration

File: BepInEx/config/xmordax.valheim.summoncommander.cfg (or in-game with ConfigurationManager, F1).

License

MIT – see https://github.com/michalw387/SummonCommander/blob/main/LICENSE

Changelog

1.0.1

Added

• Requirements and installation instructions in the README.

1.0.0

First release as Summon Commander, the successor of Skeleton Commander 1.9.1.

Added

• Spirit Caller support – spirit wolves, boars, moose and bears get everything skeletons have: follow / stay / dismiss hotkeys and commands, minimap pins (Spirit Caller icon in the species' HUD color, labeled by species), HUD panels, health bars, glow, death notifications and the summon limit fixes (each creature type keeps its own limit, as in the base game).
• Walking through summons – the collision between you and Spirit Caller spirits is removed, so a group of spirits can no longer box you in (Movement.PassThroughSpirits, on); the same for skeletons with Movement.PassThroughSkeletons (off).
• Following at a distance – following summons stop Movement.FollowDistance (4 m) from you, measured from their edge, instead of pushing to within 3 m of your position, and step away when closer than Movement.PersonalSpace (1.5 m). Movement.ImprovedFollow = false restores the base game's following.
• Spirit species in the HUD – Spirits: wolf 2/3 · boar 3/3 · moose 1/3 · bear 0/3: your spirits of each species against the Spirit Caller's limit (N of each at upgrade level N), full species highlighted (HUD.ShowSpiritSpecies).
• HUD grouped by species – a panel per species (skeletons, wolves, boars, moose, bears) in its own color, with its count against the summon limit, and a compact one-line row per summon (number, name or weapon, HP bar, distance, staying). The list shrinks when it would not fit on the screen. Lists and /sc list are grouped the same way, with names in the species' colors.
• The chat command is now /sc [list|follow|stay|dismiss] [all|skeletons|spirits].
• Choosing the spirit species – Summon.NextSpirit makes the Spirit Caller always summon a wolf, boar, moose or bear instead of a random species (Random, the default, keeps the base game's behavior); at that species' limit the new spirit replaces one of the same species. Hotkeys.NextSpirit (Left Alt + K) switches it in game, and the HUD's spirit line shows the choice (next: wolf).
• Polish translation – the mod's HUD, messages, hover hints, minimap pins and chat output follow the game's language: Polish when the game is in Polish, English otherwise. Species panels are headed in the plural (Skeletons, Wolves, Boars, Moose, Bears / Szkielety, Wilki, Dziki, Łosie, Niedźwiedzie); other creature names still come from the game's own translations. Chat commands and config settings stay in English.
• HUD.PanelWidth sets the width of all species panels (0, the default, fits the longest name). In a set width the HP bars keep room for their numbers and the names get the rest; text that does not fit shrinks a little before it is cut with an ellipsis.

Changed

• HUD.ShowStateSummary is off by default: the counter no longer adds "(N following, M staying)".
• HUD.ShowState is off by default: the HUD panels' HP bars take the space of the "staying" column, which is only reserved while the option is on.
• The name column of each HUD panel fits its longest label (e.g. "#4 Kjettil · sword & shield"), and all panels are as wide as that needs; spirit panels, whose labels are only numbers, give the space to longer HP bars.
• Settings that only concern skeletons are named so: Summon.TeamEnabled and Summon.TeamSlot1–4 are now SkeletonTeam.Enabled and SkeletonTeam.Slot1–4, HUD.ShowTeam is HUD.ShowSkeletonTeam. Values under the old names (e.g. from a copied Skeleton Commander config) are moved to the new ones.
• Plugin GUID xmordax.valheim.summoncommander; Skeleton Commander's config file is copied on first launch. If Skeleton Commander is also installed, Summon Commander takes over: Skeleton Commander 1.10.0+ does not load, and older versions are turned off at startup.

Fixed

• HUD panels no longer cut species names with Polish letters (and other letters the HUD font lacks) down to their first letters: "Niedźwiedź", "Łoś" and the skeletons' header showed as "Nie…", "Ł…" and "K…".