BetterPingDistance

BetterPingDistance / 更好的標記顯示距離

Reliable on-screen distance (and optional short name) for player pings in PEAK.

在 PEAK 裏爲標記穩定顯示距離（可選玩家名縮寫）。

Maintainer / 維護髮布: youxia173

Chinese alias / 中文名: 更好的標記顯示距離

Version / 版本: 1.2.0

Client side only / 僅客機

Credits / 致謝

This release is a maintained fork based on LucydDemon's BetterPingDistance.

本發佈爲基於 LucydDemon 原作的維護分支。

• Original 原作者:

• Original GitHub / 原作者 GitHub:

Please support the original author if you like the idea.

喜歡這個創意請也支持原作者。

Also builds on the idea of PingDistance by boxofbiscuits97.

思路亦參考 boxofbiscuits97 的 PingDistance。

What this fork improves / 本分支優化了什麼

English

• Reliable teammate pings: distance UI is created in a Harmony Postfix after the ping exists (Prefix exceptions used to skip distance UI while the vanilla ping still appeared)
• GhostPing compatible: works when GhostPing still spawns a ping without line-of-sight
• Safer UI init: canvas/font creation with try/catch and delayed init if GUIManager is not ready
• Stable multiplayer keys: tracks markers by PhotonView id instead of fragile Character refs
• Skin color fixes: restores readable distance color for vanilla skins; falls back to white for broken mod-skin colors
• Optional short name: ShowPlayerNameShort — Chinese first character / Latin letter / first char
• Distance scaling: text scales down at long range so it covers less of the view
• Bilingual config comments (ZH / EN)

中文

• 隊友標記更穩： 在標記生成後的 Harmony Postfix 再創建距離 UI（原先 Prefix 拋錯時會被吞掉，導致只見標記不見距離）
• 兼容 GhostPing： 無視線時 GhostPing 仍生成標記的情況下也能出距離
• 更安全的 UI 初始化： 畫布/字體創建帶異常保護，GUIManager 未就緒時可延後初始化
• 聯機更穩： 用 PhotonView ID 做字典鍵，避免 Character 引用異常
• 皮膚顏色修復： 原版皮膚恢復可讀顏色；模組皮膚顏色異常時回退白色
• 可選名字縮寫： ShowPlayerNameShort — 中文首字 / 拉丁字母 / 首字符
• 遠距離縮放： 距離越遠字越小，少擋視野
• 配置項中英雙語註釋

Install / 安裝

• Install BepInExPack PEAK
• Install this mod (manager) or put youxia173.BetterPingDistance.dll in BepInEx/plugins/

Do not run together with the original LucydDemon BetterPingDistance (same feature, different GUID).

請勿與原版 LucydDemon BetterPingDistance 同時安裝。

Suggested categories: Client Side · Quality Of Life · Mods

Config / 配置

Path / 路徑: BepInEx/config/youxia173.BetterPingDistance.cfg

Launch once to generate / 裝好後先啓動一次遊戲生成配置。

| Key | Default | English | 中文 |

|-----|---------|---------|------|

| DisplayDuration | 3 | Seconds the distance text stays (0.1–30) | 距離文字停留秒數（0.1–30） |

| ShowPlayerNameShort | false | Append short player name after distance | 在距離後顯示玩家名縮寫 |

Edit the file, save, restart the game.

改完保存後重啓遊戲生效。

Changelog / 更新日誌

See CHANGELOG.md.