【模组问题交流 QQ 群：824639225】

模组问题交流、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 辅助模组，重点强化队友位置、敌人位置、购物车位置、怪物统计、地图价值、提交资金、Tab 官方地图缩放和中文配置体验。

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

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

可选推荐插件

• Tansinator-Map_Value_Tracker：推荐安装，但不是必须安装。安装后 WZC UI 会自动读取它统计的地图价值，并启用地图价值、探索进度等显示；不安装时，队友/敌人/购物车距离、怪物统计、Tab 地图缩放、资金显示等其他功能仍然可以正常使用。
• 本模组没有把 Map_Value_Tracker 写进 Thunderstore 强制依赖，避免用户只想使用距离显示或地图缩放时被强制安装额外插件。

推荐亮点

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

1.0.4 更新重点

• 配置分类更像正常工具：好友、敌人、购物车、Tab 地图、右下角怪物统计、右下角价值统计、右下角好友信息都提供独立“启用”总开关。
• 右下角信息重新整理为 C1.右下角基础设置、C2.右下角怪物统计、C3.右下角价值统计、C4.右下角好友信息，游戏里找配置更直观。
• 价值统计拆成多个独立开关：探索进度、地图价值、本局提交资金、商店剩余资金可以分开控制。
• 好友/敌人/购物车局内显示的配置顺序重新排过，字体大小、远处字体变小、显示方式、刷新间隔、按键和靠近自动显示都更好找。
• 右下角好友信息更紧凑：死亡队友和存活队友连续显示，不再插入空行，看起来更像同一个好友分区。

搜索关键词 / 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, Map_Value_Tracker, Tansinator, optional dependency, soft dependency, lost value, exploration progress, submitted funds, shop remaining funds, run haul, Tab map zoom, vanilla map zoom, official map zoom, mouse wheel map zoom, scroll wheel map zoom, minimap zoom, Chinese UI, Chinese config, English UI, REPOConfig, config manager, section toggle, category toggle, enable switch, per-section toggle, BepInEx, 模组接口, 公共接口, 可选插件, 软依赖, 地图价值插件, 队友距离, 好友距离, 玩家距离, 队友标记, 敌人距离, 怪物距离, 购物车距离, 购物车标记, 购物车显示, 怪物显示, 怪物数量, 怪物统计, 地图价值, 损失价值, 探索进度, 提交/商店资金, 商店剩余资金, 本局提交资金, Tab地图缩放, 官方地图缩放, 鼠标滚轮缩放地图, 中文配置, 中英切换, 配置分区, 分区总开关, 分类启用, 分区启用, 功能开关, 中文HUD, 中文UI.

中文功能介绍

右下角信息显示

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

队友距离显示

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

敌人距离显示

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

购物车距离显示

• 可在购物车模型附近显示编号和距离，例如：🛒 购物车1 12m、🛒 小购物车1 8m。
• 大购物车和小购物车可以分别开关显示，并且会分开排序编号。
• 编号会绑定到当前关卡内对应的购物车对象，已经分配好的购物车名称不会因为移动或排序刷新而变化。
• 购物车默认黄色显示；如果检测到有人正在推、拉或抓住购物车，会变成绿色。
• 购物车有独立的字体大小、显示高度、刷新间隔和远处衰减设置，默认显示在购物车模型底部。
• 搬大件、分头搜刮、回收战利品时更方便，不用满地图找“刚才那辆车去哪了”。

Tab 官方地图鼠标滚轮缩放

• 打开游戏原版 Tab 地图后，可以直接用鼠标滚轮缩放地图。
• 向上滚轮放大地图细节，向下滚轮缩小地图范围。
• 可配置默认缩放倍率、最小缩放倍率、最大缩放倍率和滚轮缩放速度。
• 可开启“每次打开地图强制恢复官方状态”，每次重新打开地图都会先恢复官方默认地图状态，再应用默认缩放，减少地图多次缩放后的偏移问题。
• 主要缩放原版地图内容，尽量兼容人物、装备和其他地图标记模组。
• 如果想一次看到更多房间，优先调低“最小缩放倍率”；如果想放大看细节，调高“最大缩放倍率”。
• 对看不清路线、想确认房间结构、想快速判断撤离路线的玩家会舒服很多。

地图价值与探索进度

• 地图价值建议配合 Tansinator-Map_Value_Tracker 使用。
• 安装 Map_Value_Tracker 后，本模组会读取它统计的地图价值并整合到右下角显示。
• 地图价值 只显示当前地图剩余价值。
• 探索进度 会以地图初始总价值为 100%，把已经放到提取点和购物车里的物资都算作已探索，只把仍散落在地图上的物资算作未探索。
• 损失价值 会统计本局中摔坏或丢失造成的价值损失。
• 探索进度、地图价值、本局提交资金、商店剩余资金都有独立显示开关，想精简右下角时可以只留下自己需要的行。
• 未安装 Map_Value_Tracker 或版本不兼容时，会显示提示，地图价值相关功能暂不生效。

中英显示与配置

• 默认中文显示。
• 可在配置第一项切换 English。
• 英文模式会切换右下角字段名、玩家状态、关卡名和怪物名称。
• 配置项尽量使用中文，方便在 REPOConfig 或 BepInEx 配置管理器里调整。
• 提供模组总开关，关闭后右下角显示、队友/敌人距离、Tab 地图缩放和实验功能全部停用。
• A0 语言设置下的全局总开关叫“模组启用”，关闭后整个模组都不生效。
• 每个主要功能分类顶部都有“启用”总开关；比如只想保留 Tab 地图缩放，可以关闭右下角显示、好友显示、敌人显示或购物车显示。
• 实验功能分类默认关闭，避免新用户一安装就改变物品旋转手感。

实验功能

• 可选开启物品旋转方向和灵敏度调整。
• 默认关闭，避免影响原版手感。

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, monster counters, map value, lost value, exploration progress, submitted funds, shop remaining funds, and mouse wheel zoom for the vanilla Tab map.

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.
• Vanilla Tab map mouse wheel zoom with default zoom, min zoom, max zoom, scroll speed, and optional reset-to-vanilla-on-open.
• Chinese by default, with an English display option.
• Master toggle to disable the entire mod.
• Per-section enable toggles for teammate labels, enemy labels, cart labels, Tab map zoom, monster stats, value stats, and teammate info.
• Split value display toggles for exploration progress, map value, submitted funds, and shop remaining funds.
• Optional experimental held-item rotation controls.

Tab Map Zoom Details

When the vanilla Tab map is open, use the mouse wheel to zoom the map in and out. The mod can reset the map to the vanilla state each time it opens, then apply your configured default zoom. This is useful if repeated zooming causes the map to drift or if other map marker mods are also installed.

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.
• 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.

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

WZC UI 提供公开静态接口 WzcUiApi，其他模组可以引用 wzcui.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：当前显示配置，例如字体大小、刷新间隔、右下角偏移、队友/敌人显示距离、Tab 地图缩放设置等。

示例：

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

English: other mods can reference wzcui.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, and current display settings.

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

• Map_Value_Tracker: 地图总价值显示参考了这个模组的统计思路；当本地安装了 Map_Value_Tracker 时，WZC UI 会通过反射读取它的 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、距离显示或输入调整插件也修改同类对象，可能会出现显示位置、地图缩放或输入冲突。
• 首次使用建议先在单人或私人房间测试配置。
• 如有问题请加 QQ 群：824639225。