沙罗格全景图 MMAP

【标题】
《MMAP》全景图资源模板 MOD 使用指南

【核心介绍】
提供可直接复用的全景图模板与配置示例，供模组制作者快速集成自定义全景图；本MOD本身不启用任何功能，仅为其他模组提供依赖资源与参考配置。

【安装指南】

1. 下载本MOD主文件（含 `content.json` 与 `panorama.json`）及配套「示例文件夹」；
2. 将主文件解压后放入游戏根目录 `/mods` 文件夹；
3. 必须将「MMAP」列为必需依赖，否则全景图无法加载；
4. 若需复用模板：将示例文件夹中的 `content.json` 和 `panorama.json` 复制到你自己的模组中，并按需修改——此MOD提供的PNG资源不可单独分发，必须通过依赖方式调用。

【功能详情】
✅ 已优化：

• 提供适配不同地图尺寸的全景图基础模板（含地平线、山体、太阳/月亮/云层三组动态参数）；
• 所有参数均通过 DynamicTokens 配置，支持运行时快速调试；
• 附带完整示例 `content.json` 与 `panorama.json`，开箱即用。
  ❌ 未修改：
• 不添加任何新全景图条目至 MMAP 系统；
• 不修改 MMAP 核心逻辑或渲染流程；
• 不提供独立游戏内效果（无玩家可见变更）。
  ✨ 额外调整：
• 内置三组预设参数组合，便于快速匹配不同比例地图；
• 支持通过简单查找替换“烘焙”配置，避免后期手动修改 `panorama.json`；
• 云层模块可安全删除（不影响其余功能）。

【使用要求】

• 必须已安装并启用「MMAP」模组（最低版本要求：v1.8+）；
• 仅适用于使用 MMAP 实现全景图的地图类模组；
• 游戏本体需为《巫师3》原版或「血与酒」扩展包（兼容两者）。

【兼容性说明】

• 兼容范围：所有基于「MMAP」v1.8 及以上版本开发的地图模组；
• 不兼容模组：无直接冲突，但若其他模组覆盖同一 `panorama.json` 路径或重写相同 DynamicTokens，则需手动协调；
• 兼容补丁：暂未推出。

【注意事项】

• 日落过渡效果非完全平滑，属视觉设计取舍，不影响功能使用；
• 修改参数后需退出并重新进入当前地图才能生效；
• 地平线/山体位置数值受纹理分辨率影响显著，建议优先测试目标地图常用缩放级别；
• 切勿直接分发本MOD中的PNG资源，应通过依赖声明调用；
• 若禁用浮动云层，可安全删除 `panorama.json` 中 `clouds` 相关代码块。

【更新日志】

• 2024 年 3 月 15 日 初始发布，含基础模板、三组预设参数及完整配置说明；
• 2024 年 4 月 2 日 补充云层移除指引与性能优化建议（推荐烘焙配置至 `panorama.json`）。