You are viewing a potentially older version of this package. View all versions.
HawChow-ItemMarkerProMax-1.1.0 icon

ItemMarkerProMax

上游 Hikaria ItemMarker 1.1.0 的忠实移植:物品与设施自动标记,只依赖 BepInEx,不做 ResourceHelper 兼容。

Date uploaded 4 days ago
Version 1.1.0
Download link HawChow-ItemMarkerProMax-1.1.0.zip
Downloads 65
Dependency string HawChow-ItemMarkerProMax-1.1.0

This mod requires the following mods to function

BepInEx-BepInExPack_GTFO-3.2.3 icon
BepInEx-BepInExPack_GTFO

BepInEx pack for GTFO. Preconfigured and includes Unity Base DLLs.

Preferred version: 3.2.3

README

ItemMarkerProMax 1.1.0

上游 Hikaria ItemMarker 1.1.0 的忠实移植:物品与设施自动标记,只依赖 BepInEx,不再做 ResourceHelper 兼容。

1.1.0(本次发布)。 代码体整体换成上游 Mamizu1028/GTFO_ItemMarker(模块 Hikaria.ItemMarker,版本 1.1.0,提交 5b14722)的移植版:17 个上游源文件一一对应、22 处补丁目标逐个对齐,只保留 BepInEx / Il2CppInterop 依赖,删除了此前自研的兼容层与判定逻辑。图标行为因此与上游使用同一套判定,可与上游逐文件对照。

反馈渠道:qingju.me | 开黑语音频道:小黑盒语音

功能

  • 只需要 BepInExPack_GTFO 3.2.3,不需要 TheArchive、Hikaria.Core、DropItem、GTFO-API 或任何其他 MOD 前置。
  • 已发现物品的原生标记:资源包与消耗品的剩余使用次数、任务物品、钥匙卡、终端、发电机、HSU、舱门控制器、消毒站与安全门需求提示。
  • 随包 9 张自定义图标;名称、颜色、显示距离、透明度等由 Settings/ItemInLevelMarkerDefinitions.json 定义。
  • 原生 Ping 覆盖、地图标记、检查点缓冲区各自独立;不创建私有网络协议,不改变资源生成、容量或拾取规则。

与上游的关系

  • 上游:https://github.com/Mamizu1028/GTFO_ItemMarker(作者 Hikaria / Mamizu1028)。
  • 本移植只替换框架层:TheArchive 的模块/特性/本地化/日志 → BepInEx;Hikaria.Core 的事件与协程 → 本插件自身实现。物品标记逻辑本身逐字保留。
  • 上游继承行为一并保留:例如用剩的资源包图标不会消失、标题可能显示剩余 0——这些是上游自身行为,本版不额外修正。
  • 不再与 ResourceHelper 协调图标:同机安装 ResourceHelper 时,双方各自绘制自己的标记。

未在本机验证的部分

  • 关卡内的实际标记行为(含“假资源”现场)与联机双向共享。
  • 详见仓库内 COMPATIBILITY-REPORT.md 与 VERIFICATION-PROTOCOL.md;本包只声明已通过构建、依赖审计、移植保真度与隔离无头启动验证。

安装

  1. 用 mod manager 安装,或手动把 BepInEx/plugins/ItemMarkerProMax/ 解压到游戏目录。
  2. 需要 BepInExPack_GTFO 3.2.3(本包已在 manifest 中声明为依赖)。
  3. 首次进关卡后,插件会在插件目录下生成 Assets/icons(已随包提供)。

CHANGELOG

更新日志

1.1.0 — 2026-10-16

  • 代码体整体换为上游 Hikaria ItemMarker 1.1.0 的忠实移植(上游提交 5b14722):17 个上游源文件一一对应,22 处补丁目标逐个对齐,除框架层外不保留任何自研逻辑。
  • 删除自研层:ResourceHelper 图标协调、旧版图标去重、容器空壳抑制、标记诊断日志、自研设置项、追赶式全场景补扫。
  • 本地化改为直读随包 JSON(内嵌于 DLL),不再依赖 TheArchive 本地化服务;日志改用 BepInEx ManualLogSource。
  • 物品标记判定回到上游同一套逻辑;上游继承行为(用剩的资源包图标不消失、标题可能显示剩余 0)一并保留。
  • 版本号与上游对齐为 1.1.0。
  • 验证:Release 构建 0 警告 0 错误;181 项自动化断言通过(依赖审计 DEP_AUDIT=PASS、补丁目标 PATCH_TARGETS=22/22 MATCH、本地化条目与上游一致、文件映射完整);隔离无头启动 0 错误行。
  • 未验证:关卡内标记行为、联机双向共享。

1.0.5 — 2026-10-15

  • 新增有上限的标记诊断日志(每次会话最多 30 行),用于定位「有图标但拿不到东西」的偶发现场。
  • 功能与 1.0.4 相同:容器内条目按游戏自身开关判定,空壳资源包不再当成资源,数量不再显示成 ×0。

1.0.4 — 2026-10-15

  • 修复「假资源」图标:容器内条目只在游戏本身允许拿取时才显示(Interact_Pickup_PickupItem.enabled)。
  • 空壳资源包(剩余量为 0)不再被当成资源标记;数量不再显示成 ×0。
  • 开箱揭示按归属与可用性筛选,容器开关状态改用游戏权威信号。

1.0.3 — 2026-10-15

  • 修复影子/假资源图标:忽略资源箱/资源柜 Ping 对邻近标记的错误归属。
  • 同步新版列表图标。

1.0.2 — 2026-10-15

  • 仅更新列表图标;功能、依赖与文件内容不变。

1.0.1 — 2026-10-14

  • 修复卡顿:移除周期性全场景补扫,改为进入关卡/检查点恢复后一次性补扫。
  • 修复卡顿:扫描器改回复用缓冲区的 SphereCastNonAlloc。
  • 修复卡顿:旧版图标探测改为缓存反射结果、按实例 ID 判定。

1.0.0 — 2026-10-14

  • 基于 Hikaria ItemMarker 改为独立 BepInEx IL2CPP 插件,名称 ItemMarkerProMax、GUID QingJu.ItemMarkerProMax。
  • 移除 TheArchive、Hikaria.Core、DropItem 等运行时依赖。