RandomTeleportation

Random Teleportation (PEAK) 中文说明 | English Description

🇨🇳 中文说明 这是一个为《PEAK》设计的趣味功能增强插件。它会定期触发全服玩家的位置随机交换，并在交换前调用游戏原生的 10 秒倒计时动画。

⚠️ 核心要求 (重要) 必须主机（Host）和所有客机（Clients）同时安装此 Mod，功能才能正常运行！

主机：负责逻辑计算、倒计时广播和发起传送。

客机：负责接收信号并同步显示游戏原生的倒计时 UI。

如果不全员安装：客机将看不到倒计时，且可能导致位置同步失败。

⚙️ 配置文件说明 文件位置：BepInEx\config\com.peak.randomteleportation.cfg

IntervalMin: 自动交换的时间间隔（分钟）。

WarningSec: 交换前的预警倒计时（秒）。建议保持 10 以匹配原生 UI 动画。

ManualSwapKey: 房主手动强制触发交换的热键（默认 L）。

🛠️ 功能特性 原生 UI 同步：直接调用游戏内置 EndgameCounter，带缩放和淡入效果。

排除自身传送：采用错排算法，确保你绝对不会传送到自己原来的位置。

智能场景识别：在大厅 (Airport) 或主菜单时会自动静默，不会干扰组队邀请。

🇺🇸 English Description An enhancement plugin for PEAK that introduces a chaotic "Random Swap" mechanic. It periodically teleports all players to each other's locations, preceded by the game's native 10-second countdown animation.

⚠️ Requirement (IMPORTANT) Both the Host and ALL Clients must have this mod installed for it to function correctly!

Host: Handles logic, broadcasts the countdown, and executes the swap.

Clients: Receive network signals to display the native countdown UI.

If not everyone has it: Clients will not see the countdown, and position synchronization may fail.

⚙️ Configuration File Path: BepInEx\config\com.peak.randomteleportation.cfg

IntervalMin: The time interval between automatic swaps (in minutes).

WarningSec: The duration of the warning countdown (in seconds). Recommended value is 10 to match the native UI animation.

ManualSwapKey: The hotkey for the Host to manually trigger a swap (Default is L).

🛠️ Features Native UI Sync: Directly triggers the in-game EndgameCounter with full scaling and fading animations.

No Self-Teleport: Uses a derangement algorithm to ensure you never swap to your own current position.

Smart Scene Filtering: Automatically pauses in the Airport/Lobby or Main Menu to avoid interrupting the party-up process.

📦 Installation Install r2modman.

Search for Random Teleportation and click "Install".

Ensure your teammates do the same.