P.E.A.K_MENU

A lightweight in-game utility menu for PEAK, created by Ruangfafa.

The menu currently includes item spawning, player teleportation, coordinate-based flight, status controls, themes, category icons, configurable hotkeys, and a movable/resizable interface.

[!WARNING] This mod changes gameplay and may affect multiplayer sessions. Use it only in private or consenting lobbies.

Features

Item Spawner

• Browse available PEAK items
• Display native item icons
• Spawn selected items through PEAK's network flow
• Scrollable item list

Teleport

• Teleport yourself to another player
• Bring another player to your position
• Refresh player objects before every teleport action
• Prevent access to the teleport page when no other players are present
• Re-resolve the selected player before teleporting to reduce stale-object errors

Flight

• Coordinate-based flight using PEAK's warp RPC
• Optional double-tap Space activation mode
• Adjustable flight speed
• Default flight speed: 16
• Optional mouse-wheel speed control
• Mouse wheel changes speed by 5
• Optional slow-fall effect after flight synchronization
• Automatically enables and locks invincibility and anti-knockback while flight mode is enabled
• Restores the previous protection settings when flight mode is disabled

Status

• Invincibility
• Anti-knockback
• Infinite stamina
• Native PEAK status application
• Configurable status amount and duration
• Set or additive application modes
• Clear negative effects

Menu

• Movable window
• Resizable window
• Multiple color themes
• Category icons
• Configurable menu hotkey
• Input blocking while the menu is open

Default Controls

Installation

Mod Manager

Install the package using Thunderstore Mod Manager, r2modman, or Gale.

Required dependencies should be installed automatically through the Thunderstore package manifest.

Manual Installation

1. Install BepInExPack for PEAK.

2. Copy ruangfafa.peakmenu.dll into:

   PEAK/BepInEx/plugins/P.E.A.K_MENU/

3. Launch PEAK.

4. Press F6 to open the menu.

Development Setup

Create a copy of:

Config.Build.user.props.template

Rename it to:

Config.Build.user.props

Then configure the local PEAK installation path and BepInEx plugin output path.

This will:

• Resolve PEAK and Unity assembly references
• Copy the compiled plugin assembly to BepInEx/plugins/
• Simplify local testing after each build

Search for TODO across the project to find any remaining template-specific values that should be configured or replaced.

Building

Build the debug configuration:

dotnet build

Build the release configuration:

dotnet build -c Release -v d

The compiled plugin assembly is produced under:

./artifacts/bin/P.E.A.K_MENU/

Thunderstore Packaging & Publishing

This project uses ThunderPipe for Thunderstore packaging.

Build a local Thunderstore package with:

dotnet build -c Release -v d

The generated package will be placed under:

./artifacts/thunderstore/

[!NOTE] Review the generated package before publishing. Confirm that the manifest, icon, README, dependencies, version number, and plugin DLL are correct.

To publish directly to Thunderstore, configure the required publishing values in Config.Build.user.props, then run:

dotnet build -c Release -p:PublishTS=true -v d

[!TIP] Always inspect and test the local package in ./artifacts/thunderstore/ before using PublishTS=true.

Multiplayer Notes

Some features use PEAK network methods and RPC calls.

• Item spawning may affect the whole lobby
• Bringing another player may depend on network authority
• Flight sends repeated position synchronization RPCs while active
• Host permissions and game updates may affect behavior

Use the mod responsibly and only where all players agree.

Known Limitations

• PEAK updates may change internal classes, fields, methods, or RPC behavior
• Some status visual and audio effects depend on PEAK's internal implementation
• Flight smoothness may vary with latency and RPC rate
• Features that depend on network authority may behave differently for host and clients

Project Structure

src/P.E.A.K_MENU/
├─ Features/
│  ├─ Flight/
│  ├─ ItemSpawn/
│  ├─ Status/
│  └─ Teleport/
├─ Input/
├─ UI/
├─ Plugin.cs
└─ P.E.A.K_MENU.csproj

License

Add your chosen license before public release.

Credits

Created by Ruangfafa.

更新日志

本项目遵循语义化版本号：主版本.次版本.修订版本。

0.2.0

新增

• 新增吹箭效果替换功能
• 新增多种吹箭状态效果类型
• 新增吹箭获取按钮，可在游戏内直接获取吹箭
• 新增自我复活功能
• 吹箭效果可通过游戏状态 RPC 作用于其他玩家
• 吹箭页面增加多人模式房主使用提示

调整

• 吹箭效果强度改为百分制显示与输入
• 吹箭强度输入后自动生效，不再需要点击“确定”
• 优化飞行核心逻辑，减少异常移动和卡位问题
• 移除飞行菜单中不必要的复选框
• 优化防击退功能与攀爬动作之间的兼容性
• 完善吹箭效果类型与状态映射

修复

• 修复开启防击退后无法正常向上攀爬的问题
• 修复吹箭替换效果仍然触发原版睡眠的问题
• 修复直接修改其他玩家状态时被游戏拒绝的问题
• 修复吹箭效果在多人模式下无法正确同步的问题
• 修复部分飞行状态下可能出现的移动异常

0.1.1

新增

• 特殊状态支持点击“增加”“减少”“设为”“清零”后立即生效
• 特殊状态列表显示当前持有量
• 退出飞行后提供总计 5 秒缓降保护
• 关闭飞行总开关时同样触发退出飞行保护

调整

• 移除特殊状态的额外“应用状态”按钮
• 优化特殊状态操作流程
• 将退出飞行无重力时间调整为 1 秒
• 降低飞行坐标同步频率，减少低性能设备上的 RPC 压力
• 飞行同步在卡顿后不再补发历史请求
• 打开菜单时继续锁定飞行坐标
• 移除飞行过程中的实际位置自动纠偏
• 将“受伤 / 扣血”从特殊状态合集中移除
• 负重继续使用独立控制功能

修复

• 修复打开菜单时飞行角色可能下落的问题
• 修复低性能设备上飞行可能持续传送到地下的问题
• 修复退出飞行保护时间与提示文本不一致的问题
• 修复关闭飞行总开关后未触发缓降保护的问题
• 修复特殊状态需要先选择操作方式，再点击应用按钮的问题

0.1.0

首次公开版本。

新增

• 游戏内可移动、可缩放菜单
• 多种菜单主题
• 菜单分类图标
• 可配置菜单快捷键
• 物品浏览与生成
• 玩家传送与拉取
• 传送前强制刷新玩家对象
• 没有其他玩家时禁止进入传送页面
• 坐标式飞行
• 双击空格切换实际飞行
• 默认飞行速度 16
• 飞行中滚轮调速，每次增加或减少 5
• 可选五秒缓降效果
• 飞行期间自动锁定无敌与防击退
• 关闭飞行后恢复此前保护状态
• 无限体力
• 原生状态应用、清除与数值控制