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.4.0

调整

• 飞行功能整体回滚至 0.3.4 的控制与施力逻辑，同时保留 0.4.0 的其他功能
• 浮空重力校准默认值调整为 255
• 高级校准改为 -9、-3、-1、+1、+3、+9 六个步进按钮
• 删除飞行速度的手动输入与确定区域，保留快捷调速
• 新增“水平平移”和“随视角飞行”两个互斥按钮，可即时切换 WASD 移动方式
• 飞行滚轮调速步长由 ±5 调整为 ±16

新增

• 新增吹箭页面，图标直接使用游戏内吹箭物品图标
• 可从下拉框选择无效果（使用原版）、受伤、饥饿、中毒、寒冷、炎热、困倦、诅咒、孢子、石化和小旋风
• 数值状态支持即时输入 1–200 的百分制赋予值；小旋风支持即时输入持续秒数
• 自定义效果仅影响安装者自己发射的吹箭，未安装玩家无需房主也可正常接收兼容效果

修复

• 飞行移动力改为按布娃娃部位质量分配，减少四肢碰撞和摆动造成的航向偏移
• 提高飞行作用力安全上限，使速度 255 时按住 Shift 仍能获得完整加速

0.3.5

新增

• Mod 版本更新后在游戏界面中央显示内嵌更新日志，支持“确认”按钮或 Esc 关闭，并记录已确认版本
• 新增调试配置 Debug.ShowChangelogOnEveryLaunch，开启后每次启动游戏都会显示更新日志和当前版本公告
• 新增按版本配置的更新公告弹窗，支持延时关闭、历史公告保留和公告内快捷操作按钮

调整

• 物品生成器的列数切换说明移至按钮旁，按钮内仅显示当前列数，避免文字超出按钮范围
• 物品管理列表新增轻微的交替行底色与整行悬停高亮，便于对应物品图标和操作按钮
• 物品管理的上下移动按钮改为三横杠拖拽排序；支持滚动列表中的精确插入、边缘自动滚动，并可将下方物品直接拖入已显示列表
• 按新的物品分类与使用顺序调整物品生成器默认列表，共包含 127 个候选物品
• 飞行的 WASD 移动改为始终保持水平，高度仅由空格和 Ctrl 控制
• 浮空重力校准默认值由 380 调整为 237，并在 Mod 版本更新时自动恢复一次默认值

修复

• 修复飞行速度在约 80 以上提前达到作用力上限，导致设置为 255 时没有明显变快的问题
• 水平飞行力按布娃娃部位质量分配，减少四肢摆动对水平轨迹的影响，同时保持原有悬停和升降手感

0.3.4

修复

• 修复实际飞行期间无法同时启用防击退的问题；飞行现在会保持正常移动与霸体保护

0.3.3

新增

• 新增折叠式浮空重力校准，可微调向下补偿力并恢复默认值 380

调整

• 飞行速度的调整范围改为 16–255
• Mod 版本更新后自动将窗口大小与物品生成器列数恢复为默认值

修复

• 修复进入关卡后本地玩家可能出现在传送目标列表、导致能够传送自己的问题
• 修复由玩家同步的童子军队长、蕈尸等非玩家角色可能被误识别为传送目标的问题
• 传送页面在没有其他玩家时仍可进入，并在页面内提示等待其他玩家加入

0.3.2

新增

• 物品生成器新增“生成上一个物品”快捷键，可在页面中编辑，默认不绑定

0.3.1

新增

• 物品生成主列表新增列数切换按钮，支持左键增加、右键减少，在 1 至 9 列之间循环切换并保存设置，默认为 4 列

调整

• 默认窗口尺寸调整为 850 × 850
• 飞行悬停向下补偿力由 223 调整为 225
• 扩充物品生成器的默认显示物品列表

修复

• 修复菜单打开后鼠标光标持续闪烁的问题

0.3.0

新增

• 为飞行与状态页面的功能操作新增可配置快捷键，未指定的项目默认不绑定
• 飞行速度提高与降低支持重绑输入，默认分别使用滚轮向上与滚轮向下
• 飞行总开关下新增双击空格控制子项，默认开启

调整

• 移除吹箭相关功能、菜单入口与资源
• 移除菜单窗口 1100 × 850 的固定最大尺寸限制，窗口可扩展至当前屏幕边界
• 默认窗口尺寸调整为 760 × 850
• 物品管理页面改为弹性布局，“已显示物品”和“添加物品”区域按 50% / 50% 随窗口伸缩
• 移除物品管理添加列表最多显示 100 项的数量限制
• 飞行总开关改为待机开关，仅在进入实际飞行时开启无敌，退出时恢复此前状态
• 退出飞行保护改为单段 2 秒缓降，移除前 1 秒完全无重力效果
• 退出飞行缓降阶段的最大下落速度由 -2.25 调整为 -6
• 通过双击空格进入实际飞行时，将飞行速度重置为默认值 16

修复

• 修复物品管理弹性布局中的列表内容越界问题

0.2.0

新增

• 新增自我复活功能

调整

• 优化飞行核心逻辑，减少异常移动和卡位问题
• 移除飞行菜单中不必要的复选框
• 优化防击退功能与攀爬动作之间的兼容性

修复

• 修复开启防击退后无法正常向上攀爬的问题
• 修复直接修改其他玩家状态时被游戏拒绝的问题
• 修复部分飞行状态下可能出现的移动异常

0.1.1

新增

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

调整

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

修复

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

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

0.1.0

首次公开版本。

新增

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