Ping Point Use Item

PEAK · Version 2.6.14

简体中文

模组简介

Ping Point Use Item 让你可以通过游戏原生的 Ping，在指定位置使用 PEAK 中的物品。

• 按住 Z，从轮盘中选择物品。
• 使用游戏原本的 Ping 按键，在成功 Ping 后生成物品或投掷飞盘。
• 每次成功 Ping 还可以生成一段原生音乐尾迹。
• 附近有符合条件的下落玩家时，Ping 可能优先触发云雾菇平台救援。
• 七种非飞盘物品可以分别使用 Cooking 或 Collision 模式。
• 使用模式默认为 Unlimited，也可以切换为 Limited。

安装

1. 先安装 BepInExPack_PEAK，必需版本为 BepInEx-BepInExPack_PEAK-5.4.75301。

2. 使用模组管理器安装，或将 PingPointUseItem.dll 放入：

   BepInEx/plugins/PingPointUseItem/
   

3. 如果是从旧版本升级，请先删除旧的 InstantCookExplosion.dll 及其配套的 PDB/deps 文件，不能同时加载新旧插件。

4. 启动游戏后，配置文件会生成在：

   BepInEx/config/rua.PingPointUseItem.cfg
   

SymbioticGhost 和 SenseOfDirection 是可选集成，不是必需依赖。

操作

1. 按住 Z，指向轮盘中的物品，然后松开 Z。
2. 瞄准目标表面，使用游戏原本的 Ping 按键。
3. 只有成功的原生 Ping 才会触发物品生成、飞盘投掷或救援。
4. 轮盘图标中央会显示剩余次数；无限模式显示 ∞ 或 INF。

插件使用游戏原本的 Ping 绑定、冷却和菜单限制，不会改变移动或跳跃操作。

八种物品

物品	默认模式	说明
Cure-All	Cooking	使用原有的烹饪效果
Dynamite	Cooking	使用原有的烹饪效果
AntiZooka	Cooking	使用原有的烹饪效果
Frisbee	Throw	向附近目标投掷，始终无限
PandorasBox	Cooking	使用原有的烹饪效果
曲迁菇 / WarpFungus	Collision	依靠原生碰撞或投掷行为
踏板菇	Collision	依靠原生碰撞或投掷行为
灵药菇	Collision	依靠原生碰撞或投掷行为

Cooking 和 Collision 只是两种触发方式。切换模式不会为原本没有该效果的物品添加新效果。

部分物品需要合适的目标、地形或原生组件；条件不满足时，本次使用可能不会触发。灵药菇 在 Collision 模式下可以被发射，但不保证产生治疗效果。曲迁菇 的 Collision 模式需要对地形 Ping。

飞盘

• 飞盘始终无限，不会因为手持它而被回收。
• 飞盘会在成功 Ping 点附近寻找目标。
• 合适的非玩家目标优先于玩家目标。
• 可尝试作用于地面物品、场景道具、生物和非玩家角色。
• 如果目标附近没有足够空间、路径被阻挡或目标不适合投掷，飞盘可能不会生成。
• 对箭陷阱的投掷遵循箭陷阱本身的方向和空间限制。

飞盘使用游戏原生的物理和网络行为，因此不同客户端看到的轨迹或碰撞结果可能略有不同。

音乐尾迹

启用后，每次成功 Ping 都可能在相机与 Ping 点之间生成原生音乐尾迹。

• 默认间距为 8 米。
• 一次尾迹最多生成 32 个音乐点。
• 音乐尾迹不会阻止物品生成或云雾菇平台救援。
• 音乐尾迹正在播放时，不会立即开始另一批尾迹。

云雾菇平台救援

云雾菇平台救援默认开启，并且优先于轮盘物品检查。

• 会寻找 Ping 点附近符合条件的真实玩家，包括自己。
• 目标需要处于未落地状态，并且周围有足够的空间放置平台。
• 成功后会使用原生云雾菇平台效果将目标移向安全位置。
• 救援使用一份 踏板菇 配额；Unlimited 模式不扣次数。
• 没有合适目标或救援失败时，通常会保留原本选择的物品行为。
• 救援不保证完全避免坠落伤害，也不会自动复活角色或清除所有倒地状态。

Limited 模式

Limited 模式下，七种非飞盘物品各有独立次数。

• 每种物品初始为 1 次。
• 成功创建物品后才会扣除次数。
• Cure-All 和 PandorasBox 被回收时，各自可返还 3 次。
• 其他有限物品被回收时返还 1 次。
• 每轮首次进入新的原版阶段时，七种有限物品各增加 1 次。
• 新的一轮会重置次数和阶段记录。
• 观战或幽灵自由飞行期间暂按无限使用处理，但不会清除已有次数。

常用配置

配置文件：BepInEx/config/rua.PingPointUseItem.cfg

设置	默认值	作用
General / Enabled	true	启用或关闭插件
General / Item	Cure-All	设置轮盘初始选择
General / Usage Mode	Unlimited	选择无限或有限使用
Trigger Modes / <Item>	见上表	为七种非飞盘物品选择 Cooking 或 Collision
Throw / Target Search Radius	5	飞盘搜索目标的范围
Throw / Speed	60	飞盘投掷速度
Throw / Lifetime Seconds	0.5	飞盘存活时间
Music Trail / Enabled	true	启用或关闭音乐尾迹
Music Trail / Spacing Meters	8	音乐点之间的间距
Music Trail / Effect Playback Seconds	3	音乐效果播放时间
Music Trail / Destroy Delay Seconds	0	音乐实例销毁前的额外延迟
Rescue / Enabled	true	启用或关闭云雾菇平台救援
Rescue / Target Search Radius	5	救援目标搜索范围
Rescue / Minimum Clearance Meters	5	平台所需的最低安全空间

已知限制

• 原生效果、物理和可用目标仍受 PEAK 当前版本影响。
• 某些空间狭窄、目标移动或路径受阻的情况下，生成或投掷可能被拒绝。
• 多人游戏中，不同客户端看到的物理轨迹、粒子效果和碰撞结果可能不完全一致。
• 混合安装环境、幽灵操作、视觉效果和多人同步仍需要实际游戏测试。

English

About

Ping Point Use Item lets you use PEAK items through the game's native Ping system.

• Hold Z to select an item from the wheel.
• Use the game's native Ping binding to spawn an item or throw a Frisbee after a successful Ping.
• A successful Ping can also create a native music trail.
• CloudFungus platform rescue may take priority when a nearby falling player qualifies.
• Seven non-Frisbee items can use either Cooking or Collision mode.
• Usage defaults to Unlimited, with an optional Limited mode.

Installation

1. Install BepInExPack_PEAK first. The required version is BepInEx-BepInExPack_PEAK-5.4.75301.

2. Install with a mod manager, or place PingPointUseItem.dll in:

   BepInEx/plugins/PingPointUseItem/
   

3. When upgrading, remove the old InstantCookExplosion.dll and its PDB/deps files before launching. Do not load old and new plugins together.

4. The configuration file is created after launch at:

   BepInEx/config/rua.PingPointUseItem.cfg
   

SymbioticGhost and SenseOfDirection are optional integrations, not required dependencies.

Controls

1. Hold Z, point at an item on the wheel, and release Z.
2. Aim at a surface and use the game's native Ping binding.
3. Items, Frisbees, and rescue only activate after a successful native Ping.
4. The wheel shows remaining uses in the center of each icon; Unlimited displays ∞ or INF.

The plugin keeps the game's native Ping binding, cooldown, and menu restrictions. It does not change movement or jump controls.

The Eight Items

Item	Default mode	Description
Cure-All	Cooking	Uses the original cooking behavior
Dynamite	Cooking	Uses the original cooking behavior
AntiZooka	Cooking	Uses the original cooking behavior
Frisbee	Throw	Throws toward a nearby target; always Unlimited
PandorasBox	Cooking	Uses the original cooking behavior
曲迁菇 / WarpFungus	Collision	Relies on native collision or throwing behavior
踏板菇	Collision	Relies on native collision or throwing behavior
灵药菇	Collision	Relies on native collision or throwing behavior

Cooking and Collision are two trigger modes. Changing modes does not add effects that are missing from the original item.

Some items require a suitable target, surface, or native component. The use may be rejected when those conditions are not met. 灵药菇 can be launched in Collision mode, but healing is not guaranteed. 曲迁菇 requires a terrain Ping in Collision mode.

Frisbee

• Frisbee is always Unlimited and is not reclaimed just because it is held.
• It searches for targets near the successful Ping point.
• Suitable non-player targets are preferred over player targets.
• It can attempt to target ground items, props, creatures, and non-player characters.
• The throw may be rejected when there is not enough space, the route is blocked, or the target is unsuitable.
• Throws toward ArrowShooter traps follow the trap's native direction and space limits.

Frisbee uses native physics and networking, so different clients may see slightly different trajectories or collision results.

Music Trail

When enabled, each successful Ping may create a native music trail between the camera and the Ping point.

• The default spacing is 8 meters.
• A single trail is limited to 32 music points.
• Music trails do not block item spawning or CloudFungus platform rescue.
• A new trail batch does not start while another batch is still active.

CloudFungus Platform Rescue

CloudFungus platform rescue is enabled by default and is checked before the selected wheel item.

• It searches for eligible real players near the Ping point, including yourself.
• The target must be airborne and have enough clear space for a platform.
• On success, the native CloudFungus platform behavior moves the target toward a safer position.
• Rescue uses one 踏板菇 quota; Unlimited mode does not consume a use.
• If no suitable target is found or rescue fails, the selected item normally keeps its original behavior.
• Rescue does not guarantee that all fall damage will be prevented, and it does not automatically revive a character or clear every downed state.

Limited Mode

In Limited mode, each of the seven non-Frisbee items has its own quota.

• Each item starts with 1 use.
• A use is consumed after the item is successfully created.
• Reclaiming Cure-All or PandorasBox returns 3 uses to its matching quota.
• Reclaiming another finite item returns 1 use.
• Entering a new original game stage for the first time in a run grants 1 use of each finite item.
• A new run resets uses and stage history.
• Spectating or Ghost free-fly temporarily acts as Unlimited without clearing existing quotas.

Common Configuration

Configuration file: BepInEx/config/rua.PingPointUseItem.cfg

Setting	Default	Purpose
General / Enabled	true	Enable or disable the plugin
General / Item	Cure-All	Set the initial wheel selection
General / Usage Mode	Unlimited	Choose Unlimited or Limited usage
Trigger Modes / <Item>	See above	Select Cooking or Collision for each non-Frisbee item
Throw / Target Search Radius	5	Search range for Frisbee targets
Throw / Speed	60	Frisbee throw speed
Throw / Lifetime Seconds	0.5	Frisbee lifetime
Music Trail / Enabled	true	Enable or disable music trails
Music Trail / Spacing Meters	8	Distance between music points
Music Trail / Effect Playback Seconds	3	Music effect playback time
Music Trail / Destroy Delay Seconds	0	Extra delay before music instances are destroyed
Rescue / Enabled	true	Enable or disable CloudFungus platform rescue
Rescue / Target Search Radius	5	Search range for rescue targets
Rescue / Minimum Clearance Meters	5	Minimum clear space required for a platform

Known Limitations

• Native effects, physics, and target availability depend on the current PEAK version.
• Spawning or throwing may be rejected in tight spaces, against moving targets, or when the route is blocked.
• In multiplayer, physics trajectories, particles, and collision results may not look identical on every client.
• Mixed-mod lobbies, Ghost controls, visual effects, and multiplayer synchronization still require in-game testing.