Riouken / cTab

Public repository for cTab
GNU General Public License v2.0
15 stars 22 forks source link

cTab

Commander's Tablet - FBCB2, Blue Force Tracker, UAV, Helmet Cam and Messaging Interface Initially created by Riouken, currently maintained by Gundy

Thanks to

Features

Known Issues

Required

Optional

Media

Tablet BFT Tablet UAV night 3D models Vehicle FBCB2 TAD small TAD large night Android small Android large night MicroDAGR small MicroDAGR large cTab 1.0 release overview

Install

Place the @cTab and userconfig folders in your ArmA 3 folder (both on the server and the clients). Then start the game with @CBA_A3and @cTab. It can be done either by enabling the necessary mods in the game settings (Settings -> Expansions), or by adding the mod names to the game shortcut after the EXE file, i.e. ...\arma3.exe -mod=@CBA_A3;@cTab.

The keys folder is for the server key.

How to configure

Key Bindings

Key Bindings can now be configured via the CBA Keybinding system available to you from the configure controls screen once you are in game.

CONFIGURE > CONTROLS > CONFIGURE ADDONS
Select "cTab" from the ADDON dropdown

You can reconfigure the default keys in the configuration file, which can be found in the ArmA 3 folder ...\Arma 3\userconfig\cTab\ctab_settings.hpp. The file can be edited in Notepad or any other text editor. These are the default key bindings:

Keys Action
H This key is used to open and close whatever cTab device is available to you, showing the "small" version where available. It can also be used to close UAV view.
CTRL + H Opens and closes the secondary view mode of the cTab device available to you. This would usually be the "large" version.
ALT + H Opens and closes an alternative cTab device that you may have available (i.e. when a pilot carrying a tablet, this will open the tablet).
LEFT DOUBLE-CLICK Opens dialog to place markers at mouse cursor location. Not available on MicroDAGR
DEL Deletes the highlighted user placed marker under your cursor.
F1 Change to Blue Force Tracker on tablet.
F2 Change to UAV cameras on tablet.
F3 Change to helmet cameras on tablet.
F4 Change to Message mode on tablet.
F5 Toggles map tools (grid/elevation/range/direction to mouse cursor).
F6 Toggles map mode (satellite/topographical/black).
F7 Center map on current position.
CTRL + SHIFT + PAGE_UP Zoom in on the "small" TAD, MicroDAGR and Android.
CTRL + SHIFT + PAGE_DOWN Zoom out on the "small" TAD, MicroDAGR and Android.
CTRL + SHIFT + HOME Toggle interface position from left to right on the "small" TAD, MicroDAGR and Android. Reset all "large" interfaces to default position.
ESC Closes all interactive cTab devices (i.e. all but the "small" variants) as well as the UAV view.

Note: To unlock a UAV turret, use the lock / unlock control command available to UAVs (default CTRL + T) when controlling the UAV turret in full-screen mode (either via the UAV terminal or the UAV gunner view accessible from the tablet).

Define vehicle types that have FBCB2 or TAD available

To configure the list of vehicle types that have FBCB2 or TAD available, edit the cTab_vehicleClass_has_FBCB2 and cTab_vehicleClass_has_TAD arrays in the configuration file on the server, which can be found in the ArmA 3 folder ...\Arma 3\userconfig\cTab\ctab_settings.hpp.

class cTab_settings {
    cTab_vehicleClass_has_FBCB2[] = {"MRAP_01_base_F","MRAP_02_base_F","MRAP_03_base_F","Wheeled_APC_F","Tank","Truck_01_base_F","Truck_03_base_F"};
    cTab_vehicleClass_has_TAD[] = {"Helicopter","Plane"};
};

Note: This is a server-side setting, i.e. whatever is set on the client-side userconfig will be overridden by the userconfig on the server.

Define helmet classes with enabled helmet camera

To configure the list of helmet classes that enable helmet cameras, edit the cTab_helmetClass_has_HCam array in the configuration file on the server, which can be found in the ArmA 3 folder ...\Arma 3\userconfig\cTab\ctab_settings.hpp. It needs to be within the class cTab_settings (same area as above).

class cTab_settings {
    cTab_helmetClass_has_HCam = {"H_HelmetB_light","H_Helmet_Kerry","H_HelmetSpecB","H_HelmetO_ocamo","BWA3_OpsCore_Fleck_Camera","BWA3_OpsCore_Schwarz_Camera","BWA3_OpsCore_Tropen_Camera"};
};

Note: This is a server-side setting, i.e. whatever is set on the client-side userconfig will be overridden by the userconfig on the server.

For Mission Makers

Class Names

ItemcTab // Commander Tablet
ItemAndroid // Android based Blue Force Tracker
ItemcTabHCam // Helmet Cam
ItemMicroDAGR // MicroDAGR GPS

Add items to a box

Place this in the initialisation of an Ammo box to add 10 of each item:

this addItemCargo ["ItemcTab",10];this addItemCargo ["ItemcTabHCam",10];this addItemCargo ["ItemAndroid",10];this addItemCargo ["ItemMicroDAGR",10];

Add item to a unit directly

Place this in the initialisation of a soldier:

this addItem "ItemcTab";

Note: This will add the item to the actual inventory, but not assign it to the GPS slot. The unit will have to have enough space in its inventory to fit the item, otherwise it won't be assigned. addItem assigns the item to the next best inventory container that fits the item, in the order of uniform, vest and backpack. The Tablet (itemcTab) for example won't fit in most uniforms, so there has to be space in either the vest or backpack. Use addItemToBackpack to add the item directly to the unit's backpack and addItemToVest to directly assign it to the vest. To assign an item directly to the GPS slot (it has no space restrictions, but will still count towards the unit's total load), use ´linkItem´ instead.

This will for example assign the MicroDAGR to the GPS slot and place the Tablet into the unit's backpack:

this linkItem "ItemMicroDAGR";this addItemToBackpack "ItemcTab";

Set cTab side-specific encryption keys

If you wish multiple factions to share cTab data, you will have to set their encryption keys to be the same. These are the variables that hold the encryption keys with their default values:

cTab_encryptionKey_west = "b";
cTab_encryptionKey_east = "o";
cTab_encryptionKey_guer = "i";
cTab_encryptionKey_civ = "c";

Note: It is advised to keep the encryption keys as short as possible since some actions use them to exchange data across the network, so by keeping them short, there is less data exchanged.

So if you want to have for example OPFOR and GUER share cTab data, put this at the TOP of your init.sqf:

// set GUER encryption key to be the same as the default BLUEFOR encryption key
cTab_encryptionKey_guer = "b";

Note: If GUER is set to be friendly with either WEST or EAST, GUER will by default have the same encryption key as the friendly faction. Set cTab_encryptionKey_guer = "i"; to override.

Override vehicle types that have FBCB2 or TAD available

If you wish to override the list of vehicles that have FBCB2 or TAD available, put this at the TOP of your init.sqf:

// only make FBCB2 available to MRAPs, APCs and tanks
cTab_vehicleClass_has_FBCB2 = ["MRAP_01_base_F","MRAP_02_base_F","MRAP_03_base_F","Wheeled_APC_F","Tank"];

// make TAD available to all helicopters and planes with the exception of the MH-9 Hummingbird and AH-9 Pawnee
cTab_vehicleClass_has_TAD = ["Heli_Attack_01_base_F","Heli_Attack_02_base_F","Heli_Light_02_base_F","Heli_Transport_01_base_F","Heli_Transport_02_base_F","I_Heli_light_03_base_F","Plane"];

Override helmet classes with enabled helmet camera

// Only have BWmod helmets with a camera simulate a helmet camera
cTab_helmetClass_has_HCam = ["BWA3_OpsCore_Schwarz_Camera","BWA3_OpsCore_Tropen_Camera"];

Change display name of a group

Groups are displayed on cTab devices with their groupIDs. To define custom groupIDs, add the following code to the group leader's initialization:

// Change the unit's groupID to "Red Devils"
this setGroupId ["Red Devils"];

Change display name of a vehicle

By default all vehicles will be shown with their group names next to them. This can make it difficult to distinguish multiple vehicles of the same type when they are in the same group. To change that, use the following code in the vehicle's initialization:

// Change this vehicle's identification displayed on all cTab Blue Force Trackers to "Fox"
this setVariable ["cTab_groupId","Fox",true];

Changelog

2.2.2

2.2.1

2.2.0

2.1.1

2.1.0

2.0.1

2.0.0

Download / Links

Armaholic ArmA World withSix BI Forum GitHub