BetterPlayerDistance.zh

A bilingual (English / 中文) BepInEx mod for PEAK — locate teammates with always-visible player labels and rich UI tuning.

---

English

A polished BepInEx mod for PEAK that overlays occlusion-free player labels and distance markers; locate teammates fast with three trigger modes (Hold / Toggle / AlwaysOn) and rich UI knobs.

📋 Features

• Three display modes
  • Hold — press and hold the hotkey to show; labels linger for a moment after release
  • Toggle — press once to show, press again or wait for the timer to hide
  • AlwaysOn (v0.1.14+) — always-on by default, displays every in-game player; press the hotkey to manually hide / re-show; joiners and leavers are auto-managed
• Downed Pointer (v0.1.17+) — countdown label (face icon + percent/seconds) above downed players, plus a screen-edge indicator for off-screen downed/dead teammates; smooth fade in/out
• Dedicated UI layer: labels are never occluded by walls or objects
• Tunable durations, font sizes, min/max distance and global opacity
• Debug console summoned with Insert (spawn fake players, preview fonts, scan entities)
• Toggle duration supports 10–9999s; double-tap C to reset stuck labels

⚠️ Compatibility

No known conflicts, but do not run alongside other player-locator mods.

⚙️ Installation

1. Install BepInEx.
2. Drop BetterPlayerDistance.dll into BepInEx/plugins/.
3. Launch the game once to generate the config file.

🔧 Configuration

Config file: BepInEx/config/com.AiAe.betterplayerdistance.cfg.

Since v0.1.15 every section, key and 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) — debug console toggle & key, TMP missing-glyph warning suppression
• 4. 昏迷指向 (Downed Pointer) — master switch, use-icon toggle (plain text when off), edge indicator switch, label font size, label/edge icon sizes

Tip — use BepInEx.ConfigurationManager for live in-game tuning (F1).

⚠️ Upgrade Note (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

Feedback & bug reports: [email protected]

---

中文

一款视角效果更好的，具有更多可自定义选项的能够快速定位你的队友的模组。

📋 功能

• 三种显示模式
  • 按住 (Hold) — 按住快捷键显示，松手后保持一小段时间再关闭
  • 切换 (Toggle) — 按一下显示，再按一下或倒计时结束后关闭
  • 常显 (AlwaysOn) (v0.1.14+) — 默认全程显示当前在场所有玩家；按快捷键可手动隐藏 / 再次按下恢复；新加入 / 中途离开自动加上或移除标签
• 昏迷指向 (v0.1.17+) — 昏迷玩家头顶显示倒计时标签（表情图标 + 百分比/秒数），屏幕外昏迷/死亡队友在屏幕边缘显示指示器；支持平滑淡入淡出
• 独立渲染层：标签不会被墙壁或物体遮挡
• 显示时长、字体大小、最大 / 最小显示距离、整体透明度均可自由调整
• Debug 模式内置 Insert 键呼出的调试控制台（生成假人、预览字体、扫描实体）
• Toggle 模式时长支持 10~9999 秒；若遇标签卡住可快速按两次 C 重置

⚠️ 兼容性提示

目前没遇到兼容性问题，但不建议同时启用其他显示玩家位置的模组。

⚙️ 安装说明

1. 确保你已经安装了 BepInEx。
2. 将 BetterPlayerDistance.dll 文件放入游戏的 BepInEx/plugins/ 文件夹中。
3. 运行一次游戏以生成配置文件。

🔧 配置

配置文件位于 BepInEx/config/com.AiAe.betterplayerdistance.cfg。

自 v0.1.15 起，所有 section / key / description 均已改为「中文 (English)」格式，按用途分三栏：

• 1. 基础 (Basic) — 快捷键、显示模式、切换显示时长、松手保持时长
• 2. 界面 (UI) — 是否显示名称 / 距离、最大 / 最小显示距离、名字字号、距离字号、整体透明度
• 3. 调试 (Debug) — 调试控制台开关与呼出键、TMP 缺字警告抑制
• 4. 昏迷指向 (Downed Pointer) — 总开关、以图标形式显示昏迷（关闭则用文字替代）、屏幕边缘指示器开关、昏迷标签字号、标签/指示器图标大小

推荐配合 BepInEx.ConfigurationManager 在游戏内（F1）实时调整。

⚠️ 升级提示（v0.1.13 → v0.1.15） 所有 key 名追加 (English)，建议删除 *\PEAK\BepInEx\config\com.AiAe.betterplayerdistance.cfg 让游戏重新生成。

📞 联系作者

反馈 Bug 或建议：[email protected]