RandomTerrainEnhance

1.0.20 — PEAK 3.0.0: registered Kiln campfires are protected only during segment item cleanup; generation, seeds and ViewID allocation stay unchanged. / 仅保护切段清理中的已登记 Kiln 篝火，不改生成规则、种子或 ViewID 分配。

English

Multiplayer sync fixes for TerrainRandomiser in PEAK, plus clean coexistence with TrueFinalAscent. F8 UI Shows you whether everyone generated the same map, and keeps one small difference from scrambling the whole island.

This mod is built by AI (opus, 6.1sol) and goes through repeated testing and verification before release to keep it reliable. If an unexpected issue still slips through, I'm sorry — come nudge me on [email protected] 😕

Why you need it

TerrainRandomiser only sends the seed: every PC rebuilds the island on its own. When one PC uses one more or one fewer random number at a single spot (a physics ray hits on one PC and misses on another), every later spawn shifts. Then you get mushrooms and luggage in different places, Winterberries that turn into snowballs when picked up, and statues or chests only the host can use.

Features

• See desyncs: after generation, every player sends a fingerprint of their map to the host. Mismatches appear in the host's top-left corner and in everyone's log. Press F8 for the room panel (versions, baking, sync state); hold F8 for 1 second to see exactly what differs and where it first diverged.
• Per-spawner RNG isolation (off by default, everyone needs this mod): each spawner gets its own random stream, so a difference stays local instead of cascading across the map.
• ViewID alignment (off by default, host switch): fixes Winterberries turning into snowballs, statues and chests only the host can use, and misaligned items. Does not change generation.
• Lightmap baking follows the host: clients automatically use the host's baking setting, so nobody has to be reminded.
• Fair storm shelter without baking: with baking off, Alpine and Roots storms judge shelter with upwind raycasts against terrain, so hiding behind rock blocks the cold, the push and the climbing penalty. Stands aside for An0n Fair Storms if installed.
• Plays nice with other mods: steps aside during a TrueFinalAscent Final Ascent run and cleans up its leftover room flags; stays out of TerrainCustomiser custom-map runs (those are handled by TerrainCustomiser (Fix), panel F11); falls back to the vanilla map for PeakLevelSelect alternate levels instead of crashing.

All targets are soft dependencies. With none installed, the mod idles quietly.

This mod cannot guarantee a 100% identical map: spawn positions come from each PC's own physics. What it does is shrink "the whole island is different" down to "a few spots differ", and tell you exactly where.

Language

One setting controls both TerrainRandomiser and this mod: General 通用 / Language = Auto (default), English, or 中文. Auto follows the game's language: Simplified or Traditional Chinese uses the existing Simplified Chinese translation; all other languages use English. Changing the setting or the game language refreshes the F8 panel and the randomiser menu immediately.

TerrainRandomiser translation is built in from 1.0.18. Remove the old standalone TerrainRandomiser_ZH when updating; if it remains installed, this mod hands its translation patches over to the integrated system. No extra translation DLL is needed. Language changes only affect display text, not seeds or dropdown values.

Recommended settings

Host: turn on ViewID Alignment. Leave everything else at default.

Turn on RNG Isolation only after confirming everyone has this mod. The host's setting is authoritative. If anyone joins without the mod, the host turns it off for the whole room and names who is missing. A client never turns either option on by itself.

Before playing together, make sure everyone has the same TerrainRandomiser version and the same generation-affecting mods. Different versions always generate different maps. The F8 panel marks outdated versions in red.

Installation & Settings

1. Install BepInExPack_PEAK.
2. Place the RandomTerrainEnhance folder (with RandomTerrainEnhance.dll) in BepInEx/plugins/, then launch the game.
3. Press F8 in game — if the panel appears, it's installed. Adjust settings in your in-game mod settings.

Config: BepInEx/config/com.anthony.randomterrainenhance.cfg

Logs

• Desync details: BepInEx/config/随机地形增强/sync_report_<date>.log (everyone with the mod gets one).
• Runtime log: BepInEx/LogOutput.log, search for 地形增强.

If RNG Isolation or ViewID Alignment causes trouble, the host turns it off and the room follows. Send both logs with any report.

Feedback & bug reports: [email protected]

中文

为 PEAK 的「地形随机器 TerrainRandomiser」提供联机同步修复，并与 TrueFinalAscent 和平共存。F8ui面板直观查看模组配置和队友同步情况。

模组由AI(opus,6.1sol)制作，发布前会多次测试校验，来确保其可靠性。如果还是有意料外的问题我很抱歉，可以到 QQ 群：1104320838 来鞭策我😕

为什么需要

地形随机器联机时主机只发种子，每台电脑各自按种子重建一遍岛。只要某台机器在某个点多用或少用一次随机数（比如同一条射线一边命中一边没中），后面所有生成物都会整体错位：踏板菇、行李箱位置不同，捡黄雪梅变成雪球，远古雕像和宝箱只有主机能碰。

功能

• **看得见不同步：**生成完后每人把自己的地图指纹发给主机比对，有差异时主机左上角提示，并写进每个人的日志。按 F8 打开房间面板（版本、烘焙、同步状态）；长按 F8 一秒查看具体哪里不同、第一处分叉在哪。
• 逐生成器随机流隔离（默认关，需全员安装）：每个生成器用独立随机流，一处差异只坏一处，不再雪崩到整张图。
• ViewID 对齐修复（默认关，主机开即可）：修好「捡黄雪梅变雪球」「雕像、宝箱只有主机能碰」「物品错位」。不改变生成结果。
• **光照烘焙自动跟随主机：**客机自动使用主机的烘焙设置，不用挨个提醒。
• **不烘焙也有公平的风暴遮蔽：**烘焙关闭时，雪山与树根风暴改用上风射线判断地形遮挡，躲在岩石后就不掉寒冷、不被吹、没有攀爬惩罚。装了 An0n Fair Storms 时让位给它。
• **兼容其他模组：**TrueFinalAscent 的最终天阶局自动避让，并清掉它遗留的房间标记；地形定制器自定义图的局整局不介入（由「地形定制器修复版」负责，面板按 F11）；PeakLevelSelect 选中备选关卡时改走原版地图，不再报错掉天上。

增强对象全部是软依赖，一个都没装也不报错，静默待机。

本模组做不到保证 100% 一致：生成位置来自每台电脑各自的物理计算。它做的是把「整张图都不一样」压成「局部几处不一样」，并且准确告诉你在哪。

语言

一个配置同时控制地形随机器和增强模组：General 通用 / Language，可选 Auto（默认）、English、中文。Auto 跟随游戏语言：简中、繁中都启用现有简体中文译文，其他语言显示英文。修改此配置或游戏语言后，F8 面板与随机地形菜单即时刷新。

推荐用法

主机打开「ViewID 对齐修复」，其他保持默认。

**确认全员都装了本模组后，再由主机打开「随机流隔离」。**以主机设置为准；有人没装就进房时，主机会整房关闭并点名是谁。客机永远不会自己打开这两项。

**联机前先确认所有人的地形随机器版本一致、影响生成的模组一致。**版本不同必定不同步，F8 面板会把落后的版本标红。

安装与设置

1. 安装 BepInExPack_PEAK。
2. 将 RandomTerrainEnhance 文件夹（含 RandomTerrainEnhance.dll）放入 BepInEx/plugins/，然后启动游戏。
3. 进游戏按 F8 看到面板即安装成功；在游戏内模组设置中调整选项。

配置文件：BepInEx/config/com.anthony.randomterrainenhance.cfg

日志

• 不同步明细：BepInEx/config/随机地形增强/sync_report_日期时间.log（房里每个装了本模组的人都有一份）。
• 运行日志：BepInEx/LogOutput.log，搜索「地形增强」。

开了随机流隔离或 ViewID 对齐后出现异常，主机关掉即可，全房自动跟随。反馈时请附上以上两份日志。

反馈 Bug 或建议：QQ 群 1104320838。

RandomTerrainEnhance Changelog / 随机地形增强更新日志

v1.0.20

English

• Multiplayer consistency: Optional per-spawner random-stream isolation and network object ID alignment improve terrain and item consistency between players. Both options are host-controlled, disabled by default, and require all players to install this mod.
• Map loading and item interaction: Preserves random-map settings across reloads and correctly synchronizes maps generated before the host creates a room. Restores object ID mappings after reloads, fixing related campfire, chest, statue, and berry interaction issues. Clears stale network-object records when leaving a scene.
• Scene-loading protection: Prevents clients from being pulled back to the airport or repeatedly loading the same island during startup, resolving related missing-player and missing-item issues.
• Host-authoritative terrain: Clears stale random-map settings and follows the host’s terrain selection. Randomization is restricted to the standard island, preserving normal loading for alternate levels selected through PeakLevelSelect.
• TrueFinalAscent compatibility: Cleans up stale Final Ascent room data, restores TerrainRandomiser settings when appropriate, and stands aside during active Final Ascent runs.
• TerrainCustomiser compatibility: Automatically stands aside during custom-map and editor sessions, leaving generation, synchronization, scene protection, and storm shelter to TerrainCustomiser (Fix). The F8 panel directs custom-map players to its F11 monitor.
• Lighting and storm shelter: Synchronizes lightmap baking with the host and provides an F8 quick toggle. With baking disabled, built-in three-ray shelter detection protects against snow and wind storms, including behind low rocks and beneath overhangs. Shelter correctly clears wind force and climbing-stamina penalties. Detection range defaults to 16 in-game metres and is adjustable from 4.8 to 48 metres. Automatically coordinates with An0n Fair Storms and supported terrain mods.
• Kiln campfire protection: Protects registered Kiln campfires during segment item cleanup. Protection follows the current generated map and survives host migration. Compatible with TerrainCustomiserFix 1.0.5.
• F8 monitoring panel: Shows player mod versions, generation-check results, host settings, effective local settings, terrain source, and complete seeds. Highlights missing or outdated installations and setting differences. Tap F8 to toggle the panel; hold it for details.
• Integrated English/Chinese support: One language setting controls both TerrainRandomiser and the enhancement panel, with changes applied immediately. Auto follows the game language: Simplified and Traditional Chinese use Simplified Chinese text; other languages use English. Includes reversible menu translation, preserves existing settings, and takes over legacy TerrainRandomiser_ZH translation patches.
• Packaging and documentation: Includes a mod icon and bilingual documentation updated for PEAK v2.6.b. TerrainRandomiser remains optional, and the enhancement panel is available independently.

中文

• **联机一致性：**提供可选的逐生成点随机流隔离与联网物品编号对齐，改善玩家之间的地形和物品一致性。两项功能均由房主控制、默认关闭，需全房安装本模组。
• **地图加载与物品交互：**同局重载时保留随机地图设置，正确同步房主在开房前生成的地图。重载后恢复物品编号对应关系，修复相关的篝火、箱子、雕像和莓果交互问题；离开场景时清理失效的联网物品记录。
• **开局场景保护：**防止客机开局被拉回机场或重复加载同一座岛，修复由此造成的玩家、出生点物品消失等问题。
• **跟随房主选择地形：**清理残留的随机地图设置，按房主选择加载地图。随机生成仅作用于标准岛屿，兼容 PeakLevelSelect 选择的备选关卡。
• **TrueFinalAscent 兼容：**清理过期的最终天阶房间数据，按当前对局恢复地形随机器设置；正式进入最终天阶时自动让位。
• **地形定制器兼容：**自定义地图和编辑器会话中自动让位，由地形定制器修复版负责生成、同步、场景保护和风暴遮蔽。F8 面板会引导玩家查看其 F11 监控面板。
• **光照与风暴遮蔽：**全房光照烘焙跟随房主，支持通过 F8 快捷切换。关闭烘焙时，内置三方向射线检测雪山和树根风暴中的掩体，支持矮石和岩檐遮蔽，并正确解除躲入掩体后的风力与攀爬耐力惩罚。检测距离默认 16 游戏米，可调范围为 4.8～48 米；自动协调 An0n Fair Storms 及相关地形模组。
• **Kiln 篝火保护：**切段清理物品时保护已登记的 Kiln 篝火。保护随当前已生成地图生效，房主交接后继续保留，并兼容 TerrainCustomiserFix 1.0.5。
• **F8 监控面板：**显示玩家模组版本、生成校验结果、房主设置、本机生效设置、地形来源及完整种子，突出提示未安装、版本落后和设置差异。短按 F8 开关面板，长按查看详情。
• **内置中英文支持：**一个语言选项统一控制地形随机器菜单和增强面板，修改即时生效。Auto 跟随游戏语言：简体和繁体中文均显示简体译文，其他语言显示英文。支持菜单中英文切换、保留已有设置，并自动接管旧版 TerrainRandomiser_ZH 汉化补丁。
• **发布与文档：**提供模组图标和更新至 PEAK v2.6.b 的中英双语文档。地形随机器为可选依赖，增强面板可独立使用。