Communication Menu – Arma 3
(→Config) |
Lou Montana (talk | contribs) m (Text replacement - "[[Arma 3 " to "[[Arma 3: ") |
||
(29 intermediate revisions by 7 users not shown) | |||
Line 1: | Line 1: | ||
{{TOC|side}} | |||
Communication menu is a commanding menu where support or mission requests are placed. | Communication menu is a commanding menu where support or mission requests are placed. | ||
The player can access it using following means: | The player can access it using following means: | ||
* Open the '''quick command menu''' | * Open the '''quick command menu''' {{Controls|~}} and select "Communication" item | ||
* Press | * Press {{Controls|8}} then {{Controls|1}} (Reply - Communication) | ||
{{Feature|arma2|For {{arma2}} and additional information, see [[Arma 2: Custom Command Menu]].}} | |||
Available items are announced upon adding by a [[Arma 3: Notification|notification]] and remain visualized as icons next to the commanding menu.<br> | |||
[[File:A3_commMenu.jpg|Communication menu and icons|500px]] | |||
== Configuration == | == Configuration == | ||
=== Config === | === Config === | ||
Communication menu items can be defined in config - global [[Config.cpp]], | |||
Communication menu items can be defined in config - global [[Config.cpp]], [[Campaign Description.ext]] or mission [[Description.ext]] (searched in this order, the latter has the highest priority). | |||
{{Feature|informative|'CfgCommunicationMenu' is purely scripted config which requires the use of scripted function [[BIS_fnc_addCommMenuItem]]. It will not work with [[showCommandingMenu]] script command.}} | |||
[[File:CommunicationMenuIconsA3Beta.jpg|thumb|Preview and path for icons]] | [[File:CommunicationMenuIconsA3Beta.jpg|thumb|Preview and path for icons]] | ||
<syntaxhighlight lang="cpp"> | |||
class CfgCommunicationMenu | |||
{ | |||
class myArtillery | |||
{ | |||
text = "Artillery Strike"; // Text displayed in the menu and in a notification | |||
submenu = ""; // Submenu opened upon activation (expression is ignored when submenu is not empty.) | |||
expression = "player setVariable ['BIS_SUPP_request', ['Artillery', _pos]];"; // Code executed upon activation | |||
icon = "\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\artillery_ca.paa"; // Icon displayed permanently next to the command menu | |||
cursor = "\a3\Ui_f\data\IGUI\Cfg\Cursors\iconCursorSupport_ca.paa"; // Custom cursor displayed when the item is selected | |||
enable = "1"; // Simple expression condition for enabling the item | |||
removeAfterExpressionCall = 1; // 1 to remove the item after calling | |||
}; | |||
class menu_comms_1 | |||
{ | |||
text = "Menu Comms 1"; | |||
submenu = "#USER:MENU_COMMS_1"; // will open submenu that is defined as global variable MENU_COMMS_1 | |||
expression = ""; | |||
icon = ""; | |||
cursor = ""; | |||
enable = "1"; | |||
removeAfterExpressionCall = 0; | |||
}; | |||
}; | |||
</syntaxhighlight> | |||
You can also preview pre-defined items using the | Available default icons: | ||
* {{hl|"\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\'''artillery_ca'''.paa"}} | |||
* {{hl|"\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\'''attack_ca'''.paa"}} | |||
* {{hl|"\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\'''call_ca'''.paa"}} | |||
* {{hl|"\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\'''cas_ca'''.paa"}} | |||
* {{hl|"\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\'''casheli_ca'''.paa"}} | |||
* {{hl|"\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\'''defend_ca'''.paa"}} | |||
* {{hl|"\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\'''instructor_ca'''.paa"}} | |||
* {{hl|"\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\'''mortar_ca'''.paa"}} | |||
* {{hl|"\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\'''supplydrop_ca'''.paa"}} | |||
* {{hl|"\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\'''transport_ca'''.paa"}} | |||
You can also preview pre-defined items using the [[BIS_fnc_configViewer|Splendid™ Config Viewer]]. | |||
=== Simple expressions === | |||
<div style="display: inline-block; max-height: 40em; overflow: auto"> | |||
{| class="wikitable sortable" | |||
|- | |||
! Expression !! Effect !! Tested | |||
|- | |||
| 1 || Always available || {{Icon|checked}} | |||
|- | |||
| 0 || Always disabled || {{Icon|checked}} | |||
|- | |||
| cursorOnGround || Only callable when pointing at a valid position || {{Icon|checked}} | |||
|- | |||
| IsLeader || Player has to be the leader of his group || {{Icon|checked}} | |||
|- | |||
| IsAlone || || {{Icon|unchecked}} | |||
|- | |||
| IsAloneInVehicle || || {{Icon|unchecked}} | |||
|- | |||
| IsCommander || || {{Icon|unchecked}} | |||
|- | |||
| VehicleCommander || || {{Icon|unchecked}} | |||
|- | |||
| CommandsToGunner || || {{Icon|unchecked}} | |||
|- | |||
| CommandsToPilot || || {{Icon|unchecked}} | |||
|- | |||
| NotEmpty || || {{Icon|unchecked}} | |||
|- | |||
| NotEmptySoldiers || || {{Icon|unchecked}} | |||
|- | |||
| NotEmptyCommanders || || {{Icon|unchecked}} | |||
|- | |||
| NotEmptyMainTeam || || {{Icon|unchecked}} | |||
|- | |||
| NotEmptyRedTeam || || {{Icon|unchecked}} | |||
|- | |||
| NotEmptyGreenTeam || || {{Icon|unchecked}} | |||
|- | |||
| NotEmptyBlueTeam || || {{Icon|unchecked}} | |||
|- | |||
| NotEmptyYellowTeam || || {{Icon|unchecked}} | |||
|- | |||
| NotEmptySubgroups || || {{Icon|unchecked}} | |||
|- | |||
| NotEmptyInVehicle || || {{Icon|unchecked}} | |||
|- | |||
| SelectedTeam || || {{Icon|unchecked}} | |||
|- | |||
| SelectedUnit || || {{Icon|unchecked}} | |||
|- | |||
| FuelLow || || {{Icon|unchecked}} | |||
|- | |||
| AmmoLow || || {{Icon|unchecked}} | |||
|- | |||
| Injured || || {{Icon|unchecked}} | |||
|- | |||
| Multiplayer || || {{Icon|unchecked}} | |||
|- | |||
| AreActions || || {{Icon|unchecked}} | |||
|- | |||
| CursorOnGroupMember || || {{Icon|unchecked}} | |||
|- | |||
| CursorOnHoldingFire || || {{Icon|unchecked}} | |||
|- | |||
| CursorOnEmptyVehicle || || {{Icon|unchecked}} | |||
|- | |||
| CursorOnVehicleCanGetIn || || {{Icon|unchecked}} | |||
|- | |||
| CursorOnFriendly || || {{Icon|unchecked}} | |||
|- | |||
| CursorOnEnemy || || {{Icon|unchecked}} | |||
|- | |||
| CursorOnGround || || {{Icon|unchecked}} | |||
|- | |||
| CanSelectUnitFromBar || || {{Icon|unchecked}} | |||
|- | |||
| CanDeselectUnitFromBar || || {{Icon|unchecked}} | |||
|- | |||
| CanSelectVehicleFromBar || || {{Icon|unchecked}} | |||
|- | |||
| CanDeselectVehicleFromBar || || {{Icon|unchecked}} | |||
|- | |||
| CanSelectTeamFromBar || || {{Icon|unchecked}} | |||
|- | |||
| CanDeselectTeamFromBar || || {{Icon|unchecked}} | |||
|- | |||
| FormationLine || || {{Icon|unchecked}} | |||
|- | |||
| FormationDiamond || || {{Icon|unchecked}} | |||
|- | |||
| SomeSelectedHoldingFire || || {{Icon|unchecked}} | |||
|- | |||
| PlayableLeader || || {{Icon|unchecked}} | |||
|- | |||
| PlayableSelected || || {{Icon|unchecked}} | |||
|- | |||
| IsWatchCommanded || || {{Icon|unchecked}} | |||
|- | |||
| IsSelectedToAdd || || {{Icon|unchecked}} | |||
|- | |||
| HCIsLeader || || {{Icon|unchecked}} | |||
|- | |||
| HCCursorOnIcon || || {{Icon|unchecked}} | |||
|- | |||
| HCCursorOnIconSelectable || || {{Icon|unchecked}} | |||
|- | |||
| HCCanSelectUnitFromBar || || {{Icon|unchecked}} | |||
|- | |||
| HCCanDeselectUnitFromBar || || {{Icon|unchecked}} | |||
|- | |||
| HCCanSelectTeamFromBar || || {{Icon|unchecked}} | |||
|- | |||
| HCCanDeselectTeamFromBar || || {{Icon|unchecked}} | |||
|- | |||
| HCNotEmpty || || {{Icon|unchecked}} | |||
|- | |||
| PlayerVehicleCanGetIn || || {{Icon|unchecked}} | |||
|- | |||
| IsXbox || || {{Icon|unchecked}} | |||
|- | |||
| IsTeamSwitch || || {{Icon|unchecked}} | |||
|- | |||
| CursorOnNotEmptySubgroups || || {{Icon|unchecked}} | |||
|- | |||
| SomeSelectedHaveTarget || || {{Icon|unchecked}} | |||
|- | |||
| CursorOnGroupMemberSelected || || {{Icon|unchecked}} | |||
|- | |||
| HCCursorOnIconSelectableSelected || || {{Icon|unchecked}} | |||
|- | |||
| HCCursorOnIconenemy || || {{Icon|unchecked}} | |||
|- | |||
| PlayerOwnRadio || || {{Icon|unchecked}} | |||
|- | |||
| CursorOnNeedFirstAID || || {{Icon|unchecked}} | |||
|- | |||
| CursorOnNeedHeal || || {{Icon|unchecked}} | |||
|} | |||
</div> | |||
== Adding == | |||
Use following functions to add the item in your mission or system: | Use following functions to add the item in your mission or system: | ||
*[[BIS_fnc_addCommMenuItem]] | * [[BIS_fnc_addCommMenuItem]] | ||
*[[BIS_fnc_removeCommMenuItem]] | * [[BIS_fnc_removeCommMenuItem]] | ||
Number of slots is limited to 10, no pagination is implemented. Larger number is an edge case, no mission should need as many supports. | Number of slots is limited to 10, no pagination is implemented. Larger number is an edge case, no mission should need as many supports. | ||
=== Expression Arguments === | === Expression Arguments === | ||
Following arguments are passed into the expression field: | Following arguments are passed into the expression field: | ||
[caller,pos,target,is3D, | [caller, pos, target, is3D, id] | ||
*'''caller''': [[Object]] - unit which called the item, usually [[player]] | * '''caller''': [[Object]] - unit which called the item, usually [[player]] | ||
*'''pos''': [[Array]] in format [[Position]] - cursor position | * '''pos''': [[Array]] in format [[Position]] - cursor position | ||
*'''target''': [[Object]] - cursor target | * '''target''': [[Object]] - cursor target | ||
*'''is3D''': [[Boolean]] - [[true]] when in 3D scene, [[false]] when in map | * '''is3D''': [[Boolean]] - [[true]] when in 3D scene, [[false]] when in map | ||
*''' | * '''id''': [[String]] - item ID as returned by [[BIS_fnc_addCommMenuItem]] function | ||
=== Submenu === | |||
<sqf>submenu = "#USER:MENU_COMMS_1"; // 'MENU_COMMS_1' is just a global variable, can be named anything</sqf> | |||
<sqf>showCommandingMenu '#USER:MENU_COMMS_1'; // if you wanted to show your custom menu on a keydown event or something</sqf> | |||
<sqf> | |||
MENU_COMMS_1 = | |||
[ | |||
// First array: "User menu" This will be displayed under the menu, bool value: has Input Focus or not. | |||
// Note that as of version Arma 3 1.05, if the bool value is set to false, Custom Icons will not be displayed. | |||
["MenuName", false], | |||
// Syntax and semantics for following array elements: | |||
// ["Title_in_menu", [assigned_key], "Submenu_name", CMD, [["expression",script-string]], "isVisible", "isActive" (, optional icon path)] | |||
// Title_in_menu: string that will be displayed for the player | |||
// Assigned_key: 0 - no key, 1 - escape key, 2 - key-1, 3 - key-2, ... , 10 - key-9, 11 - key-0, 12 and up... the whole keyboard | |||
// Submenu_name: User menu name string (eg "#USER:MY_SUBMENU_NAME" ), "" for script to execute. | |||
// CMD: (for main menu:) CMD_SEPARATOR -1; CMD_NOTHING -2; CMD_HIDE_MENU -3; CMD_BACK -4; (for custom menu:) CMD_EXECUTE -5 | |||
// script-string: command to be executed on activation. (_target=CursorTarget,_pos=CursorPos) | |||
// isVisible - Boolean 1 or 0 for yes or no, - or optional argument string, eg: "CursorOnGround" | |||
// isActive - Boolean 1 or 0 for yes or no - if item is not active, it appears gray. | |||
// optional icon path: The path to the texture of the cursor, that should be used on this menuitem. | |||
["Teleport", [2], "", -5, [["expression", "player setPos _pos;"]], "1", "1", "\A3\ui_f\data\IGUI\Cfg\Cursors\iconcursorsupport_ca.paa"], | |||
["Kill Target", [3], "", -5, [["expression", "_target setDamage 1;"]], "1", "1", "\A3\ui_f\data\IGUI\Cfg\Cursors\iconcursorsupport_ca.paa"], | |||
["Disabled", [4], "", -5, [["expression", ""]], "1", "0"], | |||
["Submenu", [5], "#USER:MENU_COMMS_2", -5, [], "1", "1"] | |||
]; | |||
MENU_COMMS_2 = | |||
[ | |||
["Submenu", false], | |||
["Option 1", [2], "", -5, [["expression", "hint 'Option 1';"]], "1", "1"], | |||
["Option 2", [3], "", -5, [["expression", "hint 'Option 2';"]], "1", "1"], | |||
["Option 3", [4], "", -5, [["expression", "hint 'Option 3';"]], "1", "1"] | |||
]; | |||
</sqf> | |||
==== Existing Submenus ==== | |||
Some of the existing submenus in {{arma3}}: | |||
{| class="wikitable" | |||
|- | |||
! Menu !! Menu Location | |||
|- | |||
| "#User:BIS_fnc_addCommMenuItem_menu" || Group/Reply communication menu /High Command Group reply menu | |||
|- | |||
| "#User:BIS_MENU_GroupCommunication" || High Command/UAV Reply communication menu | |||
|- | |||
| "#USER:BIS_VR_commMenu_1" || VR Training Mission menu | |||
|- | |||
| "#USER:HCWPWaitRadio" || High Command/UAV Waypoints waitRadio menu | |||
|- | |||
| "#USER:HCWPWaitUntil" || High Command/UAV Waypoints waitUnitl menu | |||
|- | |||
| "#USER:HC_Custom_0" || High Command/UAV Action menu | |||
|- | |||
| "#USER:HC_Missions_0" || High Command/UAV Missions menu | |||
|- | |||
| "#USER:HC_Targets_0" || High Command/UAV Targets menu | |||
|- | |||
| "#USER:BIS_fnc_kbMenu_menu" || Conversation menu | |||
|- | |||
| "#USER:BIS_MENU_SOM_SecOps" || Communication menu | |||
|- | |||
| "#USER:BIS_MENU_SOM_Support" || Communication Support menu | |||
|} | |||
{{GameCategory|arma3|Editing}} |
Latest revision as of 11:38, 6 May 2024
Communication menu is a commanding menu where support or mission requests are placed.
The player can access it using following means:
- Open the quick command menu ~ and select "Communication" item
- Press 8 then 1 (Reply - Communication)
Available items are announced upon adding by a notification and remain visualized as icons next to the commanding menu.
Configuration
Config
Communication menu items can be defined in config - global Config.cpp, Campaign Description.ext or mission Description.ext (searched in this order, the latter has the highest priority).
class CfgCommunicationMenu
{
class myArtillery
{
text = "Artillery Strike"; // Text displayed in the menu and in a notification
submenu = ""; // Submenu opened upon activation (expression is ignored when submenu is not empty.)
expression = "player setVariable ['BIS_SUPP_request', ['Artillery', _pos]];"; // Code executed upon activation
icon = "\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\artillery_ca.paa"; // Icon displayed permanently next to the command menu
cursor = "\a3\Ui_f\data\IGUI\Cfg\Cursors\iconCursorSupport_ca.paa"; // Custom cursor displayed when the item is selected
enable = "1"; // Simple expression condition for enabling the item
removeAfterExpressionCall = 1; // 1 to remove the item after calling
};
class menu_comms_1
{
text = "Menu Comms 1";
submenu = "#USER:MENU_COMMS_1"; // will open submenu that is defined as global variable MENU_COMMS_1
expression = "";
icon = "";
cursor = "";
enable = "1";
removeAfterExpressionCall = 0;
};
};
Available default icons:
- "\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\artillery_ca.paa"
- "\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\attack_ca.paa"
- "\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\call_ca.paa"
- "\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\cas_ca.paa"
- "\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\casheli_ca.paa"
- "\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\defend_ca.paa"
- "\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\instructor_ca.paa"
- "\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\mortar_ca.paa"
- "\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\supplydrop_ca.paa"
- "\a3\Ui_f\data\GUI\Cfg\CommunicationMenu\transport_ca.paa"
You can also preview pre-defined items using the Splendid™ Config Viewer.
Simple expressions
Expression | Effect | Tested |
---|---|---|
1 | Always available | ![]() |
0 | Always disabled | ![]() |
cursorOnGround | Only callable when pointing at a valid position | ![]() |
IsLeader | Player has to be the leader of his group | ![]() |
IsAlone | ![]() | |
IsAloneInVehicle | ![]() | |
IsCommander | ![]() | |
VehicleCommander | ![]() | |
CommandsToGunner | ![]() | |
CommandsToPilot | ![]() | |
NotEmpty | ![]() | |
NotEmptySoldiers | ![]() | |
NotEmptyCommanders | ![]() | |
NotEmptyMainTeam | ![]() | |
NotEmptyRedTeam | ![]() | |
NotEmptyGreenTeam | ![]() | |
NotEmptyBlueTeam | ![]() | |
NotEmptyYellowTeam | ![]() | |
NotEmptySubgroups | ![]() | |
NotEmptyInVehicle | ![]() | |
SelectedTeam | ![]() | |
SelectedUnit | ![]() | |
FuelLow | ![]() | |
AmmoLow | ![]() | |
Injured | ![]() | |
Multiplayer | ![]() | |
AreActions | ![]() | |
CursorOnGroupMember | ![]() | |
CursorOnHoldingFire | ![]() | |
CursorOnEmptyVehicle | ![]() | |
CursorOnVehicleCanGetIn | ![]() | |
CursorOnFriendly | ![]() | |
CursorOnEnemy | ![]() | |
CursorOnGround | ![]() | |
CanSelectUnitFromBar | ![]() | |
CanDeselectUnitFromBar | ![]() | |
CanSelectVehicleFromBar | ![]() | |
CanDeselectVehicleFromBar | ![]() | |
CanSelectTeamFromBar | ![]() | |
CanDeselectTeamFromBar | ![]() | |
FormationLine | ![]() | |
FormationDiamond | ![]() | |
SomeSelectedHoldingFire | ![]() | |
PlayableLeader | ![]() | |
PlayableSelected | ![]() | |
IsWatchCommanded | ![]() | |
IsSelectedToAdd | ![]() | |
HCIsLeader | ![]() | |
HCCursorOnIcon | ![]() | |
HCCursorOnIconSelectable | ![]() | |
HCCanSelectUnitFromBar | ![]() | |
HCCanDeselectUnitFromBar | ![]() | |
HCCanSelectTeamFromBar | ![]() | |
HCCanDeselectTeamFromBar | ![]() | |
HCNotEmpty | ![]() | |
PlayerVehicleCanGetIn | ![]() | |
IsXbox | ![]() | |
IsTeamSwitch | ![]() | |
CursorOnNotEmptySubgroups | ![]() | |
SomeSelectedHaveTarget | ![]() | |
CursorOnGroupMemberSelected | ![]() | |
HCCursorOnIconSelectableSelected | ![]() | |
HCCursorOnIconenemy | ![]() | |
PlayerOwnRadio | ![]() | |
CursorOnNeedFirstAID | ![]() | |
CursorOnNeedHeal | ![]() |
Adding
Use following functions to add the item in your mission or system:
Number of slots is limited to 10, no pagination is implemented. Larger number is an edge case, no mission should need as many supports.
Expression Arguments
Following arguments are passed into the expression field:
[caller, pos, target, is3D, id]
- caller: Object - unit which called the item, usually player
- pos: Array in format Position - cursor position
- target: Object - cursor target
- is3D: Boolean - true when in 3D scene, false when in map
- id: String - item ID as returned by BIS_fnc_addCommMenuItem function
Some of the existing submenus in Arma 3:
Menu | Menu Location |
---|---|
"#User:BIS_fnc_addCommMenuItem_menu" | Group/Reply communication menu /High Command Group reply menu |
"#User:BIS_MENU_GroupCommunication" | High Command/UAV Reply communication menu |
"#USER:BIS_VR_commMenu_1" | VR Training Mission menu |
"#USER:HCWPWaitRadio" | High Command/UAV Waypoints waitRadio menu |
"#USER:HCWPWaitUntil" | High Command/UAV Waypoints waitUnitl menu |
"#USER:HC_Custom_0" | High Command/UAV Action menu |
"#USER:HC_Missions_0" | High Command/UAV Missions menu |
"#USER:HC_Targets_0" | High Command/UAV Targets menu |
"#USER:BIS_fnc_kbMenu_menu" | Conversation menu |
"#USER:BIS_MENU_SOM_SecOps" | Communication menu |
"#USER:BIS_MENU_SOM_Support" | Communication Support menu |