【原创SPT模组】破冰船 × 动态地图适配 DynamicMapsInIceBreaker v2.0.9

让 SPT 的 DynamicMaps 完整支持 Manimal 破冰船地图：14 层甲板高清图、22 个特殊门实时红绿状态、随高度自动切层、只对破冰船生效——附完整诊断日志，出问题一键定位。

玩过 SPT 的都知道 DynamicMaps，但它不认破冰船这张图。本模组把破冰船完整接入 DynamicMaps，并做了一系列针对性的适配：

• 14 层甲板图层（冰面 Deck -3 ～ 顶层 Deck 10），玩家爬楼、下舱时自动切换当前层

• 特殊门解锁显色逻辑（红 → 绿实时刷新）

• 玩家位置、地图朝向、缩放全部实测校准

模组内容

门变色的具体机制：

• 刷卡门：背包里有对应钥匙卡 → 绿（局内捡到卡/刷完卡立刻变，不用重开地图）

• 密码门：输对密码门打开 → 绿

• 炸药门：SZ-1 爆破后门被摧毁 → 检测到门消失 → 绿

• 冰封门：喷灯融冰完成 → 绿

诊断日志（排查问题用）

出问题时打开游戏根目录 BepInEx\LogOutput.log，搜索关键字 DynamicMapsInIceBreaker：

• 启动 / 补丁挂载 / PNG 加载 / 图层诊断 / 门监控 / 性能采样，每步都有日志

• 常见问题直接看日志定位：PNG 文件缺失、DynamicMaps 版本不匹配、门监控是否开启等

• [Perf] 30 秒性能采样：能看到门监控各步骤耗时

文件内容与结构

本文件含：

• DynamicMaps 文件夹下对 Icebreaker 地图的补丁（14 层高清 PNG 图 + 地图定义）

• plugins 文件夹下的功能补丁 DLL（DynamicMapsInIceBreaker.dll）

两者缺一不可。

复制

BepInEx\plugins\
├─ DynamicMapsInIceBreaker\DynamicMapsInIceBreaker.dll   插件本体
└─ DynamicMaps\Maps\Icebreaker\
   ├─ Icebreaker.jsonc             地图定义（14层+22门标记）
   └─ Layers\Icebreaker_L0~L13.png 每层高清图

安装

前置：

• DynamicMaps 本体 1.1.3+（4.0.13 最后版本）

• Manimal Icebreaker 破冰船 0.2.3 ~ 0.3.1（0.3.1 已实测兼容）

安装步骤：

1. 解压，把 BepInEx 文件夹合并进游戏根目录，覆盖同名文件

2. 【重要】删除游戏里旧版/残留的插件 DLL（防止加载到旧版或重复）：

• BepInEx\plugins\DynamicMapsInIceBreaker.dll（旧版根目录残留，删）

• BepInEx\plugins\DynamicMapsPngLayers.dll（更早的残留，删）

• BepInEx\plugins\IcebreakerMapTweaks.dll（更早的残留，删）

• 只保留 BepInEx\plugins\DynamicMapsInIceBreaker\DynamicMapsInIceBreaker.dll

3. 重启游戏

验证： 进破冰船按 M 开地图即可；BepInEx\LogOutput.log 应看到 ==== DynamicMapsInIceBreaker v2.0.9 ====。

常见问题

Q：为什么一些门显示在地图上的位置并不准确？

A：门的位置是从代码中读的，而图片显示是手动调的，难以严丝合缝，但实测不影响观感。

Q：会影响其他地图吗？

A：不会。所有补丁都只对破冰船（suburbs）生效，其他地图完全走 DynamicMaps 原生逻辑。

Q：进破冰船后感觉卡顿怎么办？

A：本模组只做地图 UI，不碰生成/扫描逻辑；破冰船本身的卡顿来自 Manimal 0.3.1 自身（机器人生成量大、进图扫描重、灯光特效全开）。可在 Manimal 的 cfg（com.manimal.icebreaker.cfg）里关 LensFlares、把 LampIntensity 调 0、VolFog 调 false。

版本记录

• v1.1.0：发布版。去掉密封门/轨迹记录/调试日志；门红绿实时检测；刷卡门局内即时刷新；炸药门爆破即绿；其他地图零影响。

• v2.0.9（当前）：纯地图适配 + 完整诊断日志的稳定版。修复 DynamicMaps 版本不匹配导致插件失效的问题（逐个补丁挂载，版本不同只警告跳过）；修复 0.3.1 超大场景下的门监控卡顿（扫描降频 5 倍，门状态仍实时读）；DLL 独立文件夹安装。