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]