AntiValuableGrief

AntiValuableGrief

Overview

This mod is a host-only mod that detects players who cause large valuable damage, shows a red warning popup with J-key teleport support, and can optionally trigger a hidden enemy investigate reaction when severe loss is detected.

Main behavior

• Monitors valuable damage during level gameplay
• Attributes damage to the current holder or a recent holder of the damaged valuable
• Tracks both recent loss inside the configured time window and total loss for the current level
• Shows a red animated warning popup when the configured recent loss threshold is exceeded
• Displays both LOSS for the configured time window and TOTAL for the whole level in the popup
• Lets the mod user teleport to the currently warned player with J while the popup is visible
• Stops monitoring after the final extraction is completed when the related setting is enabled
• Prints the level damage ranking to the console when entering the shop

Hidden optional feature

This mod also includes an optional hidden feature that is disabled by default.

When enabled, it checks whether the offender reaches the configured border amount. Only when that border is reached or exceeded, the mod sends an investigate command using the nearest level point to that offender.

The investigate range is based on the current loss amount using the configured divisor, with minimum and maximum range clamps.

Default behavior for the hidden feature:

• Disabled by default
• No investigate is executed below the border amount
• Investigate is executed only at or above the configured border amount
• Uses the offender's nearest level point as the investigate origin

Important notes

• This is a host-only monitoring mod
• Monitoring can stop after the final extraction is completed, so post-clear damage can be excluded from counting
• The popup teleport works only while the currently displayed warning popup is visible
• The hidden investigate feature is an extra bonus system and is disabled by default

Installation

• Install BepInEx 5 for REPO
• Place AntiValuableGrief.dll in your BepInEx/plugins folder
• Start the game once to generate the config file
• Adjust the config values if needed

Configuration

EnableMod

• Description: Enable or disable the entire mod
• Default: true
• Minimum: false
• Maximum: true

RecentHolderGraceSeconds

• Description: How many seconds a player is still treated as the recent holder after releasing a valuable
• Default: 3.0
• Minimum: No hard clamp in code. Practical minimum is 0
• Maximum: No hard clamp in code

LossWindowSeconds

• Description: Time window in seconds used for recent loss accumulation
• Default: 15.0
• Minimum: No hard clamp in code. Practical minimum is greater than 0
• Maximum: No hard clamp in code

WarningLossThreshold

• Description: Recent loss amount required to trigger the warning popup
• Default: 2000
• Minimum: No hard clamp in code. Practical minimum is 0
• Maximum: No hard clamp in code

IgnoreUnownedValueLoss

• Description: Ignore damage events when no responsible current or recent holder can be identified
• Default: true
• Minimum: false
• Maximum: true

IgnoreAlreadyHauledValuables

• Description: Ignore valuables that are already counted as hauled
• Default: true
• Minimum: false
• Maximum: true

StopMonitoringAfterFinalExtraction

• Description: Stop monitoring after the final extraction is completed so post-clear damage is not counted
• Default: true
• Minimum: false
• Maximum: true

ShowWarningOverlay

• Description: Show the animated red warning popup on screen
• Default: true
• Minimum: false
• Maximum: true

WarnInConsole

• Description: Print warning information to the BepInEx console and log
• Default: true
• Minimum: false
• Maximum: true

WarningFontSize

• Description: Font size used by the warning popup text
• Default: 30
• Minimum: No hard clamp in code. Practical minimum is around 16
• Maximum: No hard clamp in code

WarningDisplaySeconds

• Description: How long the warning popup stays visible before fading out