ACE3/docs/wiki/feature/vehicledamage.md
johnb432 80b2fa9a05
Vehicle damage - Code cleanup (#9831)
* Cook-off improvements

* More changes

* Update fnc_getVehicleAmmo.sqf

* Better engine fire placement

* Update fnc_detonateAmmunition.sqf

* Update XEH_postInit.sqf

* Update fnc_getVehicleAmmo.sqf

* Update events-framework.md

* Various improvements

* Separate effect handling

* Tweaks

* Update XEH_postInit.sqf

* Prevent double ammo detonation

* Fixed objects not being able to cook-off again

* Added incendiary rounds as source of box cookoff

* Converted enable setting to bool

* Fixed brackets

* Update fnc_cookOff.sqf

* Update CfgEden.hpp

* Removed GVAR(enable), added GVAR(enableFire) back

* Vehicle damage fixes

* Made hitpoint hash common

* Update fnc_addEventHandler.sqf

* Update fnc_medicalDamage.sqf

* Update fnc_handleBail.sqf

* Changed API

* Remove `CBA_fnc_getConfigEntry` as much as possible, as it's 2x slower

* More cleanup

* More cleanup

* Fix merging issues, remove turret tossing

* Update translations

* More cleanup

* Reverted some logic back to original, minor tweaks & fixes

* Fix undefined variable

* Cleanup

* Fixed bad logic

* Update addons/vehicle_damage/script_macros.hpp

Co-authored-by: Grim <69561145+LinkIsGrim@users.noreply.github.com>

* Update addons/vehicle_damage/functions/fnc_handleDamage.sqf

* Update addons/vehicle_damage/stringtable.xml

Co-authored-by: Grim <69561145+LinkIsGrim@users.noreply.github.com>

* Update addons/vehicle_damage/stringtable.xml

Co-authored-by: Grim <69561145+LinkIsGrim@users.noreply.github.com>

* Update addons/vehicle_damage/XEH_postInit.sqf

Co-authored-by: PabstMirror <pabstmirror@gmail.com>

---------

Co-authored-by: Grim <69561145+LinkIsGrim@users.noreply.github.com>
Co-authored-by: PabstMirror <pabstmirror@gmail.com>
2024-08-20 16:23:21 -03:00

119 lines
3.5 KiB
Markdown

---
layout: wiki
title: Vehicle Damage
component: vehicle_damage
description: Enhances vanilla armoured vehicle damage simulation.
group: feature
category: realism
parent: wiki
mod: ace
version:
major: 3
minor: 14
patch: 0
---
## 1. Overview
Removes hit-point based damage on armoured vehicles.
### 1.1 Differences from vanilla
Vehicle damage is component based in this system. Rather than catastrophically exploding when an arbitrary amount of damage is received, the system calculates what warhead hit you, if it hit SLAT/ERA, and what components it hits.
When you are hit, a calculation takes place and determines which people inside the vehicle should get hurt.
### 1.2 How is damage calculated
Damage takes into account what warhead hits you, the speed it hits you at, and how much armour it hit.
If you are hit with a HEAT warhead, the system will check if you hit any ERA or SLAT armour and if so it negates all damage from hitting your vehicle and instead the component absorbs it.
Once the SLAT or ERA is destroyed, if hit again in the same spot the warhead will penetrate. Tandem HEAT will penetrate and destroy the armour, however. AP ammo has a chance to destroy it.
All ammunition shot at a vehicle is considered into the calculation. If the ammo is incendiary and it penetrates into a vital component there is a chance for cook-off to occur.
At the time of writing, blow-out panels are not simulated within the system.
### 1.3 What components are considered
- Engine
- Hull
- Turret
- Gun barrel
- Track
- Wheels
- Fuel Tank
- SLAT
- ERA
### 1.4 What warheads are considered
- AP (General AP ammo: APFSDS, Solid Shot, etc.)
- HEAT
- HEAT (Tandem)
- HE
## 2. Component Overview
### 2.1 Engine
The engine drives the vehicle. If the engine takes a critical hit, it will be destroyed and the vehicle will become immobile.
- Can cook-off [Y]
- Can injure occupants [Y]
### 2.2 Hull
The hull is a hitpoint that is simulated to be a crew compartment. If you penetrate the hull there is a chance for occupants to take damage. Hits on the hull can also fragment and take out other components, like the turret and engine.
- Can cook-off [Y]
- Can injure occupants [Y]
### 2.3 Turret
The turret is assumed to house the ammo racks and hydraulics/electronics that control turret movement. On turret hit there is a chance for the turret to jam requiring further repair.
- Can cook-off [Y]
- Can injure occupants [Y]
### 2.4 Gun barrel
The gun barrel is the barrel for any weapon on the vehicle. If hit, there is a chance for the barrel to be broken requiring further repair to shoot and traverse.
- Can cook-off [N]
- Can injure occupants [N]
### 2.5 Track
A track on the vehicle. If hit, the track can break and immobilise the vehicle.
- Can cook-off [N]
- Can injure occupants [N]
### 2.6 Wheels
A wheel on the vehicle. If hit, the wheel can break and immobilise the vehicle.
- Can cook-off [N]
- Can injure occupants [N]
### 2.7 Fuel Tank
When hit, the fuel tank will leak fuel and require repair to hold fuel again.
- Can cook-off [Y]
- Can injure occupants [N]
### 2.8 SLAT
When hit, HEAT warheads will be defeated and no damage will be applied. If hit with Tandem HEAT or HE the SLAT will be destroyed. If hit with AP, there is a small chance for SLAT to be damaged.
- Can cook-off [N]
- Can injure occupants [N]
### 2.9 ERA
When hit, HEAT warheads will be defeated and no damage will be applied. If hit with AP, Tandem HEAT, or HE the ERA will be destroyed.
- Can cook-off [N]
- Can injure occupants [N]