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

Setting	Default	Notes
Language	Auto	Both mods: follow game / English / 中文; applies immediately
Alert Threshold	0.5	Desync % above which the host gets an on-screen alert; below it is still logged
Panel Key	F8	Tap to toggle, hold 1 s for details
Quick Toggle: Lightmap Baking	follows TR	Reads/writes TerrainRandomiser's baking switch directly
ViewID Alignment Fix	Off	Host switch; clients with this mod follow
Per-Spawner RNG Isolation	Off	Everyone must have this mod; host-authoritative
TrueFinalAscent Coexistence Fixes	On	Leftover-flag cleanup and switch restore. Stepping aside in a Final Ascent run is always on
Client Scene Reload Guard	On	Client only. Stops a slow client from being pulled back to the airport and reloading the island at run start
Built-in Storm Shelter	On	Raycast shelter when the room has baking off
Storm Shelter Ray Distance	16 m	Game metres (same as campfires), 4.8–48 m

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

选项	默认	说明
语言	Auto	两个模组一起跟随游戏 / 强制 English / 强制中文，即时生效
播报阈值	0.5	不同步率超过此百分比才在主机屏幕提示，低于仍写日志
面板按键	F8	短按开关，长按 1 秒看详情
快捷开关：光照烘焙	跟随 TR	直接读写地形随机器的烘焙开关
ViewID 对齐修复	关	主机开即可，装了本模组的客机自动跟随
逐 Spawner 随机流隔离	关	需全员安装本模组，以主机为准
TrueFinalAscent 共存修复	开	残留标记清理与开关还原；最终天阶局的避让始终生效
客机开局场景重载守卫	开	只管本机客机，防慢客机开局被拉回机场、把岛重载多次
内置风暴遮蔽射线兜底	开	房间烘焙关闭时用射线判断遮蔽
风暴遮蔽射线距离	16 米	游戏米（与营火一致），可调 4.8～48 米

日志

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

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

反馈 Bug 或建议：QQ 群 1104320838。