|LSL Portal||Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials|
The llReplaceAgentEnvironment function overrides the current region and parcel environment seen by an agent. The new environment persists until the agent crosses to a new region or this function is called with the NULL_KEY or empty string in the environment parameter for the particular agent, doing so will strip all environmental settings applied to this agent as part of the experience. This function must be executed as part of an experience.
Returns an Integer
|• key||agent_id||–||The key for an agent in the region. The agent must be in the region and must be participating in the experience.|
|• float||transition||–||The number of seconds over which to transition to the new settings.|
|• string||environment||–||The name of an environmental setting in the object's inventory or the asset ID for an environment.|
|1||The agent has been instructed to change their environment.|
|ENV_NOT_EXPERIENCE||-1||The script is not running as part of an experience with a valid experience key.|
|ENV_NO_EXPERIENCE_PERMISSION||-2||The agent has not granted permission.|
|ENV_NO_ENVIRONMENT||-3||The environment inventory object could not be found.|
|ENV_INVALID_AGENT||-4||Unable to find specified agent.|
|ENV_NO_EXPERIENCE_LAND||-7||The experience has not been enabled or can not run on the land.|
|ENV_THROTTLE||-8||The scripts have exceeded the throttle. Wait and retry the request.|
- The agent's viewer may choose to ignore this command.
- An environment set locally on the viewer will override any environment set from this function.
- If a UUID is passed as the environment parameter and that UUID does not specify an environment setting, the viewer quietly ignores the instruction.
function Integer llReplaceAgentEnvironment( key agent_id, float transition, string environment );