Doc_Halo1_BSPModifiers

BSP Modifiers

The BSP modifier system allows you to switch between different lightmaps and skies on a BSP using HaloScript. It is also how you add the lightmaps required for the directional lightmap shader extension. The tag data for BSP modifiers is at the bottom of the scenario tag.

BSP Modifiers

The base modifier block lets you choose which BSP to modify.

Field	Type	Usage
bsp index	block index	The BSP index to modify.

Lightmap Sets

A lightmap set is a group of lightmaps to use on a BSP. If any lightmap set's are added for a BSP, the first in the list will be the default set used, and it's values will automatically override the lightmap in the BSP tag. Directional lightmaps require 3 separate lightmaps and your map will not compile without all 3.

To change lightmap sets, use the structure_bsp_set_lightmap_set function.

Field	Type	Usage
name	string	The name of the lightmap set. Used in HaloScript when changing lightmap set.
std. lightmap	tag reference	The lightmap to use when DLM's are not used or disabled. This will override the BSP's lightmap.
dir. lightmap 1	tag reference	The first lightmap component for directional lightmaps.
dir. lightmap 2	tag reference	The second lightmap component for directional lightmaps.
dir. lightmap 3	tag reference	The third lightmap component for directional lightmaps.

Sky Sets

A sky set is a groups of sky overrides to apply to a BSP.

To change sky sets, use the structure_bsp_set_sky_set function.

Field	Type	Usage
name	string	The name of the sky set. Used in HaloScript when changing sky set.
sky index	block index	The sky index to override.
sky	tag reference	The sky to use.