SetWaterLevel
From Multi Theft Auto: Wiki
Sets the height of some or all the water in the game world.
Note: When the water level is 0, the standard GTA rendering is performed so that water is visible when viewed through translucent surfaces, such as vehicle windows. However, some MTA custom objects placed underwater will appear in front of the water. Setting the water level to any non-zero value (i.e. setWaterLevel(0.001) ) forces alternative rendering and MTA custom objects placed underwater will be drawn correctly. |
Syntax
bool setWaterLevel ( [water theWater,] float level )
bool setWaterLevel ( float level [, bool includeWaterFeatures = true, bool includeWaterElements = true ] )
OOP Syntax Help! I don't understand this!
- Method: water:setLevel(...)
- Variable: .level
- Counterpart: getWaterLevel
Required Arguments
- level: the new Z coordinate of the water surface. All water in the game world is set to this height.
Optional Arguments
- theWater: the water element to change.
or:
- includeWaterFeatures : a boolean indicating whether to also set the level of water features such as ponds and pools.
- includeWaterElements : a boolean indicating whether to also set the level of all water elements.
Returns
Returns true if successful, false in case of failure.
Alternate client-only syntax
Click to collapse [-]
Client onlybool setWaterLevel ( [float x, float y, float z,] float level )
Required Arguments
- level: the new Z coordinate of the water surface
Optional Arguments
The area of water containing that point or corresponding to that water element is changed.
- x: the X coordinate of the point indicating the water area to change.
- y: the Y coordinate of the point indicating the water area to change.
- z: the Z coordinate of the point indicating the water area to change. This parameter is reserved and is currently ignored, set it to 0.
Returns
Returns true if successful, false in case of failure (there is no water at the specified coordinates).
Example
Click to collapse [-]
ClientThis example code will slowly drain away all rivers and seas.
local level = 0 function drainSomeWater() level = level - 0.01 setWaterLevel ( level ) end setTimer ( drainSomeWater, 100, 15000 )
Click to collapse [-]
ServerThis example code will slowly drain away all rivers and seas.
local level = 0 function drainSomeWater() level = level - 0.01 setWaterLevel ( level ) end setTimer ( drainSomeWater, 100, 15000 )
This example code adds a command water which can be used to change the current water level.
addCommandHandler ( "water", function ( thePlayer, command, level ) if level and tonumber ( level ) then -- if we have input something and if it is actually a number value setWaterLevel ( tonumber( level ) ) -- change the water level outputChatBox ( "Waterlevel is now: " .. level ) -- send a message to everyone to inform about the change end end )
Issues
Issue ID | Description |
---|---|
#7542 | Water functions in general do not work outside the -3000 -3000 3000 3000 bounds |