PerfectExtractionBonus

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 t