AlwaysMap / 常驻原版地图 — 1.1.0

A persistent, transparent, current-floor-only map HUD for R.E.P.O. using the game's map meshes and materials. Release version: 1.1.0. Version changes are made only at the author's request.

Features

• Vanilla map artwork without the handheld scanner casing; no need to hold TAB.
• Only your current floor: geometry, teammates, enemies, valuables, weapons and items. No floor selector or cross-floor markers.
• Transparent background with no black window. Map title/hints and symbol legend can each be hidden.
• Auto / English / 中文 configuration and HUD. Enemy names use the selected language, with Chinese fallback names for known vanilla enemies.
• Navigation follows the same target selection as vanilla MapBacktrack: the selected extraction point, then the truck once allExtractionPointsCompleted is true. NavMesh route line, distance and edge direction indicator. No invented extraction target before vanilla selects one.
• Draggable/resizable window, zoom, pan and saved settings.

Install

Use Thunderstore/r2modman, or import the ZIP as a local mod. Required dependency: BepInEx 5.

For manual installation, merge the archive's plugins folder into the game's BepInEx folder. The archive intentionally has no outer BepInEx folder. Installed DLL: BepInEx/plugins/AlwaysMap/AlwaysMap.dll. Replace the old DLL; do not leave duplicate copies.

REPOConfig is optional for an in-game settings menu. No MenuLib/REPOLib dependency is required by this mod itself. Only the viewing player needs the mod.

Controls

• F4: show/hide; F5: enter/exit edit mode (rebindable; existing custom bindings are preserved).
• In edit mode: left-drag window, right-drag to pan, scroll to zoom, drag cyan corner to resize.
• Reset restores pan/zoom. Follow toggles player center / map center.
• Save/Exit, F5 or Escape saves and leaves edit mode.
• Editing suppresses local gameplay controls but does not pause enemies or multiplayer.

Configuration

Generated file: BepInEx/config/com.yanyan.repo.alwaysmap.cfg. Edit while the game is closed, or use REPOConfig.

• Language / 语言: Auto / English / 中文.
• Show map hints / 显示地图提示: hide title, shortcuts, compass/zoom and mouse hints. Editing buttons remain available while editing.
• Show marker legend / 显示标记图例: independently hide the bottom symbol legend.
• Show weapons and items / 显示武器道具: spawned weapons, equipment, consumables and other world objects with ItemAttributes. Inactive inventory objects are not shown; active held items are shown.
• Show vanilla navigation / 显示原版导航: extraction/truck target and path, current floor only. A target on another floor is hidden as requested.
• Show own arrow / 显示自己箭头, Show players / 显示玩家 (teammates only), Show carts / 显示推车, enemies, valuables, weapons/items and navigation are independently switchable.
• Map refresh rate / 地图刷新频率: 2–30 FPS, default 10. Lower it to 5 for less background cost; marker drawing is independent.
• Map render resolution / 地图渲染分辨率: 128–512, default 256. Lower is cheaper, higher is clearer.
• Other options control entity labels, minimum value, position, size, zoom, follow and local room reveal.

Removed floor-offset and background-opacity settings are not used. Existing positions, shortcut bindings and other retained settings are preserved. Disabling local room reveal does not automatically hide undiscovered valuables or enemies; those have separate switches.

Symbols

Blue arrow: you and heading. Blue dots: teammates. Red dots: enemies. Yellow dots: valuables. White dots: weapons/items. Blue outlined squares: carts only. Each category has its own toggle, separate from labels. E selected extraction, T return to truck. Navigation route uses the game's NavMesh, not a straight-line claim that walls can be crossed. If no valid path exists, only the target/direction is shown.

Rendering / limitations

The mod renders isolated script-free MeshRenderer proxies with original shared meshes/materials. It does not activate, move or change the original map objects/cameras or exploration state. Native SpriteRenderer question marks are not copied. Scanner screen effects/post-processing are not reproduced pixel-for-pixel.

To make transparency independent of particle-material alpha, this build reads back the native map image, removes black and reconstructs alpha from RGB. Native map rendering defaults to 10 FPS / 256 pixels on the long side, configurable independently. Reducing 384 to 256 pixels processes approximately 56% fewer pixels per frame, but this is not a measured game-FPS improvement. CPU/GPU readback may cause performance cost; entity positions can update more smoothly than the map background. Dark map pixels become partly transparent by design. This trades some fidelity and performance for reliably removing the black rectangle without losing zero-alpha geometry.

Only loaded/synchronized objects can be shown. Items refresh about once per second. Dense labels can overlap. Unknown modded enemies may retain their original name if no localization is available. Live rendering, navigation, localization and multiplayer require in-game verification; compilation and ZIP validation alone do not establish visual correctness.

中文说明

本次功能

• 仅本层：地图、队友、怪物、贵重物品、武器道具都只显示自己当前楼层，删除上下层按钮及楼层偏移配置。
• 透明背景：不再显示黑色框底；“显示地图提示”和“显示标记图例”可分别关闭。编辑时仍保留必要按钮，退出后消失。
• 中文敌人名：模组语言为中文时优先读取游戏中文名称，已知原版怪物使用中文名回退；未知模组怪物可能保留原名。
• 原版导航目标：跟随游戏已选中的提取点；最后一个提取点提交且原版完成状态成立后，切换“返回卡车”。绘制 NavMesh 导航线、距离及窗口边缘方向提示。未选择提取点时不乱指任意提取点；目标在其他楼层时按仅本层要求隐藏。
• 武器道具：显示本层已生成、活跃的武器、装备和消耗品等。背包中已禁用的对象不显示，仍在场景中活跃的手持物可以显示。
• 图形标记：自己蓝色方向箭头、队友蓝点、怪物红点、财物黄点、武器道具白点、推车蓝色空心小方框；各类别与导航都有独立开关，文字标签另设开关。
• 动态门：门扇跟随真实世界门的角度与位置，脱落／断裂／销毁后隐藏门扇，保留静态门框。
• 中英配置、拖动、缩放、平移、调整大小及位置保存继续保留。

安装与操作

按作者要求，当前版本为 1.1.0；后续版本号不自行递增。压缩包无外层 BepInEx，仅含发布说明和 plugins/AlwaysMap/AlwaysMap.dll。管理器可导入本地包；手动安装将 plugins 合并进游戏的 BepInEx，替换旧 DLL，避免重复加载。配置不用删除。

默认 F4 显示/隐藏，F5 进入/退出编辑；已自定义的 F4/F5 等按键会保留。编辑时左键拖位置、右键平移、滚轮缩放、右下角青色方块改大小。保存/退出或 Esc 结束编辑。编辑不会暂停怪物与联机世界。

配置和性能说明

“语言”选择 Auto / English / 中文；“显示地图提示”关闭标题、快捷键、方位和缩放文字；“显示标记图例”关闭底部说明。实体名称由“显示标签”单独控制。武器道具与导航各有开关。旧楼层偏移和背景不透明度不再生效。

为了避免原版粒子材质 Alpha 为零导致底图消失，透明显示采用原生底图读回后按 RGB 重建 Alpha：黑色透明，暗色部分半透明。底图默认 10 FPS／最长边256像素，可在“地图刷新频率”和“地图渲染分辨率”调整；低配建议5 FPS／128或256像素。256相比384每帧像素量减少约56%，这不是实测游戏帧数提升比例。读回仍有性能成本，不是零开销；不保证扫描仪屏幕效果逐像素一致。只显示本机已加载和同步的实体；密集标签可能重叠。未知模组怪物翻译、实际透明显示、导航与联机效果仍需进游戏验收。