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.