[SCRIPT] Addon-Free Arma Radio

[Phronk]

DESCRIPTION

This is a script which enhances Arma's VOIP by adding radio effects when communicating with other players, while factoring distance. No mods / third-party programs required. Setup is easy!

VIDEO (Outdated, will update soon)

https://youtu.be/dAaOlC1fkH0
https://www.youtube.com/watch?v=lc2R1Up7w_Q

SCREENSHOTS

Radio Interface (1)
Radio in use (2)
Character animation (3)
In-game Briefing (4)

FEATURES

• No mods required. THIS IS NOT A MOD.
  
  
• No third-party programs required
  
  
• Script will initialize only if TFAR & ACRE2 aren't enabled
  
  
• Admins/clients don't have to download ANYTHING extra to play your mission
  
  
• Tiny file size! (132 KB)
  
  
• Adds interesting depth to VOIP, which it has lacked for so long
  
  
• Using VOIP will broadcast radio noise to friendlies with a radio within radio range
  
  
• Players who aren't in range cannot hear you or your radio noise and vice versa
  
  
• Incapacitated / dead players cannot use radio (Optional)
  
  
• Compatible with infantry, land, sea, and air vehicles
  
  
• Compatible with Zeus
  
  
• Compatible with Dynamic Groups system
  
  
• Compatible with End Game respawn templates[community.bistudio.com]
  
  
• Compatible with End Game Spectator[community.bistudio.com]
  
  
• In-game radio interface includes options to customize settings locally
  
  
• Easy to configure - AFAR\CFG.sqf
  
  
• More information in the "ReadMe.txt"

TO DO LIST

• Voice clipping effects during transmission interference
  
• Convert into an addon (Scripted version will still be supported, too)

KNOWN BUGS - (Upcoming Change-Log)

• Desync can cause delays in code execution

CREDITS

• Phronk: Script Creator
  
• Bohemia Interactive: Radio audio, model, and animation

CONTRIBUTORS

• Dedmen added important VON script commands to Arma 3
  
• DirtySanchez reorganized AFAR and improved security
  
• Metalman [EXP] helped optimize code initialization

TESTERS

• Genesis92x [TFR]
  
• Harris [TFR]
  
• LightHouse
  
• MorpheousMike
  
• Moser [TFR]
  
• newgen [TFR]
  
• PRYMSUSPEC [TFR]
  
• TASK FORCE RONIN

(02JUL2023) - v0.99
Size: 132 KB
DOWNLOAD LINK[drive.google.com] - (Google Drive)
DOWNLOAD LINK - (Steam Workshop)

CHANGE-LOG

Added: Global Mobilization DLC support for radio backpacks
Added: Mouse-buttons can now be used for PushToTalk keys
Added: Players can now cycle to Direct channel via keybinds/radio UI
Added: Respawning/exiting vehicles cache prior selected channel
Added: "r_ptt" global variable in "dn.sqf" and "up.sqf"
Added: _ch variable in "up.sqf" uses channel stored in r_ptt

Changed: Radio interface is opened by double-clicking your equipped radio
Changed: Radio "in" functions call "r_out2" for better radio state handling
Tweaked: Increased volume of all AFAR sounds
Tweaked: Explanation on how to view the radio interface in the briefing

Possibly Fixed: "out" related functions breaking
Possibly Fixed: RPT errors related to "dialogs.hpp" and "defines.hpp" files
Fixed: Displays other than 46 & 312 will pause AFAR eventHandlers until it exits
Fixed: Converted "r_f" global variable to an object variable, so deleteAt works
Fixed: Unnecessary quotation within string in "vOut.sqf"
Fixed: Missing semi-colons in "dialogs.hpp"
Fixed: Possible memory leaks related to non-private local variables
Fixed: Some functions may propagate local variables due to no arguments defined
Fixed: _p switch case return was out of scope in "out2.sqf"

Optimized: Much less "KeyDown" displayEventHandlers
Optimized: EventHandlers are no longer being deleted/recreated
Optimized: Channel cycling code has less code chunks per channel
Optimized: Replaced apply with forEach in "out.sqf"
Optimized: _p variable is now the return of switch case in "out2.sqf"

Replaced: DisplayAddEventHandler code with BIS_fnc_addStackedEventHandler
Removed: "Diary" keybind no longer opens radio UI
Removed: "eh.sqf" script
Removed: "Z.sqf" script

[Phronk]

Last updated: 12JUL2023
This post will be edited frequently.

D E V E L O P M E N T - N E W S

Version 0.99 has been released! No known errors or bugs at this time. Please report any you may find. Next update will be the long awaited addon-version (The script version will also remain supported). Moving forward, AFAR will mainly just receive bug fixes, optimizations, and possible compatibility updates; don't expect many more features from this point on to be added.

UPCOMING CHANGE-LOG

(??.???.2023) v1.00 - Not Yet Released!
Size: 132 KB

Added: URC-10 radio for SOG:PF CDLC

Tweaked: Replaced playSound with playSoundUI for radio buttons

Fixed: Clients wait for server to initialize before 

Optimized: N/A

Removed: N/A

KNOWN BUGS:
High ping and desync can cause code delays
Tasks Before Next Release:
Release separate version as a mod
Add setting to CFG.sqf to modify max radio ranges *
QoL improvements; overall improve user-friendliness & usability
Beyond 1.00 Release:
Add voice clipping effects during transmission interference
Experiment with programmable radio idea
Option to set Group radio only available to squad leaders
Squad leader transmits to his subordinates
Subordinates in Group receive comms but cannot transmit (Realism)
Relay/retrans sites

[Phronk]

FREQUENTLY ASKED QUESTIONS

How do I install the script into a mission?

Please read the Installation Instructions.

When will this be released as a standalone mod?

FUTURE VERSION 1.0; once all bugs are fixed. Keep in mind that both client and server will need the mod. The script version will still be updated.

Why make a radio script?! There's better radio mods out there!

It's for those who prefer to play Arma without mods. It's easier to use this, without having to download 2 mods + TeamSpeak + setup TeamSpeak + setup keybinds + program radios.

Are programmable radios planned?

MAYBE. It is now theoretically possible and I'd like to start experimenting with the idea.

Is there voice distortion, based on distance/signal interference?

NO. Impossible with Arma's VOIP and script commands. I may add voice clipping, which will make the voice cut in and out if interference is bad.

Does AFAR support PVP scenarios? Can more than 1 side use this?

YES. I've designed it to work for both Co-op and PvP missions.

Can allies (i.e: Independent and Blufor) communicate?

NO. Aside from Direct and Vehicle channel, Allies cannot hear you.

Can OPFOR players steal BLUFOR radios and listen/talk to them?

NO. Can't be done without using all custom radio channels.

Does AFAR support "Global" and "Side" channels?

Side channel YES, Global channel NO. AFAR disables them by default. Players often flood those channels, despite having access to the others. Edit the "CFG.sqf" in the mission to enable Side channel.

Is "Global" channel support planned to be added in a future update?

NO. And it never will. (Maybe for logged-in admins only)