LSL Guide

string wolfEnvironmentSet(integer scope, list rules)

Change parts of the region's (WOLF_ENV_REGION) or this parcel's (WOLF_ENV_PARCEL) Wolf Environment with WOLF_ENV_* key/value rules; what is not named stays as it is. Checked by the same rules as the Wolf Environment window. The object's owner must hold the region (region) or own the parcel (parcel). Returns "" when done, otherwise the reason.

Changes the Wolf Environment of the whole region, or of the parcel this object is over, from a script: day or night, a storm, snow or fog, an alien sky, a sped-up day. Name only what you want changed; everything else stays as it is. If there was no Wolf Environment yet, the change starts from the same default the window starts from (London's real sky and weather). Every change is checked by the grid with exactly the rules of the Wolf Environment window, so a script can set nothing the window could not - a bad value is refused and the answer says which. The script acts for the object's owner. For the region the owner must be the estate owner, an estate manager or a grid god. For a parcel the owner must own it (or have the group's "change environment" power on a group parcel, or deed the object to that group), or run the region; the estate must allow parcel environments, and the region must allow parcels their own weather. Changes take effect in a few seconds, for every viewer. An object may make 3 changes and then one every 10 seconds; all of one owner's objects on a region 6 and then one every 15 seconds; a region 10 and then one every 10 seconds. The same settings twice count as done without making the region redraw its sky. Returns "" when done, otherwise the reason (also in wolfGetLastError).

Parameters

The rules list

Key/value pairs in any order, each key once. The keys are constants, so a misspelt key does not compile. A value the window would not accept is refused rather than changed, and the answer (and wolfGetLastError) says which.

default
{
    touch_start(integer n)
    {
        if (llDetectedKey(0) != llGetOwner()) return;   // it acts with YOUR rights
        // Night, a thunderstorm, and rough water.
        string why = wolfEnvironmentSet(WOLF_ENV_REGION, [
            WOLF_ENV_TIME_HOUR, 23.0,
            WOLF_ENV_WEATHER_TYPE, "storm",
            WOLF_ENV_WATER, "stormy"
        ]);
        if (why != "") llOwnerSay("Refused: " + why);
    }
}

wolfEnvironmentSet(WOLF_ENV_REGION, [WOLF_ENV_PLACE_KIND, "real",
    WOLF_ENV_PLACE_NAME, "Reykjavik", WOLF_ENV_PLACE_LAT, 64.15, WOLF_ENV_PLACE_LON, -21.94,
    WOLF_ENV_TIME_MODE, "real", WOLF_ENV_WEATHER_SOURCE, "live"]);

wolfEnvironmentSet(WOLF_ENV_REGION, [WOLF_ENV_PRESET, "alien",
    WOLF_ENV_MOOD_TINT, "custom", WOLF_ENV_MOOD_COLOR, <0.4, 1.0, 0.7>, WOLF_ENV_MOOD_STRENGTH, 25]);

wolfEnvironmentSet(WOLF_ENV_REGION, [WOLF_ENV_DAY_HOURS, 4.0, WOLF_ENV_WEATHER_PATTERN, "changeable"]);

wolfEnvironmentSet(WOLF_ENV_PARCEL, [WOLF_ENV_WEATHER_TYPE, "fog", WOLF_ENV_HAZE, 60]);

wolfEnvironmentSet(WOLF_ENV_REGION, [WOLF_ENV_SKY,
    "{\"night\":{\"stars\":250},\"suns\":[{\"id\":\"sun\",\"color\":\"#ff6040\",\"size\":180}]}"]);

wolfEnvironmentSet(WOLF_ENV_REGION, [WOLF_ENV_CLOUDS, -1]);

Ours alone. Grid features you will not find on any other OpenSimulator grid.