王子晨的定制 UI 显示 / WZC UI

功能关键词 / Keywords: R.E.P.O. HUD, Overlay, UI, 队友距离, 敌人距离, 怪物统计, 怪物数量, 地图价值, 损失价值, 已提交价值, Tab地图缩放, 地图缩放, 中文配置, Teammate Distance, Enemy Distance, Enemy Counter, Monster Counter, Map Value, Lost Value, Submitted Value, Tab Map Zoom, Chinese Config.

中文介绍

这是一个给 R.E.P.O. 联机游玩使用的定制 UI 辅助模组。它会把队友、敌人、地图价值、怪物数量、玩家状态和关卡信息集中显示在游戏画面里，减少来回开地图、猜队友位置、数怪物和估算价值的麻烦。

主要功能：

• 队友距离显示：显示队友名字和距离，死亡后也可以显示死亡位置，方便报点和救援。
• 敌人距离显示：显示中文怪物名称和距离，默认红色显示，可按键临时显示。
• 右下角信息显示：显示当前关卡、死亡/存活/总玩家数量、怪物总数、怪物分类数量、地图价值、损失价值和已提交价值。
• Tab 地图缩放：打开原版 Tab 地图后可以用鼠标滚轮缩放，并可设置每次打开地图时是否恢复官方默认状态。
• 其他功能（实验）：可选开启物品旋转方向和灵敏度调整，默认关闭。
• 中文配置项：配置分类、配置名称和主要显示文本都尽量使用中文，方便在 REPOConfig 或 BepInEx 配置管理器里直接调整。

适合想要更清楚掌握队友位置、敌人距离、地图收益和当前局势的玩家使用。

功能状态 / Feature Notes

• 队友距离、敌人距离、怪物统计、玩家数量、关卡信息、Tab地图缩放和实验功能由本模组直接提供。
• 地图总价值显示建议配合 Tansinator-Map_Value_Tracker 使用；本模组会读取它的统计值并整合到右下角信息里。未安装时，地图总价值相关显示可能不可用或显示为 0。
• Map_Value_Tracker 不是强制依赖，因为不需要地图价值功能的玩家也可以只使用距离、怪物统计和地图缩放功能。

English Description

WZC UI is a custom quality-of-life UI mod for R.E.P.O. multiplayer sessions. It brings teammate positions, enemy labels, map value, monster counts, player status, and level information into the in-game view, so you can understand the situation without constantly checking the map or guessing where everyone is.

Features:

• Teammate distance display: shows teammate names and distance, including death positions for callouts and rescue.
• Enemy distance display: shows enemy names and distance, using red labels by default and optional key-triggered display.
• Bottom-right HUD: shows current level, dead/alive/total player count, total enemy count, enemy breakdown, map value, lost value, and submitted value.
• Tab map zoom: allows mouse wheel zoom on the vanilla Tab map, with an option to reset the map to the original state every time it opens.
• Experimental extras: optional held-item rotation direction and sensitivity adjustment, disabled by default.
• Chinese configuration: config sections, option names, and most display text are written in Chinese for easier in-game configuration.

This mod is designed for players who want clearer teammate callouts, enemy awareness, value tracking, and general run information.

Feature Notes

• Teammate distance, enemy distance, monster counter, player count, level info, Tab map zoom, and experimental extras are provided directly by this mod.
• Map total value display is recommended to be used with Tansinator-Map_Value_Tracker; WZC UI reads its tracked value and merges it into the bottom-right HUD. Without it, map value related lines may be unavailable or show 0.
• Map_Value_Tracker is not a hard dependency, so players who only need distance display, enemy counters, and map zoom can still use this mod without it.

代码参考与致谢 / Code References & Credits

• Map_Value_Tracker: 地图总价值显示参考了这个模组的统计思路；当本地安装了 Map_Value_Tracker 时，wzcui 会通过反射读取它的 totalValue 和 totalValueInit 字段来保持地图价值显示更接近原模组效果。本发布包不包含 Map_Value_Tracker 的 DLL 或资源文件。
• BepInEx、Harmony、Unity 和 R.E.P.O. 游戏程序集：作为正常 BepInEx 模组开发依赖使用。本发布包不包含这些游戏或框架 DLL。
• 队友距离显示、敌人距离显示、右下角信息组合、Tab 地图缩放、其他实验功能、中文名称映射和损失价值统计逻辑为本模组定制实现。

如果后续继续借鉴其他模组的源码或实现方式，建议在这里继续补充来源和说明。

安装

r2modman / Thunderstore

把发布包安装到 R.E.P.O. 的 profile 后，使用 Start modded 启动游戏。

手动安装

1. 确认游戏已经安装 BepInEx。
2. 把 wzcui.dll 放到：

BepInEx/plugins

1. 可选：把 config/local.repo.enemycountoverlay.cfg 放到：

BepInEx/config

1. 启动游戏后可在配置管理器里调整显示开关、字体大小、刷新频率和按键。

注意

• 这是客户端 UI 辅助插件，最好和朋友使用同一套 mod 环境。
• 如果其他地图 UI、距离显示或输入调整插件也修改同类对象，可能会出现显示位置、地图缩放或输入冲突。
• 首次使用建议先在单人或私人房间测试配置。

更新日志

1.1.4

• 修复本局提交资金统计：只有提取成功、资金真正带走结算后才计入，单纯放进提取点不会提前增加。
• 修复本局损失资金统计：只累计物品摔坏或摔没造成的损失，同一件物品不会重复计算，提交成功后也不会被清零。
• 新增地图剩余价值实时统计：已放到提取点的物品会被排除，购物车内和地图上未提取的物品仍会计入。
• 修复局内 HUD 偶尔在提取完成或场景切换后突然不显示的问题。

1.1.3

• 新增存活好友显示、死亡好友显示两个局内标签开关，可分别控制存活/死亡好友是否在局内显示。
• 优化购物车局内显示位置，改为贴近购物车模型中心底部，减少文字偏到推车把手或外圈的问题。
• 优化游戏中场景判断，商店、休息区、卡车/准备区域也会正常显示局内购物车等信息，主菜单和开场界面仍不显示。
• 更新 WzcUiApi 对外接口字段，其他模组可读取存活/死亡好友局内显示开关和购物车局内显示坐标。

1.1.2

• 优化队友名字读取，减少 NameChanger 等改名模组导致队友名字显示异常的问题。
• 优化队友颜色读取，死亡、复活或局内改颜色后更稳定。
• 修复小购物车收起后仍显示固定位置的问题。
• 优化购物车推动状态判断，减少没人推车时错误显示绿色的问题。
• 优化敌人靠近自动显示的字体弹出效果，进入范围时更平滑、更醒目。
• 提高默认字体大小：队友、敌人、购物车局内显示默认 22，右下角信息默认 20。

1.1.1

• 修复单独安装 WZC UI、没有额外渲染类模组时，队友/敌人/购物车局内距离文字可能偏左偏下的问题。
• 优化 Thunderstore 简介，突出这是王子晨定制的 R.E.P.O. 中文 UI 显示模组，并精简为本模组自身功能介绍。

1.1.0

• 性能优化：同一帧缓存玩家、敌人、购物车和抓取器列表，减少重复扫描导致的周期性卡顿。

• 性能优化：右下角文字布局、敌人/购物车高度、玩家颜色 key、PhotonView ViewID 反射、模型 Renderer/Collider 列表全部改为缓存或复用缓冲，减少 GC 和 UI 刷新抖动。

• 刷新保护：所有可配置刷新间隔统一最低 0.1 秒，避免配置过低导致每帧扫描。

• 拆分：Tab 官方地图鼠标滚轮缩放已独立为 WZC_TabMapZoom 1.0.0，主 WZC_UI 不再修改地图缩放逻辑。

• 拆分：物品旋转左右/上下反转和灵敏度控制已独立为 WZC_ItemRotationControl 1.0.0，主 WZC_UI 不再修改物品旋转输入。

• 修复未安装或关闭 NoItemSpawnLimit 时，WZC UI 在切换场景后可能不刷新、右下角信息不显示的问题；现在插件会自己保持跨场景运行，不再依赖其他模组顺手保活。

• 优化真实关卡判断：不再把 Splash Screen、Main Menu、Shop 等非游玩场景当成可显示关卡，减少启动阶段误刷新。

• 新增 WZC UI 内置地图价值计算：探索进度、损失价值和地图价值完全由本模组自己计算，不再读取或依赖 Map_Value_Tracker。

• 清理临时诊断日志，移除 [diagnostic] 循环打印；主循环异常保护改为本次游戏最多打印一次，避免控制台被刷屏。

• 游戏内 MODS 配置列表名称改为 A.WZC_UI，版本号会在“模组信息”分类里显示，方便确认当前安装版本。

• README 增加功能速览表格，让玩家在 Thunderstore 页面能更快看懂本模组能做什么。

1.0.5

• 新增 Tab 地图缩放兼容保护：启动时会检测 Minimap、小地图、地图缩放、地图缩放倍率等可能冲突的地图类模组；检测到后默认不会执行本模组的 Tab 地图缩放，避免地图对象错位。
• 新增 B.Tab地图缩放 -> 强制生效 开关，默认关闭。打开后可在已检测到冲突地图模组时仍然强制启用本模组的 Tab 地图滚轮缩放，方便高级用户自行取舍。
• 优化队友颜色读取：玩家死亡、复活或局内修改身体颜色后，队友距离和右下角队友列表会定时刷新玩家颜色；读不到颜色时不会再把已有颜色覆盖成白色。
• 修复损失价值漏算：物品从完好状态直接摔坏/销毁、对象从地图里消失时，会把最后记录的剩余价值计入损失，避免只统计到部分损坏差额。
• 优化损失价值和提取提交的区分：提取金额变化后的短时间内，提交成功导致的物品消失不会计入损失；同时更稳地识别已经进入提取点的物品引用。
• 新增对 ValuableObject.AddToDollarHaulList/RemoveFromDollarHaulList 的轻量监听，用游戏自己的提取列表状态辅助判断物品是否已进入提取点，减少提交物品被误算成损失。
• 完善“敌人名字优化”：按原版中文敌人名映射到更顺口、更好辨认的中文优化名字，缺少优化名时自动回退到原版中文；英文语言下始终显示英文。
• 更新敌人中文优化名字，例如 隐身怪 -> 隐身老六、猎人 -> 男枪、尖叫大白 -> 白色电风扇、长袍无脸男 -> 无脸鬼手男、赌盘怪 -> 转转乐 等。

1.0.4

• 优化游戏内配置结构：主要功能分类都增加统一的“启用”总开关，关闭某个分类后该区域整体不显示或不生效。
• 重新整理右下角配置顺序：基础设置、怪物统计、价值统计、好友信息按实际显示逻辑排列。
• 价值统计拆分为独立开关：探索进度、地图价值、本局提交资金、商店剩余资金可以分别开关。
• 优化好友/敌人/购物车局内显示配置顺序，刷新间隔、显示方式、字体大小和远处字体变小等选项更好找。
• 优化右下角好友信息：死亡队友和存活队友连续显示，不再插入空行，看起来更像同一个好友分区。
• 将 A0 语言设置下的全局总开关从“启用”改名为“模组启用”，和其他分区开关区分得更清楚。
• 将 A0 调整为“全局设置”，并新增“敌人名字优化”开关；该开关默认开启，只在中文语言下把敌人名替换成更顺口的中文优化名字，英文模式始终显示英文。
• 更新 README 和搜索关键词，补充分区启用开关、购物车显示、Tab 地图滚轮缩放、公开 API 和地图价值内置计算说明。

1.0.3

• 新增右下角“探索进度”，地图价值不再在后面显示括号百分比。
• 优化探索进度算法：提交点和购物车里的物资会计入已探索，只把仍散落在地图上的物资算作未探索。
• 优化地图价值显示：探索进度显示在损失价值上方，地图价值只显示金额。
• 优化队友列表：死亡队友和存活队友距离行使用玩家身体颜色；自己死亡后也会显示在死亡列表里。
• 优化队友/敌人靠近自动显示：只显示配置距离内的目标，不再因为范围内出现一个目标就显示全图目标。
• 优化敌人靠近提示：敌人进入自动显示距离时字体弹出效果更明显。
• 新增队友/敌人头顶文字近大远小效果，可配置最大字体大小和远处字体衰减百分比。
• 新增购物车距离显示：购物车会显示为“购物车1/2/3 + 米数”，默认黄色，有人推、拉或抓住时显示绿色。
• 优化配置显示顺序：好友信息分区按“死亡队友、存活队友、玩家数量”排列。
• 新增 WzcUiApi 公共接口，其他模组可读取探索进度、玩家数量、怪物统计、敌人距离、地图价值、提交/商店资金、队友距离和当前显示配置。
• 更新 README：把 QQ 群放到最显眼位置，补充 Tab 官方地图鼠标滚轮缩放说明，并增加更多搜索关键词。

1.0.2

• 新增显示语言配置，默认中文，可切换为 English。
• 英文模式下会切换右下角字段名、玩家状态、关卡名和怪物名称显示。
• 将“已提交”调整为“提交/商店资金”，显示为“本局提交资金 + 商店剩余资金”。
• 新增模组总开关，关闭后右下角显示、队友/敌人距离、Tab地图缩放和实验功能全部停用。

1.0.1

• 优化 Thunderstore 描述和 README 关键词，方便通过队友距离、敌人距离、怪物统计、地图价值、地图缩放等功能搜索到本模组。
• 说明地图总价值功能的统计思路参考 Tansinator-Map_Value_Tracker。
• 将物品旋转调整描述为实验功能，默认关闭。

1.0.0

• 整理为可发布版本。
• 添加队友距离显示。
• 添加敌人中文名称和距离显示。
• 添加右下角信息显示：关卡、玩家、怪物、地图价值、损失价值和提交/商店资金。
• 添加 Tab 地图缩放和打开地图恢复官方状态选项。
• 添加其他功能（实验）：可选物品旋转方向和灵敏度调整，默认关闭。
• 添加中文配置项和中文显示文本。