Catching Features



ENV File Reference

The ENV file is an optional configuration file for your map that lets you adjust some global environment options. You can control the weather, the skybox, and ski-o mode.

The weather and skybox options have been in the game since version 1.2 or so, the ski-o mode option requires version 1.403

Syntax

The file is a text file in your map directory ("maps/YourMapName/map.env"), and might look something like this:

=weather=
nosun=1
norain=1

=skybox=
daysnow_pre=comps/snowyville/grey
daysnow_ext=tga

=model=
ski=1

That one is specific to my map, because it references the /snowyville/ directory for the skybox. (so don't copy it directly!) It forces the weather to snow all the time, uses my custom skybox texture, and puts the game models into ski-o mode.

Here is each section in more detail:

Weather

The weather section allows you to control the available weather options (sun / rain / snow). Normally weather is chosen randomly, but you can prohibit certain types of weather that you don't want with the three options:

=weather=
nosun=0
norain=0
nosnow=0

So to force it to rain all the time, use nosun and nosnow:

=weather=
nosun=1
norain=0
nosnow=1

To force it to never snow, but choose randomly between sun and rain, just use nosnow:

=weather=
nosun=0
norain=0
nosnow=1

Skybox

This section lets you control the skybox textures used for each weather pattern. If you don't know how to make skybox cubemaps, you can just skip this section (Everything in the ENV file is optional).

There are 12 available keys for this section:

=skybox=
daysun_pre=sky/blue
daysun_ext=jpg

dayrain_pre=sky/rain
dayrain_ext=jpg

daysnow_pre=sky/rain
daysnow_ext=jpg

nightsun_pre=sky/black
nightsun_ext=jpg

nightrain_pre=sky/black
nightrain_ext=jpg

nightsnow_pre=sky/black
nightsnow_ext=jpg

Each section is optional, and if you leave it out the game will just use the normal default. All of the "_pre" keys are the filename prefix, and the "_ext" is the extension. A skybox needs six textures, one for each direction, and the filenames have to match the correct letters for each direction. Use this one if you want to test things out.

To use a custom skybox (not one of the three defaults), put the six textures in YOUR map directory (NOT the sky directory), then add the =skybox= field for the weather you want to use it for. If you put the textures into the sky directory, they won't get uploaded into the comps system and your map will probably crash.

Let say we want to use the text skybox above during the sunny parts of the game, on my map thats called SkyboxTestMap. Unzip the six skybox textures into "maps/SkyboxTestMap/", then put this in the "maps/SkyboxTestMap/map.env" file:

=skybox=
daysun_pre=comps/SkyboxTestMap/test

Make sure you use "comps" not "maps", even though its in the map directory. This makes it work for the comps system (and also single player). Note that we don't need to include a "_ext" key, because its using the default of "jpg".

Model

This is a short section that only controls ski-o mode for now. If you want to replace all of the models in the game with people on skis, add this:

=model=
ski=1