Stage Physics Events

English

Overview

Stage Physics Events applies Feather, Zero Gravity, or Boost to the entire stage at a configurable probability. Install it on the host to affect the whole session. Vanilla participants receive the effects without installing the mod; participants with the mod also receive the synchronized HUD.

Requirements

• BepInExPack 5.4.2305 or a later compatible version
• REPOConfig 1.2.6 or a later compatible version

Installation

Install with a compatible mod manager, or place StagePhysicsEvents.dll in the profile's BepInEx/plugins directory.

Multiplayer

• The host controls all event rolls, timing, targets, and effect activation.
• Vanilla participants receive the standard game effects without installing the mod.
• Participants with the mod receive the synchronized HUD and use their own local UI settings.
• Chat announcements use vanilla game chat and make every active player avatar speak.

Modes

Value	Description
RandomEachEvent	Rerolls the effect, duration, and interval for every event.
FixedForStage	Keeps the first selected effect, duration, and interval until the stage ends.
PersistentForStage	Keeps the selected effect active until the stage ends and refreshes it shortly before expiration.

Configuration

All settings are available through REPOConfig. Effect-related settings use the host's values. HUD layout settings are local to each modded player.

General

Key	Default	Range / Values	Description
Enabled	true	true, false	Enables the entire mod.
Mode	RandomEachEvent	RandomEachEvent, FixedForStage, PersistentForStage	Selects the event mode described above.
StageEffectChancePercent	20	0–100	Chance that effects are enabled for the stage. A failed roll disables effects and the HUD and sends no stage announcement.

Timing

Key	Default	Range	Description
IntervalMinSeconds	45	1–300	Minimum interval selected before the next event roll.
IntervalMaxSeconds	90	1–300	Maximum interval selected before the next event roll.
EffectDurationMinSeconds	15	1–300	Minimum selected effect duration.
EffectDurationMaxSeconds	30	1–300	Maximum selected effect duration.

If a minimum is greater than its maximum, the mod automatically uses the two values in ascending order without rewriting the config.

Feather

Key	Default	Range	Description
Enabled	true	true, false	Includes Feather in the event pool.
ChancePercent	30	0–100	Feather chance or weight.

Zero Gravity

Key	Default	Range	Description
Enabled	true	true, false	Includes Zero Gravity in the event pool.
ChancePercent	10	0–100	Zero Gravity chance or weight.

Boost

Boost applies Feather and Zero Gravity together. Its settings are independent of the individual Feather and Zero Gravity Enabled values.

Key	Default	Range	Description
Enabled	true	true, false	Includes Boost in the event pool.
ChancePercent	3	0–100	Boost chance or weight.

What floats

These target settings apply to Feather, Zero Gravity, and Boost.

Key	Default	Description
Valuables	true	Targets valuables.
Items	true	Targets general items, carts, and movable props.
Doors	false	Targets doors, lids, and other hinged movable objects.
Weapons	true	Targets weapons.
Players	true	Targets players.
Enemies	true	Targets enemies.

UI

Key	Default	Range / Values	Description
Enabled	true	true, false	Shows the synchronized event HUD on this client.
StageStartChatEnabled	true	true, false	Enables Effects, event-start, and End announcements. Host setting only.
Anchor	BottomRight	TopLeft, TopCenter, TopRight, MiddleLeft, MiddleCenter, MiddleRight, BottomLeft, BottomCenter, BottomRight	Selects the HUD anchor.
Alignment	Right	Left, Center, Right	Selects the HUD text alignment.
OffsetX	0	-3840–3840	Horizontal offset from the anchor in pixels.
OffsetY	0	-2160–2160	Vertical offset from the anchor in pixels.
ScalePercent	70	50–200	HUD scale percentage.

Probability rules

• StageEffectChancePercent is rolled once when the stage begins.
• In RandomEachEvent, enabled effect values totaling 100 or less are used as direct percentages; the remainder means no event for that interval.
• If enabled effect values total more than 100, their ratio is preserved and normalized to a total of 100.
• FixedForStage and PersistentForStage select one enabled effect by weight after the stage activation roll succeeds.
• Disabled effects and effects with a value of 0 are excluded.

Notifications and HUD

• Stage activation success: every active player avatar says Effects.
• Stage activation failure: no announcement.
• Random event start: every active player avatar says Feather, ZeroGravity, or Boost.
• Random event end: every active player avatar says End.
• During an event, the HUD shows the effect name and selected duration.
• While waiting, the HUD shows the selected interval.
• Persistent mode shows the effect name and Mode: Persistent.
• Remaining time and the next interval are not shown during an active event.

All in-game mod text and REPOConfig descriptions are in English.

Compatibility

• Real Feather Orbs added by DroneToOrbItem 4.0.0 remain valid stage-effect targets.
• This mod does not change their radius, battery, target settings, or item-specific behavior.
• Effect coverage is based on current stage objects and supports maps expanded by other mods.

---

日本語

概要

Stage Physics Eventsは、設定した確率でステージ全体にFeather、Zero Gravity、Boostのいずれかを適用するMODです。ホストが導入すればセッション全体に効果が適用されます。バニラ参加者にもMODなしで効果が適用され、MOD導入済みの参加者は同期されたHUDも利用できます。

必須MOD

• BepInExPack 5.4.2305以降の互換バージョン
• REPOConfig 1.2.6以降の互換バージョン

導入方法

対応するMODマネージャーから導入するか、StagePhysicsEvents.dllをプロファイルのBepInEx/pluginsフォルダーへ配置してください。

マルチプレイ

• 抽選、時間、対象、エフェクトの発動にはホスト側の設定を使用します。
• バニラ参加者にも、MODを導入せずにゲーム標準の効果が適用されます。
• MOD導入済みの参加者は同期HUDを利用でき、UIの配置には各自のローカル設定を使用します。
• チャット通知にはゲーム標準のチャット処理を使用し、有効な全プレイヤーのアバターに発言させます。

モード

設定値	内容
RandomEachEvent	イベントごとにエフェクト、効果時間、インターバルを再抽選します。
FixedForStage	最初に選ばれたエフェクト、効果時間、インターバルをステージ終了まで固定します。
PersistentForStage	選ばれたエフェクトをステージ終了まで維持し、効果が切れる少し前にかけ直します。

設定

すべての設定はREPOConfigから変更できます。エフェクト関連にはホスト側の設定を使用し、HUDの配置には各MOD導入者のローカル設定を使用します。

General

設定キー	デフォルト	範囲 / 設定値	内容
Enabled	true	true, false	MOD全体の有効・無効を切り替えます。
Mode	RandomEachEvent	RandomEachEvent, FixedForStage, PersistentForStage	上記のイベントモードを選択します。
StageEffectChancePercent	20	0–100	ステージでエフェクトを有効にする確率です。抽選に外れた場合はエフェクトとHUDを無効化し、ステージ開始通知も行いません。

Timing

設定キー	デフォルト	範囲	内容
IntervalMinSeconds	45	1–300	次のイベント抽選までのインターバル最小秒数です。
IntervalMaxSeconds	90	1–300	次のイベント抽選までのインターバル最大秒数です。
EffectDurationMinSeconds	15	1–300	エフェクトの最小適用秒数です。
EffectDurationMaxSeconds	30	1–300	エフェクトの最大適用秒数です。

最小値が最大値を超えている場合は設定を書き換えず、小さい値から大きい値までの範囲として処理します。

Feather

設定キー	デフォルト	範囲	内容
Enabled	true	true, false	Featherを抽選候補に含めます。
ChancePercent	30	0–100	Featherの発生確率または抽選ウェイトです。

Zero Gravity

設定キー	デフォルト	範囲	内容
Enabled	true	true, false	Zero Gravityを抽選候補に含めます。
ChancePercent	10	0–100	Zero Gravityの発生確率または抽選ウェイトです。

Boost

BoostはFeatherとZero Gravityを同時に適用します。Boostの設定は、個別のFeatherおよびZero GravityのEnabled設定から独立しています。

設定キー	デフォルト	範囲	内容
Enabled	true	true, false	Boostを抽選候補に含めます。
ChancePercent	3	0–100	Boostの発生確率または抽選ウェイトです。

What floats

次の対象設定はFeather、Zero Gravity、Boostのすべてに適用されます。

設定キー	デフォルト	内容
Valuables	true	貴重品を対象にします。
Items	true	一般アイテム、カート、移動可能な小物を対象にします。
Doors	false	扉、蓋、その他のヒンジで動くオブジェクトを対象にします。
Weapons	true	武器を対象にします。
Players	true	プレイヤーを対象にします。
Enemies	true	敵を対象にします。

UI

設定キー	デフォルト	範囲 / 設定値	内容
Enabled	true	true, false	このクライアントで同期イベントHUDを表示します。
StageStartChatEnabled	true	true, false	Effects、イベント開始、Endの通知を有効にします。ホスト側の設定のみ使用します。
Anchor	BottomRight	TopLeft, TopCenter, TopRight, MiddleLeft, MiddleCenter, MiddleRight, BottomLeft, BottomCenter, BottomRight	HUD位置の基準点を選択します。
Alignment	Right	Left, Center, Right	HUD文字列の配置を選択します。
OffsetX	0	-3840–3840	基準点からの横方向オフセットです。
OffsetY	0	-2160–2160	基準点からの縦方向オフセットです。
ScalePercent	70	50–200	HUDの表示倍率です。

確率の処理

• StageEffectChancePercentはステージ開始時に1回だけ抽選します。
• RandomEachEventでは、有効なエフェクトの設定値合計が100以下の場合、各値をそのまま確率として使用し、残りをそのインターバルの「エフェクトなし」とします。
• 有効なエフェクトの設定値合計が100を超える場合は、比率を維持したまま合計100になるよう正規化します。
• FixedForStageとPersistentForStageでは、ステージ有効化抽選の成功後、有効なエフェクトからウェイト抽選で1種類を選びます。
• 無効にしたエフェクトと設定値が0のエフェクトは抽選から除外します。

通知とHUD

• ステージ有効化抽選に成功：有効な全プレイヤーのアバターがEffectsと発言します。
• ステージ有効化抽選に失敗：通知しません。
• Randomイベント開始：有効な全プレイヤーのアバターがFeather、ZeroGravity、Boostのいずれかを発言します。
• Randomイベント終了：有効な全プレイヤーのアバターがEndと発言します。
• エフェクト中のHUDにはエフェクト名と選択された効果時間を表示します。
• 待機中のHUDには選択されたインターバルを表示します。
• Persistentモードではエフェクト名とMode: Persistentを表示します。
• エフェクト中は残り時間と次のインターバルを表示しません。

ゲーム内のMOD表示とREPOConfigの説明文はすべて英語です。

互換性

• DroneToOrbItem 4.0.0で追加される実物のFeather Orbも、ステージエフェクトの対象に含まれます。
• 実物のFeather Orbの効果範囲、バッテリー、対象設定、アイテム固有の動作は変更しません。
• 現在のステージ上に存在する対象を収集して適用するため、他MODで拡張されたマップにも対応します。