From 60eabda47e16c660911a0a98327ace33359f0e75 Mon Sep 17 00:00:00 2001
From: johnb432 <58661205+johnb432@users.noreply.github.com>
Date: Sat, 1 Jun 2024 18:55:56 +0200
Subject: [PATCH] Vehicle Damage - Add API to prevent AI from dismounting from
 immobile vehicles (#9990)

* Add API to prevent AI from dismounting from immobile vehicles

* Update vehicledamage-framework.md
---
 addons/vehicle_damage/functions/fnc_abandon.sqf | 2 ++
 docs/wiki/framework/vehicledamage-framework.md  | 8 ++++++++
 2 files changed, 10 insertions(+)

diff --git a/addons/vehicle_damage/functions/fnc_abandon.sqf b/addons/vehicle_damage/functions/fnc_abandon.sqf
index 6a9d4eeb29..83b06a80df 100644
--- a/addons/vehicle_damage/functions/fnc_abandon.sqf
+++ b/addons/vehicle_damage/functions/fnc_abandon.sqf
@@ -18,6 +18,8 @@
 params ["_vehicle"];
 TRACE_2("abandon",_vehicle,(crew _vehicle) select {alive _x});
 
+if (_vehicle getVariable [QGVAR(allowCrewInImmobile), false]) exitWith {}; // check for API
+
 [{
     params ["_vehicle"];
     _vehicle allowCrewInImmobile false;
diff --git a/docs/wiki/framework/vehicledamage-framework.md b/docs/wiki/framework/vehicledamage-framework.md
index 7e22bccf5d..ac94bd30fb 100644
--- a/docs/wiki/framework/vehicledamage-framework.md
+++ b/docs/wiki/framework/vehicledamage-framework.md
@@ -126,3 +126,11 @@ Default ARMA config value. We assume that the warheads are vanilla strings, so o
 - `TandemHEAT`
 
 If no `ace_vehicle_damage_incendiary` defined, this value will be used to assume a default based on above table of common values (excluding `Incendiary Bullet` which is 0).
+
+## 3. Disabling crew bailing for individual vehicles
+
+Crew bailing when their vehicle is disabled (immobile or can't shoot) can be disabled for a specific vehicle:
+
+```
+_vehicle setVariable ["ace_vehicle_damage_allowCrewInImmobile", true, true];
+```