Advanced Radar Scanner / 高级雷达扫描器

Advanced Radar Scanner is an optional client-side Risk of Rain 2 mod. When any player uses the vanilla Radar Scanner, clients with this mod see redesigned icons for selected interactables. Players without the mod keep the vanilla icons and can join the same lobby.

高级雷达扫描器是一个可选客户端的《Risk of Rain 2》Mod。任意玩家使用原版雷达扫描器后，安装本 Mod 的客户端会为指定可交互物显示重新设计的图标。未安装的玩家仍显示原版图标，也可以加入同一个房间。

Features / 功能

• Keeps the vanilla Radar Scanner equipment, cooldown, scan radius, target selection, marker duration, and scan networking. / 保留原版雷达扫描器装备、冷却时间、扫描范围、目标选择、标记持续时间及扫描联网机制。
• Generates its icons locally at runtime; no AssetBundle is required. Custom icons use solid silhouettes with a fixed-opacity transparent black outer border and narrower outlines around cutouts. / 图标在本地运行时生成，无需 AssetBundle。新图标以实心轮廓为主，外缘采用固定透明度的黑色描边，镂空部分的描边较窄。
• Replaces only the seven marker types below; all other scanner icons stay vanilla. / 仅替换下表中的七类标记，其余雷达图标保持原版。
• Adds no items, equipment, or network prefabs. Optional network messages synchronize F ignore states only among clients using this mod. / 不新增物品、装备或网络预制体。可选网络消息仅在安装本 Mod 的客户端之间同步 F 忽略状态。
• Uses [NetworkCompatibility(CompatibilityLevel.NoNeedForSync)], so the host and other clients are not required to install the mod. / 使用 [NetworkCompatibility(CompatibilityLevel.NoNeedForSync)]，因此房主和其他客户端无需安装本 Mod 也能联机。

Redesigned icons / 重新设计的图标

F key: hide and restore / F 键：隐藏与恢复

• Aim at an interactable and press F to hide its current scanner marker immediately and keep it hidden in later scans; press F again to restore it. / 准星对准可交互物后按 F，可立即隐藏当前扫描标记，并在后续扫描中继续隐藏；再次按 F 可恢复。
• A scan still assigns the redesigned icon to a hidden target. If you restore it while that scan's marker is active, its correct icon appears immediately and keeps the remaining vanilla lifetime. / 扫描时即使目标已被隐藏，仍会预先替换成新图标；在本次扫描标记有效期间恢复，正确图标会立即出现，并沿用原版标记的剩余时间。
• A later scan can extend an active marker's lifetime. If the marker has already expired, pressing F only removes the ignore state; the next scan will mark the target again. / 后续扫描可以延长仍有效的标记时间。若标记已经过期，按 F 只会解除忽略状态，目标会在下次扫描时重新出现。

Multiplayer behavior / 联机行为

Sharing is enabled by default. The host coordinates ignore states for clients that also enable sharing; unmodded players receive no custom messages and keep vanilla markers. If the host does not have the mod or disables sharing, F works locally. Ignore states are cleared when the stage changes.

共享默认开启。房主为同样开启共享的客户端协调忽略状态；未安装本 Mod 的玩家不会收到自定义消息，仍显示原版标记。如果房主未安装本 Mod 或关闭共享，F 只在本地生效。换关时会清除忽略状态。

Each client reacts to the vanilla ChestRevealer.RevealedObject marker, regardless of which player activated the scanner. Hidden markers keep their vanilla countdown; restoring them changes only visibility.

每个客户端都会响应原版 ChestRevealer.RevealedObject 标记，无论由哪位玩家启动扫描。隐藏的标记仍按原版倒计时运行；恢复操作只改变其可见性。

Configuration / 配置

After the first launch, edit the following file. / 首次启动后，可编辑以下文件：

BepInEx/config/com.nolan.AdvancedRadarScanner.cfg

Installation / 安装

Install with r2modman or Thunderstore Mod Manager, or copy AdvancedRadarScanner.dll into the directory below. / 使用 r2modman 或 Thunderstore Mod Manager 安装，也可以将 AdvancedRadarScanner.dll 复制到以下目录：

BepInEx/plugins/AdvancedRadarScanner/

Required dependencies / 必需依赖：

• BepInExPack
• R2API Core

Building / 构建

Requires .NET 8 SDK or newer. Run the commands below from the repository root. / 需要 .NET 8 SDK 或更新版本。在仓库根目录运行以下命令：

dotnet restore AdvancedRadarScanner.sln
dotnet build AdvancedRadarScanner.sln -c Release
./build-package.sh

The release DLL targets .NET Standard 2.1 and currently compiles against RiskOfRain2.GameLibs 1.4.1-r.0. / 发布用 DLL 面向 .NET Standard 2.1，目前基于 RiskOfRain2.GameLibs 1.4.1-r.0 编译。

Compatibility notes / 兼容性说明

This mod changes existing scanner marker renderers while retaining the vanilla reveal lifecycle. A game update or another UI mod may change the marker prefab hierarchy or scanner lifecycle. Enable LogClassifications when diagnosing an icon that remains vanilla.

本 Mod 只修改现有雷达标记的渲染器，保留原版标记的显示生命周期。游戏更新或其他 UI Mod 可能改变标记预制体的层级或扫描流程；若某个图标仍显示为原版，可开启 LogClassifications 辅助排查。

Changelog

0.3.17

• Apply the custom scanner icon before hiding a newly revealed target. Restoring it with F during the same scan now shows the custom icon instead of the vanilla icon.

0.3.16

• Fixed F restoration by preserving each renderer's original enabled state during overlapping child and parent traversal. Removed the unnecessary manual RevealObject call; vanilla scans already refresh existing marker lifetimes.

0.3.15

• Attempted to re-enter restored targets through the vanilla RevealedObject.RevealObject path. This did not correct the renderer state issue and was superseded in 0.3.16.

0.3.14

• Restored an ignored marker immediately when it is re-enabled with F. It keeps the current Radar Scanner pulse expiry and disappears together with the other markers.

0.3.13

• Restored a re-enabled marker immediately after the next real Radar Scanner pulse, including when the previous scan's other markers are still active.

0.3.12

• Fixed restoration during an active scan by tracking the active marker hierarchy, allowing a restored target to participate in another scan before the original ten-second window ends.

0.3.11

• Fixed a follow-up scan issue after immediate hide-and-restore: local ignore state now changes synchronously instead of waiting for component destruction.

0.3.10

• Replaced the feathered marker outline with a single, fixed-opacity black border to match vanilla icon edges.

0.3.9

• Reduced the opacity of the wide marker outline and its outer feather to better match the softer vanilla chest border.

0.3.8

• Refined immediate marker recovery: only markers still active during the current scan reappear; restoring an ignored target outside a scan only affects future scans.

0.3.7

• Fixed the F toggle so active Radar Scanner markers hide or reappear immediately instead of waiting for the next scan.

0.3.6

• Doubled the exterior black border to a four-pixel core with a two-pixel transparent outer edge, while retaining slimmer outlines for enclosed cutout details.

0.3.5

• Thickened every custom marker outline to a two-pixel deep black border with a one-pixel transparent outer edge, matching the vanilla chest marker more closely.

0.3.4

• Added a two-pixel transparent black outline to every custom marker, including its inner cutouts, to match the contrast of vanilla Radar Scanner icons.

0.3.3

• Simplified the Item Scrapper marker into a solid machine body with hollow arrow and shredder details.
• Added a wireless Radar Scanner marker based on the approved signal-arc silhouette.
• Added a crescent-moon marker for Lunar interactables.

0.3.2

• Refined the Item Scrapper marker into a solid square machine body with a separated item cartridge and transparent cutout details.

0.3.1

• Redesigned every custom scanner marker with solid silhouettes and transparent cutout details to better match the vanilla marker style.

0.3.0

• Added opt-in, host-coordinated sharing for ignored Radar Scanner markers.
• The host now sends shared ignore state only to clients that have this mod enabled.
• Added late-join synchronization and automatic state reset at the start of each stage.

0.2.0

• Made the three-terminal Multishop icon solid.
• Added redesigned Equipment Barrel and unique Void Cradle icons.
• Added a configurable F shortcut to toggle local Radar Scanner visibility for the currently selected interactable.
• Preserved each vanilla marker's world-space size when replacing its sprite.

0.1.0

• Initial client-side release.
• Added runtime-generated scanner icons for Legendary Chests, Multishops, and Item Scrappers.
• Redesigned the Item Scrapper icon as an item entering a toothed shredding machine.
• All other Radar Scanner icons remain vanilla.
• Added optional-client multiplayer compatibility declaration.
• Added per-category configuration and diagnostic classification logging.