Stage Physics Events

English

Overview

Stage Physics Events adds configurable, random stage-wide events to R.E.P.O. Depending on the host's settings, one or more effects can activate at the same time: Battery, Feather, Heal, Indestructible, Roll, Void, and Zero Gravity.

Only the host needs the mod for gameplay effects. Players without the mod are still affected and receive chat announcements. Players who also install the mod can use the synchronized HUD.

Gameplay warnings

• Roll can move enemies violently and may kill them.
• Void can kill players.
• Roll and Void are disabled by default. Enable them only when these risks are acceptable.

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's settings control event selection, timing, targets, and chat announcements.
• Other players do not need the mod to receive gameplay effects.
• Modded participants receive the synchronized HUD and can configure their own HUD layout.
• Singleplayer uses the same event behavior as hosting a multiplayer session.

Event modes

Event selection

• StageEffectChancePercent is rolled once when a stage begins. A failed roll disables effects, the HUD, and the stage-start announcement for that stage.
• Every enabled effect's ChancePercent is rolled independently. The probabilities are not added or normalized, so a total above 100% is valid.
• MaxSimultaneousEffects limits how many successful effects can activate together. If the limit is exceeded, the active effects are selected randomly from the successful rolls.
• In RandomEachEvent, a roll with no successful effect simply skips that event.
• In FixedForStage, FixedPerExtraction, and PersistentForStage, a stage whose initial effect roll selects nothing remains inactive for that stage.
• In FixedPerExtraction, an empty reroll after an extraction produces no further effects until another extraction changes the selection.

Configuration

All settings are available through REPOConfig. Gameplay settings use the host's values. HUD layout settings are local to each player who has the mod installed.

General

Timing

All timing values are whole seconds. If a minimum is greater than its maximum, the values are treated as an ascending range without rewriting the config.

Feather

Makes applicable targets lighter for the duration of the event.

Zero Gravity

Applies zero gravity to applicable targets.

Battery

Restores charge to applicable battery-powered items at a configurable amount and interval.

Heal

Restores health to applicable players at a configurable amount and interval.

Indestructible

Temporarily protects applicable physical targets from damage.

Roll

Moves and tumbles applicable targets. Players can move toward their viewing direction, while other targets move in random directions.

Warning: Roll may kill enemies through movement and collisions.

Void

Creates multiple Void effects at random locations across the stage. The effects disappear when the event ends.

Warning: Void may kill players.

Valuable protection

Zero Gravity, Roll, and Void temporarily protect valuables from effect-related damage. Each effect's IndestructibleReleaseDelaySeconds controls how long that protection remains after the effect ends. When multiple protections overlap, valuables remain protected until the latest delay ends.

What floats

These filters control which target categories receive applicable effects. Battery only affects battery-powered items, Heal only affects players, and Void creates stage locations rather than directly selecting target categories.

UI

Notifications and HUD

• When stage events are enabled, active player avatars announce Effects at the start of the stage.
• Before an event starts, player avatars announce the selected effect names. When countdowns are enabled, the names are followed by 5 through 0, and the effects begin at 0.
• Before a non-persistent event ends, player avatars announce 3, 2, 1, and then End.
• The HUD appears only during an active stage. It shows the active effects and selected duration, or the interval while waiting.
• All in-game MOD text is in English.

Compatibility

• Compatible with DroneToOrbItem. Orb items added by that MOD keep their normal item behavior and can still be affected by stage events.
• Players revived during an event receive applicable active effects.
• Newly created physical objects can receive applicable active effects.
• Target coverage follows current stage objects, including stages expanded by other MODs.

日本語

概要

Stage Physics Eventsは、R.E.P.O.のステージ全体にランダムなイベントを発生させるMODです。ホストの設定に応じて、Battery、Feather、Heal、Indestructible、Roll、Void、Zero Gravityのうち1つまたは複数のエフェクトが同時に発生します。

ゲームプレイ上の効果はホストが導入すれば利用できます。MOD未導入の参加者にも効果とチャット通知が適用されます。MOD導入済みの参加者は同期HUDも利用できます。

ゲームプレイ上の注意

• Rollにより敵が激しく移動し、死亡する可能性があります。
• Voidによりプレイヤーが死亡する可能性があります。
• RollとVoidはデフォルトで無効です。これらのリスクを許容できる場合のみ有効にしてください。

必須MOD

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

導入方法

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

マルチプレイ

• イベントの抽選、時間、対象、チャット通知にはホスト側の設定を使用します。
• 参加者側はMOD未導入でもゲームプレイ上の効果を受けます。
• MOD導入済みの参加者は同期HUDを利用でき、HUDの表示位置は各自で設定できます。
• シングルプレイでもマルチプレイのホストと同じイベント処理を使用します。

イベントモード

イベント抽選

• StageEffectChancePercentはステージ開始時に1回だけ抽選します。抽選に外れたステージでは、エフェクト、HUD、ステージ開始通知を無効にします。
• 有効な各エフェクトのChancePercentを個別に抽選します。確率は合算・正規化しないため、合計が100%を超えても有効です。
• MaxSimultaneousEffectsで、同時に発生できるエフェクト数を制限します。上限を超えた場合は、当選したエフェクトからランダムに選択します。
• RandomEachEventでは、1つも当選しなかった回のイベントをスキップします。
• FixedForStage、FixedPerExtraction、PersistentForStageでは、初回のエフェクト抽選で1つも当選しなかった場合、そのステージではエフェクトとHUDを無効にします。
• FixedPerExtractionで納品後の再抽選が1つも当選しなかった場合、次の納品で再抽選されるまでエフェクトは発生しません。

設定

すべての設定はREPOConfigから変更できます。ゲームプレイ設定にはホスト側の値を使用し、HUDの表示設定はMOD導入済みの各プレイヤーが個別に使用します。

General

Timing

時間設定はすべて整数秒です。最小値が最大値を超えている場合は、設定を書き換えず小さい値から大きい値までの範囲として使用します。

Feather

適用可能な対象をイベント中軽量化します。

Zero Gravity

適用可能な対象を無重力化します。

Battery

適用可能なバッテリー式アイテムの充電量を、設定した量と間隔で回復します。

Heal

適用可能なプレイヤーの体力を、設定した量と間隔で回復します。

Indestructible

適用可能な物理対象を一時的に破壊されない状態にします。

Roll

適用可能な対象を移動・回転させます。プレイヤーは目線方向へ移動でき、その他の対象はランダムな方向へ移動します。

注意： Rollの移動や衝突により、敵が死亡する可能性があります。

Void

ステージ上のランダムな場所に複数のVoidエフェクトを生成します。生成したエフェクトはイベント終了時に消失します。

注意： Voidによりプレイヤーが死亡する可能性があります。

貴重品の保護

Zero Gravity、Roll、Voidによる破損を抑えるため、貴重品を一時的に保護します。各エフェクトのIndestructibleReleaseDelaySecondsで、エフェクト終了後に保護を維持する秒数を設定します。複数の保護が重なった場合は、最も遅い解除時点まで保護を維持します。

What floats

各設定で、適用可能なエフェクトを受ける対象カテゴリを選択します。Batteryはバッテリー式アイテム、Healはプレイヤーだけを対象とし、Voidは対象カテゴリを直接選択せずステージ上にエフェクトを生成します。

UI

通知とHUD

• ステージイベントが有効な場合、ステージ開始時に有効なプレイヤーのアバターがEffectsと発言します。
• イベント開始前に、プレイヤーのアバターが選択されたエフェクト名を発言します。カウントダウン有効時は続けて5から0まで発言し、0でエフェクトが始まります。
• Persistent以外のイベント終了前に、プレイヤーのアバターが3、2、1、Endと発言します。
• HUDはステージ中だけ表示します。エフェクト中はエフェクト名と効果時間、待機中はインターバルを表示します。
• ゲーム内のMOD文字列はすべて英語です。

互換性

• DroneToOrbItemと併用できます。DroneToOrbItemが追加するオーブアイテムは通常のアイテム動作を維持し、ステージエフェクトの対象にもなります。
• イベント中に復活したプレイヤーにも、適用可能な発動中エフェクトを適用します。
• イベント中に新しく生成された物理オブジェクトも、適用可能な発動中エフェクトの対象になります。
• 現在のステージ上にある対象を使用するため、他MODで拡張されたステージにも対応します。