传送器上方文本

传送门头顶文本

从远处即可看到传送门标签——每个传送门上方漂浮的 3D 文本会显示你设置的名称。

当你走近传送门时，Teleporter Overhead Text 会在世界空间中于框架上方绘制标签，让你无需悬停即可知道它通往何处。重命名传送门时标签会更新，当墙壁遮挡视线时标签会隐藏。

• 木制和石制传送门上方的漂浮 3D 文本
• 颜色预设、自定义 RGB 和 RGB 循环模式
• 视线和距离检查（不会穿墙显示名称）
• 按 Page Up 显示或隐藏标签（可在配置中更改）
• 仅客户端——无需服务器安装

有问题或 bug？Discord

使用 r2modman 安装（推荐）

1. 安装 r2modman。
2. 选择 Valheim 并打开 Default 配置文件。
3. 确保已安装 BepInExPack Valheim。
4. 下载此模组并点击 Install with Mod Manager，或前往 Settings → Import local mod 并选择下载的 zip。
5. 点击 Start modded。

手动安装（BepInEx）

1. 如果尚未安装，请安装 BepInExPack Valheim。

2. 解压 zip。

3. 将文件复制到： Valheim\BepInEx\plugins\ModdedWolf-Teleporter_Overhead_Text\ 该文件夹应包含 Teleporter_Overhead_Text.dll、manifest.json、icon.png 和 README.md。

   建议使用 Thunderstore / r2modman 的包文件夹名称（ModdedWolf-Teleporter_Overhead_Text），这样在模组管理器中启用/禁用即可控制安装。仅使用 plugins\Teleporter_Overhead_Text\ 文件夹对 r2modman 不可见，并且会始终加载。

4. 启动 Valheim。

配置

首次启动后，设置会保存在此处：

BepInEx\config\ModdedWolf.Teleporter_Overhead_Text.cfg

Section	Key	Default	Description
General	Enabled	true	传送门头顶标签的总开关
General	ToggleKey	PageUp	显示/隐藏标签的热键（None 禁用）
Appearance	HeightOffset	2.5	传送门原点上方的最小高度（高传送门也会避开网格顶部）
Appearance	Font	Arial	内置或已安装的操作系统字体名称
Appearance	Size	0.12	世界空间字符大小
Appearance	FontSize	64	TextMesh 字形分辨率
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	当 ColorPreset 为 Custom 时的 RGB 通道（0–255）；alpha 也用于 RGB 循环预设
Visibility	MaxDistance	40	超过此米数时隐藏标签（0 = 范围内始终显示）
Visibility	RequireLineOfSight	true	当墙壁遮挡传送门视线时隐藏标签
Visibility	ShowWhenEmpty	false	在没有标签的传送门上显示（未命名）
Advanced	UpdateInterval	0.5	标签文本刷新间隔秒数

说明

标签位于传送门网格上方（包括 Portal Stone）。开启 RequireLineOfSight 后，名称会隔着墙壁和关闭的门保持隐藏。ToggleKey 只会在游戏过程中切换可见性——它不会重写 Enabled 配置项。当控制台、聊天或文本输入框处于焦点时，切换会被忽略。