You are viewing a potentially older version of this package. View all versions.
KydlDev-FocusFollowedPlayer-2.0.1 icon

FocusFollowedPlayer

Follow one player: hide other players' health bars, focus glow and arrow on the followed player, portal notifications

By KydlDev
Date uploaded 31 minutes ago
Version 2.0.1
Download link KydlDev-FocusFollowedPlayer-2.0.1.zip
Downloads 2
Dependency string KydlDev-FocusFollowedPlayer-2.0.1

This mod requires the following mods to function

ValheimModding-Jotunn-2.30.2 icon
ValheimModding-Jotunn

Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.

Preferred version: 2.30.2
denikson-BepInExPack_Valheim-5.4.2351 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2351
KydlDev-KydlCore-1.1.1 icon
KydlDev-KydlCore

Shared runtime for all KydlDev mods: one UI root and theme, the KY hub window (F6; the one menu of every KydlDev mod) and the KY-Items category and registry.

Preferred version: 1.1.1

README

FocusFollowedPlayer

Version 2.0.0

Valheim BepInEx mod: follow one player, hide the other players' health bars, show a glow on the followed player and an arrow pointing at them when they are far away, and get a notification when the followed player takes a portal.

Requirements

  • BepInExPack_Valheim 5.4.2351
  • Jotunn 2.30.2
  • KydlCore 1.0.0 (the KY hub with the menu, the shared UI look and the input lock; the mod manager installs it for you)
  • Everybody needs the mod (server and every client, exactly the same version): [NetworkCompatibility(EveryoneMustHaveMod, Patch)]. Following changes what other players see (health bars, map position, follow requests), so a player without the mod is refused when joining.

In-game menu (KY hub, F6)

Press F6 and pick FocusFollowedPlayer in the KY hub. There is no menu key of its own any more.

  • Players - live list of the other players online with their status (nearby / map position, distance) and the portal they took. Press Follow next to a player, Unfollow (or Stop following) to stop.
  • Options - Enable Mod, show health of all players, follow hotkey, map position sharing, privacy, the server switch (admins only) and the debug log.
  • Glow and Arrow - look and feel.
  • Alerts - portal notification settings. While this tab is open an example notification is drawn on the screen, so you can place it.

Every change in a tab is applied and saved at once (live). The mouse wheel only scrolls the hub while it is open; it never zooms the game camera.

Settings

Everything is in com.kydldev.FocusFollowedPlayer.cfg and in the tabs above. Every functionality has its own Enable; [General] Enable Mod switches the whole mod. A feature that is switched off stops at once (no restart) and a switched-off Follow feature has no Players tab.

If you used version 1.0.0 your settings are taken over from kydldev.FocusFollowedPlayer.cfg the first time this version starts (moved keys keep their value).

[General]

  • Enable Mod (default ON, the toggle key switches it) - master switch of the mod for you. OFF = no health bar hiding, no glow, no arrow, you cannot start following anybody, no follow pings are sent, and nobody can follow you: a follow request is answered with "does not allow being followed" and your map position is not forced on. Portal alerts are neither sent nor shown. The followed name stays saved and works again when you switch it back ON.
  • ShowHealthOfAllPlayers (default OFF) - OFF: while you follow somebody (and they are online) the health bars of all other players are hidden. ON: every health bar is shown as usual. With nobody followed nothing is hidden either way.
  • FollowedPlayer (default empty) - name of the followed player. Set it with the Players tab; empty = nobody.
  • ToggleKey (default F8) - turns the mod on / off for you (same as Enable Mod). It is ignored while typing, in the menus or in the KY hub.
  • ForcePublicPosition (default ON) - ask the followed player (must have this mod) to turn their map position sharing ON. Their mod turns it OFF again about 20 seconds after the last follower stopped (or as soon as they set AllowFollowAndShare to OFF). Sharing that a player switched on or off themselves is never touched.
  • AllowFollowAndShare (default ON) - ON: other players can follow you and turn your map position sharing on. OFF: nobody can follow you, your map position is never forced, your portal alerts are not sent.

[Server]

  • Enable (default ON) - server admin setting: OFF = no hiding, no glow, no arrow, no follow requests for anybody on the server. Admin-only and synced to all clients; admins (and the host / the player in single-player) can change it in the Options tab or the config manager (F1), everybody else sees it locked. Only the machine that owns it (dedicated server, host, single-player) writes it to disk.

[Glow]

  • Enable (default ON) - glowing outline around the followed player.
  • Color (default #00FFFFFF) - outline colour, RGBA hex.
  • Intensity (0.1 - 1, default 0.5) - brightness of the glow; it also applies to the arrow, whichever arrow colour is used.
  • WidthPixels (0.5 - 12, default 2) - outline thickness in screen pixels.
  • ThroughWalls (default ON) - visible through terrain and objects.
  • MaxDistance (25 - 200 m, default 100) - the glow is shown up to this distance; further away the arrow takes over.
  • AllowGlowAtAnyDistance (default OFF) - ON: the followed player glows at any distance, ignoring MaxDistance and SyncWithArrow. The arrow keeps its own distance. The glow can only be drawn while the player is loaded in your game (Valheim only loads nearby players).
  • SyncWithArrow (default ON) - one shared distance: the glow stops exactly where the arrow starts. OFF: glow and arrow each use their own distance. With sync ON, changing either distance changes both.

[Arrow]

  • Enable (default ON) - arrow pointing to the followed player when far away.
  • UseGlowColor (default ON) - the arrow uses the glow colour; OFF: it uses Arrow Color.
  • Color (default #FF8000FF) - arrow colour when UseGlowColor is OFF, RGBA hex.
  • MinDistance (25 - 200 m, default 100) - the arrow only shows beyond this distance.
  • Size (0.5 - 1, default 1) - arrow size, 1 = full size.
  • ArrowSeeThrough (default OFF) - ON: only a thin border of the arrow is drawn, the inside is see-through.
  • HeightAboveGround (0 - 30 m, default 3) - hover height above the ground.
  • FollowVertical (default ON) - the arrow tilts up / down toward the target (a target high in the air or far below).
  • DistanceFromPlayer (0 - 50 m, default 5) - how far from you, toward the target, the arrow hovers.

[Notifications]

When a player takes a portal, their mod broadcasts the portal's name ("(unnamed portal)" if empty).

  • Enable (default ON) - show a text on the right side of the screen when the followed player takes a portal (needs this mod on their side). The portal also appears on the player's row in the Players tab until you take a portal with the same name; it is cleared when you leave the world.
  • DistanceFromRightEdge (0 - 800 px, default 30) - distance from the right screen edge, in 1920x1080 reference pixels (scales with the screen).
  • HeightOnScreen (0 - 100 %, default 30) - vertical position, % of the screen height from the top.
  • TextSize (12 - 40, default 20) - notification text size.
  • ShowSeconds (3 - 30, default 10) - how long a notification stays.

[DebugLog]

  • Enable (default OFF) - writes detailed lines about everything the mod does (and the glow diagnostics every 10 seconds) to the BepInEx log, for bug reports. Can be switched at runtime.

Multiplayer

  • EveryoneMustHaveMod, exact version. The server and every client need FocusFollowedPlayer and the same version (and KydlCore). Players without it cannot join a server that has it, and the other way round.
  • Follow requests, map position sharing and portal alerts are sent between the mods through RPCs (FocusFollowedPlayer_PortalUsed for portals). A player who set AllowFollowAndShare to OFF or Enable Mod to OFF is never followed and sends nothing.
  • The server admin switch [Server] Enable turns the mod off for every player.

How the glow works

The outline uses three clones per renderer (stencil bit 64): Clear (queue 3099, wipes the bit around the player), Mask (3100, writes it) and Hull (3101, draws only where the bit is not set). The Clear step is needed because anything that already set bit 64 on screen makes the hull fail everywhere.

Notes

  • Version 2.0.0 is a port to the KydlDev spec (new folder layout, features switched live, menu in the KY hub). Checked in game on 2026-11-04 (clean start and quit with all mods loaded, no errors from this mod).
  • The 1.0.0 menu had a Revert changes button (changes were a preview that was saved when the menu closed). The KY hub applies and saves every change at once, so that button is gone.

KydlDev

Get help and stay in touch

Questions, bug reports, ideas or mod requests? Come say hi in the KydlDev Discord: https://discord.gg/tX2CcTNC4W Everyone is welcome, and it is the quickest way to reach me. Source code and issues: https://github.com/kydlDev

CHANGELOG

Changelog

2.0.1

  • Changed: the menus of this mod take their text sizes, text colours and font from KydlCore. Needs KydlCore 1.1.1 or newer.
  • Changed: all the Enable switches are now together in [General] and have new names: Enable Mod (was EnableAll) and Enable Glow, Enable Arrow, Enable Notifications (each was Enable in its own section). The values you had set are taken over; the old entries are removed from your config file.
  • Changed: Enable Mod is now the first setting of [General], in the F1 menu and in the F6 hub (your value is taken over).
  • Changed: the server admin switch [Server] Enable is now [Server] Active for everyone (the value is taken over).
  • New: in the F1 menu the Glow and Arrow colours show a colour box, a hex box (#RRGGBB) and Red / Green / Blue sliders that follow each other.

Testing

  • Unit tests: 36 passed. Integration tests: 39 passed.
  • Property-based tests (FsCheck, included in the unit tests above): 4 property checks with generated inputs.
  • Coverage of the testable code: 100%. Mutation testing (Stryker): 100% of the mutants are caught by the tests.
  • Performance benchmarks (BenchmarkDotNet): 3.
  • Static analysis (SonarQube): no Medium or High issues.
  • In game with DrakesTestLab: the full suite of 3 tests per run, run 3 times in a row on the release build, all green (the release requirement).

2.0.0

  • Tested in game with the full TestLab suite (3 tests): 3 green runs in a row on 2026-11-05, plus the ecosystem run with all 12 KydlDev mods loaded together.
  • Internal port to the KydlDev spec (new folder layout, four features - Follow, Glow, Arrow, Notifications - in the KydlCore FeatureRegistry, TestLab suite). Following, glow, arrow and portal alerts work as before. Checked in game on 2026-11-04 (clean start and quit with all mods loaded, no errors from this mod).
  • Requires KydlCore. The window look, the input lock and the KY hub come from the KydlCore mod, which has to be installed (the mod manager adds it).
  • Menu moved to the KY hub (F6): tabs Players, Options, Glow, Arrow and Alerts in the KY hub. The mod has no menu key or window of its own any more. Changes are applied and saved at once (live); the old Revert changes button is gone. The Alerts tab still shows an example notification while it is open.
  • New settings file com.kydldev.FocusFollowedPlayer.cfg: your values from kydldev.FocusFollowedPlayer.cfg are taken over on the first start.
  • One switch per part: [General] Enabled is now [General] EnableAll; new [Glow] Enable, [Arrow] Enable and [Notifications] Enable (the old Enabled / PortalEnabled keys keep their value). A part works only while EnableAll and its own switch are on. [Server] ModEnabled is now [Server] Enable, [Logging] Verbose is now [DebugLog] Enable, [Hotkeys] Toggle is now [General] ToggleKey, and [Privacy] AllowFollowAndShare, [Arrow] ForcePublicPosition moved to [General]; [Range] SyncActivationPoint is now [Glow] SyncWithArrow. The menu key setting is gone (F6 is the KY hub).
  • Everybody still needs the mod, now with the exact same version (EveryoneMustHaveMod, Patch level; was Minor).

1.0.0

Initial release.

  • Follow one player from the in-game menu (F6).
  • Other players' health bars are hidden while you follow someone.
  • Glowing outline on the followed player.
  • Direction arrow when the followed player is far away.
  • Shared glow/arrow distance option.
  • Portal notifications for the followed player.
  • Map position sharing request for the followed player.
  • Privacy switch and server admin switch.
  • Menu with live preview and revert. The window is 70 % of the screen height; the mouse wheel scrolls the menu and does not zoom the game while it is open.
  • Map position sharing that a follow request turned on is turned off again when nobody follows any more.
  • Config file options and optional verbose logging.