海报扩展

TLDR
【海报尺寸调整】
【自由放置】
【图层模式 / 海报堆叠】
【核心介绍】
让海报自由缩放、精准堆叠、持久记忆——移动时实时调整大小，按轴微调图层，所有设置自动保存并加载，对齐更直观、操作更稳定。
【安装指南】
1. 必备前置：本 MOD 安装前，需同步安装 「BepInEx 5.x」（Windows 版）；
2. Vortex / 模组管理器安装：
• 为游戏安装并启用 「BepInEx 5」；
• 添加并启用本 MOD（文件名：「A2K.PosterScaler.dll」）；
3. 手动安装：
• 将 「A2K.PosterScaler.dll」 放入游戏根目录 `/BepInEx/plugins/A2K.PosterScaler/`；
• 首次启动游戏以生成配置文件 `/BepInEx/config/A2K.PosterScaler.cfg`；
• 缺一不可：「BepInEx 5」必须已正确部署，否则 MOD 无法加载。
【功能详情】
✅ 已优化：
• 移动海报时实时缩放（X/Z 键，支持点击步进与按住连续）；
• 图层模式（L 键激活，沿海报旋转轴固定步长微调，专为堆叠设计）；
• 绿色/透明预览（始终高亮“有效区域”，可强制覆盖为绿色）；
• 重叠辅助（可选）：移动中临时设碰撞体为触发器，便于紧密排列；
• 粘性持久化：每个海报的大小与图层自动保存至 `/BepInEx/config/A2K.PosterScaler.scales.txt`，并在下次加载或放置时重新应用；
• 调试工具：切换 HUD 覆盖、转储尺寸摘要、清除孤立保存项。
❌ 未修改：
• 游戏原生移动/放置逻辑；
• 海报纹理、材质或渲染管线；
• 其他模组的碰撞体永久状态（仅移动中临时变更）。
✨ 额外调整：
• 保存机制升级：从旧版「兄弟顺序（…N）」改为「父路径+量化本地位置（如 …|@-12,0,47）」，增删邻近海报不影响已有数据；
• 紧急掉落：快捷键立即烘焙当前大小/图层并退出操作状态；
• 放置后二次确认：海报“稳定”后自动重校图层，确保最终位置固定。
【使用要求】
• 必需：「BepInEx 5.x」（Windows）；
• 兼容游戏：任意使用 `InteractableDecoration` 的 Unity 游戏（如《深海迷航》《Valheim》等支持交互海报的版本）；
• 无需额外扩展包或特定图形驱动。
【兼容性说明】
• 兼容范围：所有基于 `InteractableDecoration` 实现海报交互的 Unity 游戏；
• 不兼容模组：无硬冲突，但若其他 MOD 在放置瞬间直接修改 `transform.position` 或父级结构，可能短暂干扰图层重校（建议将本 MOD 加载顺序置于同类调整模组之后）；
• 兼容补丁：暂未推出（本 MOD 采用幂等设计，已内置轻量协同逻辑）。
【注意事项】
• 移除海报后尺寸跳变？→ 删除 `/BepInEx/config/A2K.PosterScaler.scales.txt` 一次，启用新版位置绑定；
• 预览不显绿色/无轮廓？→ 启用配置项 `ForceGreenVisual` 和/或 `ShowHud`；
• 按键无响应？→ 检查是否被其他 MOD 占用，默认键位可在 `/BepInEx/config/A2K.PosterScaler.cfg` 中自定义；
• 因碰撞无法放置？→ 开启配置项 `AllowOverlapDuringMove`，移动时自动启用触发模式；
• 「紧急掉落」默认关闭，如需启用请在配置中绑定快捷键。
【更新日志】
• 2024 年 X 月 X 日 新增位置稳定保存机制（父路径+量化坐标），彻底解决增删海报导致尺寸错配问题；
• 2024 年 X 月 X 日 增加「紧急掉落」快捷键、「转储尺寸」与「清除孤儿」调试功能（默认未绑定）；
• 2024 年 X 月 X 日 优化图层重校时机，在海报稳定后二次确认，提升堆叠可靠性。
【控制键（默认 • 全部可配置）】
所有按键均位于 `/BepInEx/config/A2K.PosterScaler.cfg` 中：
• 放大：`X`（点击 = 步进，按住 = 连续）；
• 缩小：`Z`（点击 = 步进，按住 = 连续）；
• 加速：按住 `Shift`（可配置）配合 X/Z；
• 重置大小：你的重置键（设 X=1, Y=1）；
• 切换图层模式：`L`（轴自动匹配海报旋转方向）；
• 图层上移/下移：你的图层键（图层模式或移动中均生效）；
• 紧急掉落：可选键（默认关闭）；
• 调试覆盖：通过配置项 `ShowDebugOverlay` 开关。
【卸载指南】
1. 删除 `/BepInEx/plugins/A2K.PosterScaler/` 文件夹；
2. （可选）清理残留：
• 配置文件：`/BepInEx/config/A2K.PosterScaler.cfg`；
• 保存数据：`/BepInEx/config/A2K.PosterScaler.scales.txt`。
【配置说明】
生成于 `/BepInEx/config/A2K.PosterScaler.cfg`，常用选项：
• `Enabled`：主开关；
• `ShowHud` / `ShowDebugOverlay`：控制 UI 覆盖显示；
• `AllowOverlapDuringMove`：移动时启用触发碰撞（推荐开启以利堆叠）；
• `Dump Scales`：记录当前所有海报尺寸摘要至日志；
• `Purge Orphans`：删除 `scales.txt` 中当前场景不存在的条目；
• 切换新版？清空 `/BepInEx/config/A2K.PosterScaler.scales.txt` 即可获得干净初始状态。
【故障排除】
• 移除海报后尺寸跳变 → 更新至本版并删除 `scales.txt`；
• 预览非绿色 / 无轮廓 → 启用 `ForceGreenVisual` 和 `ShowHud`；
• 按键无响应 → 检查键位占用，修改 cfg 后重启游戏；
• 因碰撞无法放置 → 开启 `AllowOverlapDuringMove`。
【常见问题】
问： 本 MOD 会永久把海报碰撞体设为触发器吗？
答： 不会。仅在你主动移动海报时临时设为触发器，放置完成即恢复原状。
问： 图层模式会干扰游戏原生放置系统吗？
答： 不会。图层键仅在移动中微调姿态；放置后，本 MOD 仅在稳定阶段单次重应用并二次确认，不持续干预。
问： 能保留旧版 `scales.txt` 数据吗？
答： 技术上可保留，但旧版基于「兄弟顺序」，易错配。强烈建议首次升级时删除 `/BepInEx/config/A2K.PosterScaler.scales.txt`，启用新版稳定绑定。
【已知问题】
• 若其他 MOD 在运行时动态更改海报父级链（如重组层级），量化键中的父尾部分可能变化；
• 海报被拖出常规移动范围（> 数个单位）时，其量化坐标可能被识别为新物品，导致尺寸/图层未继承。
【授权与致谢】
• 作者：Addison2k（A2K）；
• 授权：开源免费，禁止闭源分发；
• 资源：本 MOD 不包含任何外部纹理、模型或音频资源。