v7 LightSystem

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!

Requires the LightSystem root prim script.

Place a single copy of this script in the root prim, not in each light prim.

The new LightSystem script allows you to assign prim faces for different light groups, assignable using touch-select via the MCH. These can be assigned single-faced prims like sculpties or multiple-face prim faces for mesh or standard prims. The system allows for quick assignment of prim faces. LightSystem removes the need for individual scripts for different lights and thereby lowers the overall script count of the average vehicle.

Upgrading from earlier ACS versions:

When updating a vehicle previously scripted with ACS, you will need to remove the ACS non-root-prim scripts for brake lights and other lights. You will need to use the MCH touch-select system to re-assign your lights.

When first installing the new ACS, it will convert your existing light and panel keyword-labelled prims to the new system to all faces of the prim.

Light Face Group Types

Headlights - turns on with the lights function from the menu or HUD, or automatically on ignition if Autolights is engaged. Any prim with headlight faces assigned also emanates light from the prim.

Brake Lights - activated when brake is applied or vehicle is stopped

Indicator Lights - left and right indicator light faces blink when turning.

Running Lights - Lights that are always on when the engine is running.

Control Panel - full bright prim faces while the Headlights are on.

Interior Light - Light faces that are activated when one or more of the doors are open. Not used if doors are not installed.

Reverse Lights - light faces activated in reverse gear.

Beam Faces - for light beams

Flight Faces - for flashing light(s) activated during flight mode.


Example for setting up headlights:

  • Make sure the LightSystem script is in the vehicle root
  • With the Mechanic Tool script in the vehicle, Touch the vehicle and connect the MCH
  • From the MCH main menu choose LIGHT SYSTEM
  • Select TOUCH SELECT LIGHT FACES and touch the prim faces for the headlight(s)
  • Exit back to the MAIN MENU to exit setup mode.

Now test the headlights by turning them on/off from the vehicle menu or Driver HUD

Repeat this process as needed for other light types.

Light Levels & Other Parameters

Adjust specific light settings values in the Root Settings script.

/Headlight and light glow settings
LightColor vector LSL color vector emanated light
LightIRF <1.0, 5.0, 0.5>; Default <1.0,5.0,0.0>, Light Intensity (0.0 - 1.0), Light Radius (0.1 - 20.0), Light Falloff (0.1 - 2.0).
BrakeLightColor vector LSL color vector emanated light
BrakeLightIRF <1.0, 5.0, 0.5>; //Default <1.0,5.0,0.0>, Light Intensity (0.0 - 1.0), Light Radius (0.1 - 20.0), Light Falloff (0.1 - 2.0).
Glow_Level 0.05; //0.0 to 1.0 GLOW level for LightSystem prim faces.
BeamAlpha 0.4; //0.1-1.0 Transparency level for visible light beam faces set up with LightSystem.
BeamGlow 0.05; //0.1-1.0 Glow level for visible light beam faces set up with LightSystem.
IndicatorSpeed 0.5; //Turning indicator flash speed.
FlightFlash 1.0; //Speed for flight lights flashing during flight mode, 0 to disable flash.

Things to Know

  • Once a group has been assigned to a prim face, you are free to unlink/relink the light prims and even move them between ACS v7+ scripted vehicles, as the light group assignment, as with the ColorSystem, is stored directly in the prim's properties, no script required beyond having the LightSystem in the root.
  • the LightSystem script is also used by the new Fixtures system.
  • You can assign different lights to different (or multiple) faces on the same prim.
  • To add pop-up/animated headlamps that activate when the engine is started, use the Ignition Prims function using the Accessories script.

[v7 Main]