【REPO游戏交流QQ群：824639225】

REPO游戏交流、BUG 反馈、优化建议、功能请求、使用问题，请优先加入 QQ 群：824639225。

如果你遇到显示错位、队友/敌人距离不显示、地图价值不显示，建议带上模组列表和 BepInEx 日志进群反馈。

English users: the QQ group above is the primary Chinese support channel. You can also use the Thunderstore page for feedback.

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

WZC UI 是一个给 R.E.P.O. 联机游玩使用的 HUD / Overlay / UI 辅助模组，重点强化队友位置、敌人位置、购物车位置、怪物统计、地图价值、提交资金和中文配置体验。

有了队友位置查看，再也不用在黑漆漆的地图里一个人迷路、喊半天没人知道你在哪；队友倒地后也能快速报点救人。敌人距离、怪物数量、购物车位置、地图价值和探索进度都会集中显示，让你更容易判断什么时候该贪、什么时候该撤、东西掉在哪、队友离你有多远。

这个模组适合喜欢联机开黑、公开房带人、想减少沟通成本、想把信息看得更清楚的玩家。它不是单纯堆一堆数字，而是把 R.E.P.O. 里最容易让人焦虑的信息整理到屏幕上：队友不再失联，怪物不再突然贴脸，购物车不再找不到。

功能速览

独立拆分

从 1.1.0 开始，WZC UI 只保留 UI / HUD / Overlay 显示相关功能。下面两个功能已拆成独立模组，想用时单独安装即可：

• WZC_TabMapZoom：Tab 官方地图鼠标滚轮缩放。
• WZC_ItemRotationControl：抓取物品后的左右/上下旋转反转和旋转灵敏度控制。

这样拆分后，主 UI 不会再修改地图缩放或物品旋转输入，和其他地图、输入类模组冲突的概率更低。

内置价值统计说明

• WZC_UI 完全不依赖 Map_Value_Tracker。地图价值、探索进度和损失价值都由 WZC UI 自己计算。
• 内置计算会扫描当前关卡的 ValuableObject，统计当前地图剩余价值，并用本关观测到的最高物资价值作为初始总价值兜底。
• 如果关卡刚生成、物资还没准备好，右下角可能短暂显示 无法加载，刷新后会自动恢复。

推荐亮点

• 队友位置更安心：局内显示名字和距离，死亡队友也能看到距离，救人和报点更直接。
• 敌人接近更清楚：敌人进入设定范围会自动显示，附近有危险时更容易提前反应。
• 购物车不再丢：多辆购物车会自动编号，推车时颜色变化，找车、集合、搬货都更方便。
• 右下角信息更完整：怪物数量、地图价值、损失价值、探索进度、本局提交资金、商店剩余资金集中显示。
• 中文配置更顺手：配置项尽量使用中文，也支持中英文显示切换，方便自己用，也方便分享给朋友。
• 分区开关更清楚：每个主要功能分类都有统一的“启用”开关，不想显示哪一块就直接关掉哪一块。

1.1.1 更新重点

• 修复单独安装 WZC UI、没有额外渲染类模组时，队友/敌人/购物车局内距离文字可能偏左偏下的问题。
• 优化 Thunderstore 简介，改成更直接的中文功能介绍：王子晨定制 UI、REPO 游戏交流 QQ 群、距离显示、怪物统计、地图价值、探索进度、资金、敌人名字优化、中英配置和公开 API。

1.1.0 更新重点

• WZC UI 主模组只保留显示相关功能，Tab 地图缩放和物品旋转控制拆分为独立模组。
• 修复未安装或关闭 NoItemSpawnLimit 时，右下角信息可能不显示的问题；WZC UI 现在会自己保持跨场景运行。
• 清理临时诊断日志，避免控制台出现 [diagnostic] 循环打印；主循环异常保护也改为本次游戏最多打印一次。
• 新增 WZC UI 内置地图价值计算：探索进度、损失价值和地图价值完全由本模组自己计算，不再读取或依赖 Map_Value_Tracker。
• 游戏内 MODS 配置列表名称改为 A.WZC_UI，版本号会在“模组信息”分类里显示。
• README 增加功能速览表格，打开 Thunderstore 页面就能快速看懂这个模组能做什么。

搜索关键词 / Search Keywords

R.E.P.O., REPO, WZC UI, WZC_UI, WzcUiApi, mod API, public API, HUD, Overlay, UI, right bottom HUD, bottom right overlay, teammate distance, teammate marker, friend distance, player distance, player marker, enemy distance, enemy label, monster distance, monster label, cart distance, shopping cart marker, cart marker, cart label, enemy counter, monster counter, monster count, enemy count, map value, map worth, built-in map value, lost value, exploration progress, submitted funds, shop remaining funds, run haul, Chinese enemy names, improved enemy names, optimized enemy names, Chinese UI, Chinese config, English UI, REPOConfig, config manager, section toggle, category toggle, enable switch, per-section toggle, BepInEx, 模组接口, 公共接口, 内置地图价值, 地图价值插件, 队友距离, 好友距离, 玩家距离, 队友标记, 敌人距离, 怪物距离, 敌人名字优化, 怪物名字优化, 中文优化名字, 中文怪物名, 购物车距离, 购物车标记, 购物车显示, 怪物显示, 怪物数量, 怪物统计, 地图价值, 损失价值, 探索进度, 提交资金, 商店资金, 商店剩余资金, 本局提交资金, 中文配置, 中英切换, 配置分区, 分区总开关, 分类启用, 分区启用, 功能开关, 中文HUD, 中文UI.

中文功能介绍

右下角信息显示

• 显示怪物总数和每种怪物数量。
• 显示探索进度、损失价值、地图价值。
• 显示本局提交资金和商店剩余资金。商店剩余资金为每局开始时快照，当前关卡提交物品不会让它上涨。
• 显示当前关卡编号和关卡名称。
• 显示死亡队友、存活队友和玩家数量。
• 怪物统计、价值统计、好友信息都可以通过各自分区里的“启用”总开关单独关闭。
• 可调整右下角 X / Y 偏移，方便避开其他 UI 模组。
• 可切换文字显示或更贴近游戏 UI 的原生显示。
• 适合把关键信息放在一个地方看，少切地图、少翻菜单、少问队友“你在哪”。

队友距离显示

• 可在队友角色附近显示名字和距离。
• 存活队友显示机器人图标，例如：🤖 张三 10m。
• 死亡队友显示死亡图标，例如：☠ 张三 10m。
• 右下角队友距离行会尽量使用队友身体颜色，方便和游戏内角色颜色对应。
• 自己死亡后，也会出现在死亡队友列表里，方便观战别人时判断自己的死亡位置距离。
• 队友局内文字支持近大远小：配置“字体大小”和“远处字体变小百分比”，默认最远缩小 30%。
• 支持常显、按键显示、靠近自动显示。
• 靠近自动显示只显示配置距离内的队友，不会因为 20m 内有一个队友就显示全图队友。

敌人距离显示

• 可在敌人模型附近显示中文怪物名和距离。
• 敌人局内文字支持近大远小：配置“字体大小”和“远处字体变小百分比”，默认最远缩小 30%。
• 支持常显、按键显示、靠近自动显示。
• 靠近自动显示只显示配置距离内的敌人，不会因为 20m 内有一个敌人就显示全图怪物。
• 敌人进入自动显示距离时，会有从大到小的短暂字体弹出效果。
• 对公开房和高刷怪倍率很友好，能更早知道哪里有危险。

购物车距离显示

• 可在购物车模型附近显示编号和距离，例如：🛒 购物车1 12m、🛒 小购物车1 8m。
• 大购物车和小购物车可以分别开关显示，并且会分开排序编号。
• 编号会绑定到当前关卡内对应的购物车对象，已经分配好的购物车名称不会因为移动或排序刷新而变化。
• 购物车默认黄色显示；如果检测到有人正在推、拉或抓住购物车，会变成绿色。
• 购物车有独立的字体大小、显示高度、刷新间隔和远处衰减设置，默认显示在购物车模型底部。

地图价值与探索进度

• 地图价值已内置计算，不依赖 Tansinator-Map_Value_Tracker。
• 本模组会自己扫描当前关卡的贵重物品，统计当前地图剩余价值，并用本关观测到的最高物资总价值作为初始总价值。
• 地图价值 只显示当前地图剩余价值。
• 探索进度 会以地图初始总价值为 100%，把已经放到提取点和购物车里的物资都算作已探索，只把仍散落在地图上的物资算作未探索。
• 损失价值 会统计本局中摔坏或丢失造成的价值损失。
• 探索进度、地图价值、本局提交资金、商店剩余资金都有独立显示开关，想精简右下角时可以只留下自己需要的行。

中英显示与配置

• 默认中文显示。
• 可在配置第一项切换 English。
• 英文模式会切换右下角字段名、玩家状态、关卡名和怪物名称。
• 配置项尽量使用中文，方便在 REPOConfig 或 BepInEx 配置管理器里调整。
• A.全局设置下的总开关叫“模组启用”，关闭后右下角显示、队友/敌人距离、购物车距离、怪物统计和价值统计都不生效。
• “敌人名字优化”默认开启，中文模式会把直接翻译的敌人名称优化成更顺口、更好辨认的中文名字；没配置优化名时会自动回退到原版中文。
• 每个主要功能分类顶部都有“启用”总开关，方便只保留自己想看的区域。

English Description

WZC UI is a quality-of-life HUD and overlay mod for R.E.P.O. multiplayer. It focuses on teammate distance, enemy labels, shopping cart labels, monster counters, map value, lost value, exploration progress, submitted funds, shop remaining funds, and Chinese/English display options.

Main Features

• Bottom-right HUD with monster count, enemy breakdown, map value, lost value, exploration progress, current run submitted funds, shop remaining funds, level info, teammate list, and player count.
• Teammate distance labels with player-color text where possible.
• Dead teammate distance support, including your own death position when you are spectating.
• Enemy distance labels with localized enemy names and proximity auto-show.
• Shopping cart distance labels. Multiple carts get stable per-level names like Cart1, and carts turn green while being pushed, pulled, or grabbed.
• Proximity auto-show only reveals targets within the configured distance.
• Chinese by default, with an English display option.
• Master toggle to disable the entire UI mod.
• Per-section enable toggles for teammate labels, enemy labels, cart labels, monster stats, value stats, and teammate info.
• Split value display toggles for exploration progress, map value, submitted funds, and shop remaining funds.

Feature Notes

• Teammate distance, enemy distance, shopping cart distance, monster counter, player count, level info, and value HUD are provided directly by this mod.
• Map value display is calculated directly by WZC UI and does not depend on Tansinator-Map_Value_Tracker.
• Distance display, enemy counters, cart labels, funds display, map value, and exploration progress are provided by this mod itself.
• Tab map zoom is now provided by the separate WZC_TabMapZoom mod.
• Held item rotation controls are now provided by the separate WZC_ItemRotationControl mod.

给其他模组调用的接口 / API for other mods

WZC UI 提供公开静态接口 WzcUiApi，其他模组可以引用 wzc_ui.dll 后直接读取本模组已经整理好的显示数据。欢迎其他模组直接调用我的接口，比如拿探索百分比、存活玩家数量、怪物数量、地图价值、队友距离等数据去做自己的 UI 或玩法逻辑。

常用入口：

• WzcUiApi.IsLoaded：WZC UI 是否已加载。
• WzcUiApi.Snapshot：完整运行时快照。
• WzcUiApi.ExplorationProgressPercent：探索进度百分比。
• WzcUiApi.AlivePlayerCount / DeadPlayerCount / TotalPlayerCount：存活、死亡、总玩家数量。
• WzcUiApi.EnemyTotalCount / EnemyBreakdown：怪物总数和每种怪物数量。
• WzcUiApi.Enemies：每个敌人的中文/英文显示名、距离、参考坐标、局内显示坐标、颜色和靠近自动显示状态。
• WzcUiApi.Carts：每辆购物车的编号、是否为小购物车、距离、是否正在被推/拉/抓住、颜色和局内显示坐标。
• WzcUiApi.MapValue / InitialMapValue / UnexploredMapValue / LostMapValue：地图价值、初始价值、未探索价值、损失价值。
• WzcUiApi.CurrentRunSubmittedFunds / ShopRemainingFunds：本局提交资金和商店剩余资金。
• WzcUiApi.LevelNumber / LevelName：当前关卡编号和名称。
• WzcUiApi.AliveTeammates / DeadTeammates：队友名字、距离、死亡状态、本地玩家标记和颜色。
• WzcUiApi.Settings：当前显示配置，例如字体大小、刷新间隔、右下角偏移、队友/敌人显示距离等。

示例：

if (WzcUiApi.IsLoaded && WzcUiApi.Snapshot.IsInRun)
{
    int progress = WzcUiApi.ExplorationProgressPercent;
    int alivePlayers = WzcUiApi.AlivePlayerCount;
    int enemies = WzcUiApi.EnemyTotalCount;
}

English: other mods can reference wzc_ui.dll and read WzcUiApi.Snapshot or the shortcut properties above. The API exposes exploration progress, player counts, enemy counters, map values, funds, level info, teammate distance data, cart distance data, and current display settings.

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

• Map_Value_Tracker: 地图总价值显示参考了这个模组“汇总关卡内贵重物品价值”的思路。WZC UI 使用自己实现的内置计算服务，不读取、不依赖、不打包 Map_Value_Tracker 的源码、DLL 或资源文件。
• BepInEx、Harmony、Unity 和 R.E.P.O. 游戏程序集：作为正常 BepInEx 模组开发依赖使用。本发布包不包含这些游戏或框架 DLL。
• 队友距离显示、敌人距离显示、购物车距离显示、右下角信息组合、中文名称映射、损失价值统计和探索进度显示为本模组定制实现。

安装

Gale / r2modman / Thunderstore Mod Manager

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

手动安装

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

BepInEx/plugins

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

BepInEx/config

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

注意

• 这是客户端 UI 辅助插件，只需要自己安装即可生效；朋友想看到同样 UI 时，也可以让朋友一起安装。
• 如果其他 UI 或距离显示插件也修改同类显示对象，可能会出现显示位置冲突。
• 首次使用建议先在单人或私人房间测试配置。
• 如有问题请加 REPO游戏交流QQ群：824639225。

更新日志

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 地图缩放和打开地图恢复官方状态选项。
• 添加其他功能（实验）：可选物品旋转方向和灵敏度调整，默认关闭。
• 添加中文配置项和中文显示文本。