SURRENDER PROTOCOL

SUPER DUPPER WIP EXPECT BUGS


## Tactical AI Surrender System

**Developed by:**
MAD [Hk]

### Description

This mod adds a dynamic surrender system for AI units in Arma Reforger, fully configurable through ACE Mission Header settings on dedicated servers.

When an AI group is reduced to its last combat-capable soldier, that unit may surrender based on a base chance plus tactical context (nearby allies/enemies, wounded allies, incapacitated allies, and self-health).

After surrendering, the unit remains surrendered for a minimum delay. If it is not captured, it will run release checks (escape attempts) using a configurable chance model and retry system.

### Main features

* Last-man surrender trigger.
* Tactical chance modifiers based on nearby force balance.
* Wounded/incapacitated ally impact on morale.
* Self-health impact on surrender and release.
* Minimum surrender duration before the first release check.
* Configurable retry interval and maximum retry checks.
* Captured units do not self-release.
* Perception-based neutrality option (without permanently changing the real faction).
* Automatic AI combat-state recovery when leaving surrender (including after unconscious/alive transitions).

### Notes

* All probability/weight fields use normalized values from 0.0 to 1.0.
* 0.75 means 75%.
* Final surrender/release chance is always clamped to 0.0..1.0.

---

## Minimal example (legacy style)

```json
"m_ACE_Settings": {
  "m_CaptiveModSettings": {
    "m_fRenditionChance": 0.75,
    "m_fReleaseDelayMinutes": 2.0,
    "m_fReleaseChance": 0.75
  }
}
```

## Full example (recommended, current defaults)

```json
"m_ACE_Settings": {
  "m_CaptiveModSettings": {
    "m_fRenditionChance": 0.75,
    "m_fReleaseDelayMinutes": 2.0,
    "m_fReleaseChance": 0.75,

    "m_bUsePerceivedNeutrality": true,
    "m_bUseNearbyForceModifier": true,

    "m_fNearbyScanRadiusM": 120.0,
    "m_fAllyInfluencePerUnit": 0.05,
    "m_fEnemyInfluencePerUnit": 0.08,
    "m_fNearbyModifierClamp": 0.35,
    "m_iNearbyMinUnits": 2,

    "m_fWoundedHealthThreshold": 0.65,
    "m_fWoundedAllyInfluencePerUnit": 0.05,
    "m_fIncapacitatedAllyInfluencePerUnit": 0.10,

    "m_fSelfWoundInfluenceOnSurrender": 0.20,
    "m_fSelfWoundPenaltyOnRelease": 0.12,

    "m_fReleaseRetryIntervalMinutes": 1.0,
    "m_iMaxReleaseChecks": 5,

    "m_fReleaseAllyBonusPerUnit": 0.04,
    "m_fReleaseEnemyPenaltyPerUnit": 0.08,
    "m_fReleaseWoundedAllyPenaltyPerUnit": 0.03,
    "m_fReleaseIncapacitatedAllyPenaltyPerUnit": 0.06,
    "m_fReleaseModifierClamp": 0.50
  }
}
```