Skip to content

mgkid3310/AWESome

Repository files navigation

AWESome : Aerial Warfare Enhanced Somehow

Enhances the ARMA 3's flight environments to be more
realistic (Aerodynamics, GPWS, ATC, etc.).

Recommended to use with ACE since AWESome will take
advantage of ACE when able such as ACE Interactions,
ACE Weather and more.

This addon is SP/MP capable and basically works as a
client-side mod, and gives some additional features when
used on both client/server.

Although this addon is licensed under CC BY-NC-ND 4.0,
feel free to contact me if you need any code from this
addon for applications.


Features

  1. Realistic Aerodynamics (drag, lift, etc.)

Basic drag model is replaced with an enhanced model so
that it better reflects the drag in real life. This will
generate drag that's much more complicated than a simple
polynomial function and create many effects such as the
so-called 'Sound barrier'.
Vehicle's fuel status and weapon loadout will now affect
mass and aerodynamic characteristics of the vehicle,
resulting in high aerodynamic drag and lowered stability
when armed heavily.
This also brings air density and wind into consideration.
Air density is calculated based on altitude, temperature
and humidity which gets more accurate if ACE3 weather is
used together.

Can enable/disable at addon settings (enabled as default),
and effects of wind can be adjusted with "Wind Multiplier"
setting.
 

  1. Voice Informer & GPWS

GPWS(incl. Voice Informer) has three modes: B747, F-16
and Rita. B747's GPWS has more familiar sounds from
commercial airliners including altitude informers during
landing. Suitable for large transport or support planes.
F-16's Bitching Betty GPWS includes missile warning and
other sound-warnings (voice informers). Gives basic
warnings such as: Counter; Warning; Caution; etc., and is
suitable for fighter planes.
Rita is a Russian voice informer which works similar to
Bitching Betty, but speaks Russian and has fewer
features(it's mainly because I don't speak Russian, and
therefore I can't find enough sound files).

You can set default setting for GPWS in addon settings
which will override plane's default GPWS mode setting
and set GPWS mode to what you want when getting in a
plane. However, if someone with this addon is in or has
been in the plane, the GPWS mode will not change and
stay as it was.
 

  1. ATC (Air Traffic Controller) Systems

Shows friendly & civilian planes on map with name, speed,
altitude, and heading. Useful when commanding multiple
planes. Information lines are consisted of the following
three lines:

Pilot's Name or Callsign
Altitude Speed
Heading

Here, altitude is displayed in multiples of 10m or 100ft,
so if the unit is set to "feet (x100ft)" and 083 is displayed
as altitude, the actual altitude would be 8300ft.

Pilot name/callsign & Vehicle callsign setting and units for
speed & altitude can be changed at addon settings tab.
Supports kph/knot for speed and meter/feet for altitude.
To set a vehicle callsign, add this to the plane's init field:
[this, "My Callsign"] call orbis_atc_fnc_setCustomCallsign;
If no vehicle callsign is set, it defaults to the unit's
group ID.

To enable this feature, you need to add the following code
to the target object's init field:
[this, _radarMode, _distance] call orbis_atc_fnc_addRadarScreen;

The _radarMode (default: 1) parameter works in 3 modes:
0: Civilian, same side or civilian side aircraft only
1: Military, civilian mode plus radar detected aircraft
2: Observer, all alive aircraft

The _distance (default: 10) parameter is a number type
parameter which determines how far the controller can move
from the radar monitor. Zero or negative _distance value
will allow an infinite distance.

When using Military mode, custom parameters can be used:
monitor setVariable ["orbis_atc_radarParams", [radarObject, isMaster]]
monitor: Monitor object the atc radar Interaction was added
radarObject: Radar object (default: monitor)
isMaster: displays all airborne objects if true (default: false)

radar setVariable ["orbis_atc_performanceParams", [radarPos, radarRange, counterStealth, volumeCR, groundCR]]
radar: radarObject from "orbis_atc_radarParams"
radarPos: Position of the radar, can be object or position ASL (default: radar)
radarRange: Standard detecting range for RCS 5m^2 vehicle in km (default: 30)
counterStealth: No effect for now (default: 0)
volumeCR: Volume clutter reduction ratio (default: 1000)
groundCR: Ground clutter reduction ratio (default: 1000)

radar setVariable ["orbis_atc_radarDetailParams", radarDetailParams]
radar: Radar object
radarDetailParams: Radar detail parameters (default: [])

radarDetailParams can be used in two modes: preset/custom.
The list of available presets is as follows:
"APS-11": used in airports as surveillance radar
"AN/APG76": used in A-6, weak against rain
"AN/APS145": used in E-2C, weak against ground clutter

When using custom values, the parameters are as follows:
radarDetailParams = [radarFrequency, pulseWidth, azimuthBeamwidth, elevationBeamwidth]
radarFrequency: Frequency of radar beam in GHz (default: 16.5)
pulseWidth: Pulse width of radar beam in micro seconds (default: 1.25)
azimuthBeamwidth: Azimuth beam width in degrees (default: 2.2)
elevationBeamwidth: Elevation beam width in degrees (default: 3.8)

Military ATC radar includes tools for GCI. When clicking on
radar markers on map, a circle will appear around the marker
and lines will be displayed from friendly/civilian aircraft
to bogie/bandit aircraft. Bearing, distance, radial speed,
altitude difference and relative vertical speed will be shown
for ATC controller to provide target information to pilots or
coordinate intercepts.

GCI automatically classifies unknown aircraft as bogie, and
once the bogie launches a missile at friendly aircraft the
contact is classified as bandit. To manually perform this
task, use keybind "AWESome ATC -> Classify as hostile" when
clicking on a radar marker. This will classify the contact
as bandit, and when clicked again its classification will
be reverted to its original state. Using this feature, it
is possible to classify any contact as bandit when required
and revert a blue-on-blue contact back to its original state.
 

  1. ATIS (Automatic Terminal Information Service)

Plays ATIS radio broadcast using real in-game atmospheric
data. Provides wind, visibility, etc. Temperature, dew point,
QNH will be provided when ACE Weather is enabled.
With basic settings, ATIS provides real-time data, but with
addon setting changed, ATIS data should be updated on
ground

To let the controller manually update the data, disable
'Real-time ATIS data update' option in addon setting, and
add the following code to the target object's init field:
[this] call orbis_atc_fnc_addATCConsole;

By default, ATIS will also be displayed as text in hint
window. This can be disabled or moved to chat window by
changing addon settings.
 

  1. Cockpit Utility

Adds camera shake feature reflecting the vehicle's speed and
status including the touchdown speed, and checklists feature
for fixed-wing pilots which provides decision speed, rotate
speed, landing speed and many more automatically filled in.
This helps pilots to check if they have anything forgotten
and gives reference speeds for takeoff and landing.
 

  1. Ground System

Provides towing vehicle & system for all planes. Works in
MP and does not require other players to use this addon for
towing their planes.
Offroad vehicles are used as towing cars, and can tow
planes by deploying towbar via Interaction / Action outside
the vehicle. Once the towbar is deployed, place target
plane's front gear at the end of the towbar, then use Action
to connect target plane to the towbar. After towing around,
stop the vehicle and disconnect target plane using Action.

NOTICE: moving too fast may occur collisions, so drive
with caution when towing.
 


Issue Tracking

To report issues or request features, please use Github's issue tracker

https://github.com/mgkid3310/AWESome/issues


Steam Workshop

You can subscribe to this addon on Steam Workshop

https://steamcommunity.com/sharedfiles/filedetails/?id=1301399507


BI Forum Thread

BI forum thread is also available, but updates and responses may be slower

https://forums.bohemia.net/forums/topic/217012-awesome-aerial-warfare-enhanced-somehow/


Authors

Orbis2358 (mgkid3310@naver.com) : Project Manager & Programmer
 

Contributors

Feel free to add your name here upon any contributions including
code / translation PR

N/A