BetterPlayerDistance.zh

一款视角效果更好的，具有更多可自定义选项的能够快速定位你的队友的模组。 A polished BepInEx mod for PEAK that overlays bilingual player labels and distance markers; lets you locate teammates fast with three trigger modes (Hold / Toggle / AlwaysOn) and rich UI knobs.

📋 功能 / Features

• 三种显示模式 / Three display modes:
  • 按住 (Hold)：按住快捷键显示，松手后保持一小段时间再关闭 / Hold the hotkey to show, linger for a short moment after release
  • 切换 (Toggle)：按一下显示，再按一下或倒计时结束后关闭 / Press once to show, press again or wait for the timer to hide
  • 常显 (AlwaysOn) [v0.1.14+]：忽略按键，全程显示当前在场的所有玩家；新加入 / 中途离开会自动加上或移除标签 / Ignore the hotkey, always display every in-game player; auto-adds joiners and removes leavers
• 独立渲染层 / Dedicated UI layer：标签不会被墙壁或物体遮挡 / labels are never occluded by walls or objects
• 显示时长、字体大小、最大 / 最小显示距离、整体透明度均可自由调整 / Tunable durations, font sizes, distance clamps and global opacity
• Debug 模式内置 Insert 键呼出的调试控制台 / Debug console summoned with Insert
• Toggle 模式时长支持 10~9999 秒 / Toggle duration supports 10–9999s；若遇标签卡住可快速按两次 C 重置 / double-tap C to reset stuck labels

⚠️ 兼容性提示 / Compatibility

目前没遇到兼容性问题，但不建议同时启用其他显示玩家位置的模组。 No known conflicts, but do not run alongside other player-locator mods.

⚙️ 安装说明 / Installation

1. 确保你已经安装了 BepInEx。 Make sure BepInEx is installed.
2. 将 BetterPlayerDistance.dll 文件放入游戏的 BepInEx/plugins/ 文件夹中。 Drop BetterPlayerDistance.dll into BepInEx/plugins/.
3. 运行一次游戏以生成配置文件。 Launch the game once to generate the config file.

🔧 配置 / Configuration

配置文件位于 BepInEx/config/com.AiAe.betterplayerdistance.cfg。 Config file lives at BepInEx/config/com.AiAe.betterplayerdistance.cfg.

自 v0.1.15 起，所有 section / key / description 均已改为「中文 (English)」格式，按用途分三栏： Since v0.1.15 every section / key / description is bilingual ("中文 (English)") and grouped into three sections:

• 1. 基础 (Basic)：快捷键、显示模式、切换显示时长、松手保持时长 / hotkey, display mode, toggle duration, hold-release linger
• 2. 界面 (UI)：是否显示名称 / 距离、最大 / 最小显示距离、名字字号、距离字号、整体透明度 / show name & distance, distance clamps, font sizes, opacity
• 3. 调试 (Debug)：调试控制台开关与呼出键、TMP 缺字警告抑制 / debug console toggle & key, TMP missing-glyph warning suppression

推荐配合 BepInEx.ConfigurationManager 在游戏内（F1）实时调整。 Use BepInEx.ConfigurationManager for live in-game tuning (F1).

⚠️ 升级提示 / Upgrade Note 从 v0.1.13 升级至 v0.1.15：所有 key 名追加 (English),建议删除*\PEAK\BepInEx\config\com.AiAe.betterplayerdistance.cfg让游戏重新生成。

Upgrading v0.1.13 → v0.1.15: every config key now ends with (English). The simplest fix is to delete *\PEAK\BepInEx\config\com.AiAe.betterplayerdistance.cfg and let the game regenerate it on next launch.

📞 联系作者 / Contact

反馈 Bug 或建议 / Feedback & bug reports：[email protected]

v0.1.5

• Beta 版本发布。 / Beta release.

v0.1.6

• 增加了对彩色名的支持 / Added colored-name support

v0.1.13

• 修复快速转镜头标签没有立刻消失的问题(看着像残影) / Fixed labels not vanishing instantly during rapid camera turns (appeared as ghosts)

v0.1.14

• 新增「常显 (AlwaysOn)」显示模式：忽略按键，全程显示当前在场玩家；新加入 / 中途离开自动维护标签 Added "AlwaysOn" display mode: ignores the hotkey and always shows every in-game player; joiners/leavers auto-managed
• 配置选项重整为三栏：1. 基础 / 2. UI / 3. 调试，便于在 BepInEx Configuration Manager 中分类查找 Reorganized config into three sections (1. 基础 / 2. UI / 3. 调试) for easier browsing in BepInEx Configuration Manager
• 调试控制台显示当前模式名（Hold / Toggle / AlwaysOn） Debug console displays the active mode name (Hold / Toggle / AlwaysOn)

v0.1.15

• 全面双语化：所有 section / key / description 改为「中文 (English)」格式；调试控制台 GUI 改为「中文 / English」格式 Full bilingualization: every section / key / description now uses "中文 (English)"; debug-console GUI uses "中文 / English"
• 三栏命名同步双语：1. 基础 (Basic) / 2. 界面 (UI) / 3. 调试 (Debug) Sections renamed bilingually: 1. 基础 (Basic) / 2. 界面 (UI) / 3. 调试 (Debug)
• 旧 cfg 兼容：本次 key 名全部改名，旧条目将变孤立值，建议删除旧版cfg让游戏重新生成。 Old-config compatibility: every key was renamed and old entries become orphans — the easiest fix is to delete the old cfg and let the game regenerate it.
• 枚举值（Hold / Toggle / AlwaysOn）保持原名，显示模式TriggerMode 配置在新 key 中仍按默认值设定（重新改一下就行） Enum values (Hold / Toggle / AlwaysOn) are unchanged; TriggerMode is rewritten with its default under the new key — just re-select your preferred mode.