Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
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
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2100README
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
EnableMoneyBagEffectconfig. - Added
MoneyBagEffectValueconfig. - Added
MaxAliveMoneyBagEffectsconfig. - 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.