Combat (BETA)

v7 beta documentation in progress. v7 beta documentation may be incomplete or inaccurate.
v7 functions and features may be significantly different from previous ACS versions.
These instructions are not valid for current v6+ ACS!

This system allows you to patch in the built-in driver firing key combination to an add-on combat system such as VICE.

Currently no passenger firing controls have yet been added for ACS Passenger Prim, expect these to come in time. In the meantime you will have to use your own passenger sit scripts with firing control.

Firing the primary driver weapon control can be done with any of these key combination (all the same control interface settings):

Back Arrow + C
Back Arrow + PageDown
S + C
S + PageDown

Also, left mouse button (not in mouselook mode)

The weapon can also be discharged using the Fire command, issued from a Driver HUD or using Gesture Control.

In the Root Settings script you define variables for the link messages to be sent to your combat system.

The key combo sends a single trigger to your weapons system. For K Damage, this discharges the default weapon(s) a single time. K Damage requires no additional settings or scripts other than the K Damage scripts themselves and the default settings for the fire controls in the Root Settings

For VICE, the single trigger turns on automatic fire, and must be shut off afterwords using a second command to stop the firing. ACS enables this shutoff message with the addition of the Burst Control script. In Root Settings you can define the shut-off message and length after firing before the shut-off is sent to the weapons.

At the top of Root Settings you will see:

integer         firechan = 3000;
string          firemessage = "gun ctrl"; 
integer         supresschan =       0; 
string          supressmessage =    "gun ctrl";
float           burstlength =       0.5;

To discharge the primary driver weapon a single time in K Damage, a blank message is sent on channel 3000 (firechan variable). No additional messages required.

To discharge the primary VICE weapon, the message "gun_ctrl" (firemessage variable) must be sent on channel 1 (firechan variable) to begin weapons fire, and for automatic weapons, "gun_ctrl" (supressmessage variable) must be sent on channel 0 (supresschan variable) to stop the weapons fire. A system that requires the supress/shutoff message needs the additional ACS BurstControl script in the root, this script has its own timer to issue the suppress message after the burstlength timer has run down.

TERRA combat system

For use with Cubey Terra's TERRA combat system, use the v7.0 TERRA Engine, which has the special TERRA firing built in. Install the TERRA scripts as normal, but no need to modify the ACS engine.