ATM_Tools_OPEX

# ATM Tools OPEX

Mod d'AI dressing scénarisé pour Arma Reforger, conçu pour les Game Masters et créateurs de missions PvE. Peuplez vos zones d'opération avec civils, patrouilles armées, défenseurs CQB, patrouilles véhicules et IEDs — apparition/disparition dynamique autour des joueurs sans plomber les perfs.

## Zones OPEX

Entités placeables dans le World Editor avec rayon jusqu'à 50 km. **6 types de profils** combinables sur une même zone :
- **Patrol** : patrouilles armées dans la zone
- **Civilian** : spawn intérieur multi-étages dans les bâtiments (validation par trace, anti-spawn dans les murs)
- **Civilian Patrol** : civils qui patrouillent près des habitations
- **CQB** : défenseurs hostiles à l'intérieur
- **Vehicle Patrol** : crews + véhicules sur les routes, circuit auto-généré
- **IED** : posés près des routes, détonation sur passage de véhicule

État machine DORMANT / ACTIVE / SLEEPING / EXHAUSTED avec hystérésis. Modes **One-Shot** (la zone se clear définitivement) ou **Décoration** (zones civilian-only qui ne s'exhaustent jamais). Activation par rayon, par trigger Scenario Framework, ou via API.

**Speed threshold anti-driveby** + grace period : pas de spawn devant un véhicule en mouvement, pas de pop-in après freinage soudain.

## Système global (GameMode)

- **AI Budget Manager** : cap global d'agents actifs avec reaper automatique (entrées orphelines auto-nettoyées)
- **Map Cache** : scan unique au boot (routes + bâtiments), JSON persisté, filtres keyword obstacles (rock, cliff, wall, ruin, oil, etc.)
- **Spawn Pipeline** : throughput configurable (50ms-2s, 1-20 items/tick) depuis le GM panel
- **Ambient Life Spawner** : civils/patrouilles/véhicules autour des joueurs en complément des zones
- **Ambient Vehicle Spawner** : véhicules garés générés dynamiquement
- **Exclusion Zones** : prefab placeable bloquant par-type (IED / Patrol / CQB / Civilian / Vehicle)
- **Persistence** : sauvegarde/restauration des états de zone entre redémarrages serveur

## Comportements civils

- **Civilian Flee** : civils paniquent et fuient sur tirs (vers bâtiments ou à pied)
- **Civilian Rebellion** : seuil de kills civils dépassé → certains civils deviennent hostiles avec armes

## Outils Mission Maker

### Plugins SlotAI Scenario Framework
- **PluginImmortalAI** : rend les AI du SlotAI immortels (clamp Blood/Brain/Resilience + ACE Second Chance bypass). Peuvent être blessés et tomber inconscients mais ne meurent jamais — forcent les joueurs à les soigner. Idéal pour PNJ d'objectif (informateurs, otages, VIP).

### Scripted User Actions
- **AudioScriptedAction** : action d'interaction avec PNJ qui joue un son FMOD, mode one-shot + activation de Scenario Framework Layers en cascade. Auto-hide quand le PNJ est mort/inconscient.
- **Jukebox System** : multi-pistes pour radio/gramophone/prop musical — actions Play par piste, Stop global, Volume Up/Down avec persistence entre changements de piste. Pipeline audio via fichier .sig.

### Workbench
- Visualiseur sphères wireframe (radius / activation / deactivation) sans activation manuelle (pattern vanilla SCR_ScenarioFrameworkLayerBase)
- Force Debug Draw global pour admin overview
- Compteurs live par état de zone

## Configuration

Tout est exposé via Workbench attributes :
- Min/Max groupes par profil (jusqu'à 500)
- Cooldowns de respawn
- CRX behavior settings par groupe
- Activation/deactivation/min spawn distances
- Sliders de tick + budget dans le GM panel

## Dépendances

- Arma Reforger (vanilla)
- CRX_EAI 1.6.0+
- ACE Medical (Core, Medical, Circulation, Medication)

## Architecture

Conçu pour PvE Anizay 2026 avec montée à 100+ joueurs. Toutes les opérations coûteuses (scans, queues spawn/despawn, ticks zones) sont budgetées et configurables runtime depuis le GM panel — pas besoin de redémarrer le serveur pour ajuster.

## Auteur
=ATM= Nomad — A-Team — atmarma.fr