TrollCompanion
Friendly troll companions with clubs, saved names and progress, shared kills, combat orders and an F6 stats panel with individual recall. Live server configuration. Required on server and clients. Dev
About this mod Author’s original text
TrollCompanion 0.2.10
Summon friendly trolls with the Trollstaff, keep their names and progress, and give them combat orders. Your companions always carry a club. Wild trolls remain unchanged.
Development release: 0.2.10 adds English mod text, an F6 stats panel with individual recall, shared kill progression and live server configuration. It also changes both default base combat multipliers to 2. Automated checks cover the new rules and migrations; full in-game single-player, co-op and dedicated-server validation is still pending.
Installation
Install the same TrollCompanion version on the server/host and every client. Client-only installation is insufficient for multiplayer.
Dependencies:
- BepInExPack Valheim 5.4.2351.
- Jotunn 2.30.2.
These are the dependency versions used for the local compatibility checks.
- Stop Valheim and the server before replacing plugin files.
- Install through Mod Manager, or use its local-mod import to install TrollCompanion-0.2.10.zip into a test profile.
- For a manual server installation, put plugins/TrollCompanion.dll into BepInEx/plugins/TrollCompanion. Keep only one copy. Remove any former manual DLL/PDB before switching that installation to the manager.
- Start the server and client with mods enabled. Check both logs for Loading [TrollCompanion 0.2.10] and TrollCompanion loaded.
Keep your existing configuration and companion data. The first update to 0.2.10 performs the configuration migration described below.
Controls and companion panel
| Input | Action | Staff required? |
|---|---|---|
| F6 | Open or close the companion panel | No |
| Left mouse button | Summon one available companion | Yes |
| Middle mouse button | Recall all active companions | Yes |
| J on ground | Advance, fight along the route, then hold position | Yes |
| J on a hostile creature | Focus that enemy, then hold position | Yes |
| H | End the current order and follow again | Yes |
| Right mouse button | Native blocking | Yes |
Key bindings are configurable locally. Menus and text input block command hotkeys. F6 is unbound in the inspected native defaults; other mods or custom key bindings may still conflict. G remains available for the game's radial menu.
The panel shows each owned companion's name, slot, variant, order/status, current and maximum HP, stars, kills, next star threshold, death cooldown and club attack values. Each eligible active companion has its own recall control. The server checks ownership and the current instance before recalling it; a stale panel row cannot select a newer summon.
The panel distinguishes live network values, last-known network values and stored/next-summon values. Club attack values are calculated before target armour, resistance and other situational effects; they are not damage per second.
J and H control all active companions. A new J order replaces the old order. Attack-move, focus and holding suspend automatic catch-up to the owner, including portal travel. H restores normal following and catch-up. Unreachable orders hold at the current position rather than teleporting to the destination.
Names and roster
Use the game's normal naming dialog on an owned companion. Its native ten UTF-16-character limit and content filtering remain in effect. Clearing the name restores the default label. Extra star indicators stay separate from the saved name.
Names, identity, progression and health persist through recall and resummoning. Names and progression also survive companion death, world restarts, variant changes and temporarily locked slots. Names already lost by an earlier version cannot be reconstructed; rename those companions once.
Default settings
| Setting | Default |
|---|---|
| Companion variant | Ashlands; Forest is optional |
| Active limit at Blood Magic 0 / 50 / 100 | 2 / 3 / 4 |
| Star thresholds | 25 total kills for one star; 75 for two |
| Maximum stars | 2; configurable |
| Shared kill progression | Enabled within 25 m of the defeated enem
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file. In multiplayer, the host and every client need the same mods installed.
Install these first, or the mod will not work: