【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 汇总关卡内贵重物品价值的做法，在这里感谢原作者提供的思路。
• 内置计算会扫描当前关卡的 ValuableObject，统计当前地图剩余价值，并用本关观测到的最高物资价值作为初始总价值兜底。

推荐亮点

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

搜索关键词 / 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。
• B.好友局内显示 里可单独开关存活好友显示和死亡好友显示，默认都开启。
• 右下角队友距离行会尽量使用队友身体颜色，方便和游戏内角色颜色对应。
• 自己死亡后，也会出现在死亡队友列表里，方便观战别人时判断自己的死亡位置距离。
• 队友局内文字支持近大远小：配置“字体大小”和“远处字体变小百分比”，默认最远缩小 30%。
• 支持常显、按键显示、靠近自动显示。
• 靠近自动显示只显示配置距离内的队友，不会因为 20m 内有一个队友就显示全图队友。

敌人距离显示

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

购物车距离显示

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

地图剩余价值与探索进度

• 地图剩余价值已内置计算。
• 本模组会自己扫描当前关卡的贵重物品，统计当前地图剩余价值，并用本关观测到的最高物资总价值作为初始总价值。
• 地图剩余价值 会实时排除已经放到提取点的物品；购物车里和地图上尚未提取的物品仍会计入。
• 探索进度 会以地图初始总价值为 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.
• 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：每辆购物车的编号、是否为小购物车、距离、是否正在被推/拉/抓住、颜色和局内显示坐标；其中 IsBeingPushed 为当前绿色/黄色状态来源。
• WzcUiApi.MapValue / InitialMapValue / UnexploredMapValue / LostMapValue：地图剩余价值、初始价值、未探索价值、本局损失资金。
• WzcUiApi.CurrentRunSubmittedFunds / ShopRemainingFunds：本局提交资金和商店剩余资金。
• WzcUiApi.LevelNumber / LevelName：当前关卡编号和名称。
• WzcUiApi.AliveTeammates / DeadTeammates：队友名字、距离、死亡状态、本地玩家标记和颜色。
• WzcUiApi.TeammateAliveOverlayEnabled / TeammateDeadOverlayEnabled：存活/死亡好友局内标签是否开启。
• 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。