Teleporter Overhead Text

See portal tags from a distance — floating 3D text above each teleporter shows the name you set.

When you walk near a portal, Teleporter Overhead Text draws the tag in world space above the frame so you can tell where it goes without hovering. Labels update when you rename a portal, and they hide when walls block your view.

• Floating 3D text above wood and stone portals
• Color presets, custom RGB, and RGB cycle modes
• Line-of-sight and distance checks (no wall-hack names)
• Press Page Up to show or hide labels (changeable in config)
• Client-side only — no server install required

Questions or bugs? Discord

---

Install with r2modman (recommended)

1. Install r2modman.
2. Select Valheim and open the Default profile.
3. Make sure BepInExPack Valheim is installed.
4. Download this mod and click Install with Mod Manager,
   or go to Settings → Import local mod and select the downloaded zip.
5. Click Start modded.

---

Manual install (BepInEx)

1. Install BepInExPack Valheim if you do not already have it.

2. Extract the zip.

3. Copy files into:

   Valheim\BepInEx\plugins\ModdedWolf-Teleporter_Overhead_Text\

   The folder should contain Teleporter_Overhead_Text.dll, manifest.json, icon.png, and README.md.

   Prefer the Thunderstore / r2modman package folder name (ModdedWolf-Teleporter_Overhead_Text) so enable/disable in the mod manager controls the install. A bare plugins\Teleporter_Overhead_Text\ folder is invisible to r2modman and will always load.

4. Launch Valheim.

---

Configuration

After first launch, settings are saved here:

BepInEx\config\ModdedWolf.Teleporter_Overhead_Text.cfg

Section	Key	Default	Description
General	Enabled	true	Master toggle for portal overhead labels
General	ToggleKey	PageUp	Hotkey to show/hide labels (None disables)
Appearance	HeightOffset	2.5	Minimum height above the portal origin (tall portals also clear the mesh top)
Appearance	Font	Arial	Builtin or installed OS font name
Appearance	Size	0.12	World-space character size
Appearance	FontSize	64	TextMesh glyph resolution
Appearance	ColorPreset	SoftGold	Custom, White, SoftGold, Red, Green, Blue, Yellow, Cyan, Magenta, Orange, RGBCycleSlow, RGBCycleMedium, RGBCycleFast
Appearance	ColorR / ColorG / ColorB / ColorA	255 / 184 / 56 / 255	RGB channels (0–255) when ColorPreset is Custom; alpha also used by RGB cycle presets
Visibility	MaxDistance	40	Hide labels farther than this many meters (0 = always show in range)
Visibility	RequireLineOfSight	true	Hide labels when a wall blocks view of the teleporter
Visibility	ShowWhenEmpty	false	Show (unnamed) on portals with no tag
Advanced	UpdateInterval	0.5	Seconds between tag text refreshes

---

Notes

Labels sit above the portal mesh (including Portal Stone). With RequireLineOfSight on, names stay hidden through walls and closed gates. The ToggleKey only flips visibility while you play — it does not rewrite the Enabled config entry. Toggle is ignored while console, chat, or text input is focused.