======Set Group Light Color======
----

Changes the color of the light attached to any [[entity|entities]] in the specified [[groups|group]] over a duration of time (with the assumption that each [[entity]] is a light source).

====Signature:====
<code python>
set_group_light_color(group_name, color, duration)
</code>

^Argument^Description^Type^Required^
|group_name|[[groups|Group]] of [[entity|entities]] that will have their light [[color]] changed.|[[String]]|Yes|
|color|New [[color]] for the lights.|[[Color]]|Yes|
|duration|Fade duration from their current [[color]] to the new [[color]].|[[Number]]|No|

<WRAP center round info 100%>
If you'd like to instantly toggle the [[entity]] [[groups|group's]] lights on or off instead of changing their [[color]], see the related [[Set Group Light Enabled]] function.
</WRAP>

====Example:====
<code bauxite>
set_group_light_color("torches", color[255, 0, 0], 1);
</code>
//Results:// All [[entity|entities]] in the "torches" [[groups|group]] will have the [[color]] of their light change to red over a duration of one second.

<WRAP center round tip 100%>
Use the **Set Group Light Color** function to dim/brighten all lamps in a room or to emulate multi-color lights (like an LED on an electronic device).
</WRAP>

<WRAP group>
<WRAP half column>
====Editor Node:====
{{:wiki:set_group_light_color_node.png?nolink|}}
</WRAP>

<WRAP half column>
====Visual Demo:====
{{:wiki:set_group_light_color_demo.gif?nolink|}}
</WRAP>
</WRAP>

~~NOTOC~~