Teleporter Overhead Text
Shows floating 3D text above portals with their tag name.
About this mod Author’s original text
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)
- Install r2modman.
- Select Valheim and open the Default profile.
- Make sure BepInExPack Valheim is installed.
- Download this mod and click Install with Mod Manager,
or go to Settings → Import local mod and select the downloaded zip.
- Click Start modded.
Manual install (BepInEx)
- Install BepInExPack Valheim if you do not already have it.
- Extract the zip.
- 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 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.
- 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.
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: