You are viewing a potentially older version of this package. View all versions.
REPO_JP-PerfectExtractionBonus-4.0.0 icon

PerfectExtractionBonus

【Host Only MOD】Grants a bonus after all initial valuables are extracted and spawns money bag effects.レベル開始時点の全貴重品納品後にボーナスとお金袋エフェクトを追加します

By REPO_JP
Date uploaded a week ago
Version 4.0.0
Download link REPO_JP-PerfectExtractionBonus-4.0.0.zip
Downloads 2251
Dependency string REPO_JP-PerfectExtractionBonus-4.0.0

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100

README

COMPATIBLE WITH COSMETICS UPDATE V0.4.0.

PerfectExtractionBonus

This mod is a host-only mod that grants a configurable cash bonus when every valuable that existed at level start is successfully extracted.

After perfect extraction is confirmed, the mod can also spawn 9999-dollar money bag effects inside the truck until the level changes. These money bags are treated as an effect and corrected so they do not directly inflate the extraction goal or duplicate the actual bonus reward.

Features

  • Tracks the initial valuable set after LevelGenerator.GenerateDone
  • Grants a bonus only when all initial valuables are delivered
  • Supports streak-based bonus scaling
  • Supports an extra no-loss bonus when all initial valuables are delivered without value loss
  • Sends optional public chat messages for perfect extraction and remaining valuable count
  • Shows optional UI text when the bonus is granted
  • Spawns configurable money bag effects after perfect extraction is confirmed
  • Stops and cleans up the money bag effect on level change
  • Runs only on the host or in singleplayer

Host Only

Only the host or singleplayer instance needs this mod. Participants do not need to install it for the bonus calculation.

The money bag effect is spawned by the host. Because this uses in-game network spawning, participants may see the spawned money bags depending on the game sync state, but the mod logic itself is host-side.

Important behavior

The bonus is based on the current run currency at the moment the level completion result is processed. The regular bonus and no-loss bonus are calculated separately, then added to the run currency.

The money bag effect starts only after perfect extraction has already been confirmed. It is not the source of the bonus reward.

Configuration

Section Setting Description Default Min Max
General ModEnabled Enables or disables the mod true - -
Bonus BaseBonusPercent Base bonus percent granted for perfect extraction 10 0 100
Bonus EnableStreakBonus Enables additional bonus percent for consecutive perfect extractions true - -
Bonus StreakAddPercent Additional bonus percent added for each consecutive perfect clear after the first 5 0 100
Bonus MaxBonusPercent Maximum total percent for the regular perfect extraction bonus 50 0 100
Bonus NoLossExtraBonusPercent Extra percent granted when all initial valuables are delivered without value loss 10 0 100
Streak ResetStreakOnNonPerfectClear Resets the streak when the level is cleared without perfect extraction true - -
Streak ResetStreakOnLevelFail Resets the streak when the level fails true - -
UI ShowBonusUI Shows UI text when the bonus is granted true - -
Tracking InitialSnapshotDelaySeconds Delay after LevelGenerator.GenerateDone before stable initial valuable detection begins 0.75 0 10
Tracking SnapshotStableFrames Number of stable frames required before the initial valuable set is locked 20 1 600
Effect EnableMoneyBagEffect Enables money bag spawning after perfect extraction is confirmed true - -
Effect MoneyBagEffectValue Dollar value displayed on each effect money bag 9999 1 999999
Effect MaxAliveMoneyBagEffects Maximum number of effect money bags kept alive before old ones are removed 120 3 300
Debug LogEnabled Enables detailed debug logs true - -
Chat PerfectBonusPublicChatMessage Public forced chat message for a regular perfect extraction bonus. 〇〇k$ is replaced with the bonus amount Perfect Extraction Bonus 〇〇k$ - -
Chat NoLossPerfectBonusPublicChatMessage Public forced chat message for a no-loss perfect extraction bonus. 〇〇k$ is replaced with the bonus amount Wow!!! Super No-loss Perfect Extraction Bonus 〇〇k$ - -
Chat AnnounceRemainingCountInPublicChat Forces public chat with the remaining undelivered initial valuable count after each successful delivery false - -
Chat RemainingCountPublicChatMessage Public chat message for remaining count. Supports {remaining}, {delivered}, {initial} {remaining} valuables left - -

Notes for mod developers

The mod does not rely on scene-load monitoring for main gameplay logic. Initial valuable tracking starts after LevelGenerator.GenerateDone, which avoids running gameplay logic during region selection, main menu, lobby, shop, or arena states.

Delivery tracking patches the extraction point haul destruction flow and records only valuables that were part of the initial level snapshot. This avoids counting later spawned valuables, including the money bag effect objects.

※Mod created by AI

COSMETICS UPDATE V0.4.0対応済み.

PerfectExtractionBonus

REPOが好きな日本人のための日本人のみのREPOのDiscordサーバーあります! 参加は以下のリンクから! https://discord.gg/h5ATY4m5bZ

このMODは、ホスト専用の、レベル開始時点に存在していた全貴重品をすべて納品した場合に設定可能な現金ボーナスを付与するMODです。

完全納品が確定した後、レベルが切り替わるまでトラック内に9999ドルのお金袋エフェクトを生成することもできます。 このお金袋は演出として扱われ、納品目標金額を直接増やしたり、実際のボーナス報酬を二重加算したりしないように補正されます。

機能

  • LevelGenerator.GenerateDone 後に初期貴重品一覧を追跡
  • 初期貴重品をすべて納品した場合のみボーナス付与
  • 連続完全納品によるボーナス倍率に対応
  • 初期貴重品を価値減少なしで納品した場合の追加ボーナスに対応
  • 完全納品時や残り未納品数の公開チャット送信に対応
  • ボーナス付与時のUI表示に対応
  • 完全納品確定後のお金袋エフェクト生成に対応
  • レベル変更時にお金袋エフェクトを停止および削除
  • ホストまたはシングルプレイでのみ動作

ホスト専用

このMODはホストまたはシングルプレイ環境だけに導入すれば動作します。 参加者はボーナス計算のために導入する必要はありません。

お金袋エフェクトはホスト側で生成されます。 ゲーム内のネットワーク生成を使用するため、同期状態によっては参加者にもお金袋が見える場合がありますが、MODの処理自体はホスト側のみで実行されます。

重要な動作

ボーナスは、レベルクリア結果が処理される時点のラン通貨を基準に計算されます。 通常ボーナスと無減額ボーナスは別々に計算され、その後ラン通貨へ加算されます。

お金袋エフェクトは、完全納品がすでに確定した後にのみ開始されます。 このお金袋自体がボーナス報酬の発生源ではありません。

設定項目

セクション 設定値名 設定内容説明 初期値 最小値 最大値
General ModEnabled MODの有効無効 true - -
Bonus BaseBonusPercent 完全納品時に付与する基本ボーナス率 10 0 100
Bonus EnableStreakBonus 連続完全納品による追加ボーナス率の有効無効 true - -
Bonus StreakAddPercent 2連続目以降に1回ごと加算するボーナス率 5 0 100
Bonus MaxBonusPercent 通常の完全納品ボーナス率の上限 50 0 100
Bonus NoLossExtraBonusPercent 初期貴重品を価値減少なしですべて納品した場合の追加ボーナス率 10 0 100
Streak ResetStreakOnNonPerfectClear 通常クリアだが完全納品でない場合に連続数をリセット true - -
Streak ResetStreakOnLevelFail レベル失敗時に連続数をリセット true - -
UI ShowBonusUI ボーナス獲得時のUI表示 true - -
Tracking InitialSnapshotDelaySeconds LevelGenerator.GenerateDone 後に初期貴重品の安定検出を開始するまでの待機秒数 0.75 0 10
Tracking SnapshotStableFrames 初期貴重品一覧を確定するために必要な安定フレーム数 20 1 600
Effect EnableMoneyBagEffect 完全納品確定後のお金袋生成エフェクトの有効無効 true - -
Effect MoneyBagEffectValue エフェクト用お金袋に表示するドル価値 9999 1 999999
Effect MaxAliveMoneyBagEffects 古いお金袋を削除して維持する最大エフェクト数 120 3 300
Debug LogEnabled 詳細デバッグログの有効無効 true - -
Chat PerfectBonusPublicChatMessage 通常の完全納品ボーナス時に送信する公開強制チャット文。〇〇k$ がボーナス額へ置換されます Perfect Extraction Bonus 〇〇k$ - -
Chat NoLossPerfectBonusPublicChatMessage 無減額完全納品ボーナス時に送信する公開強制チャット文。〇〇k$ がボーナス額へ置換されます Wow!!! Super No-loss Perfect Extraction Bonus 〇〇k$ - -
Chat AnnounceRemainingCountInPublicChat 納品成功ごとに残り未納品数を公開チャットで送信するか false - -
Chat RemainingCountPublicChatMessage 残り未納品数の公開チャット文。{remaining}{delivered}{initial} に対応 {remaining} valuables left - -

開発者向けメモ

このMODは、メイン処理でシーンロード監視に依存しません。 初期貴重品の追跡は LevelGenerator.GenerateDone 後に開始されるため、リージョン選択、メインメニュー、ロビー、ショップ、アリーナ中にゲーム本編処理が走ることを避けています。

納品追跡は、抽出ポイントのhaul破棄処理へPatchし、初期レベルスナップショットに含まれていた貴重品だけを記録します。 これにより、お金袋エフェクトを含む後から生成された貴重品を完全納品判定へ含めないようにしています。

※AI生成MOD

CHANGELOG

Changelog

4.0.0

  • Updated for the REPO Cosmetics Update v0.4.0.
  • Changed initial valuable tracking to start after LevelGenerator.GenerateDone.
  • Added perfect extraction detection for valuables that existed at level start.
  • Added bonus payment when all initial valuables are extracted.
  • Added streak-based bonus support.
  • Added no-loss extra bonus support.
  • Added money bag effect spawning after perfect extraction is confirmed.
  • Added EnableMoneyBagEffect config.
  • Added MoneyBagEffectValue config.
  • Added MaxAliveMoneyBagEffects config.
  • Added cleanup for spawned money bag effects on level change.
  • Added correction logic so effect money bags do not inflate the extraction goal.
  • Kept the mod host-only.
  • Updated comments and config descriptions to English/Japanese format.