Difference between revisions of "SetWaterLevel"

From Multi Theft Auto: Wiki
m (Undo revision 19465 by Arc (Talk))
m (Modified setWaterLevel to remove x,y,z server side)
Line 5: Line 5:
  
 
==Syntax==
 
==Syntax==
 +
<section name="Server" class="server" show="true">
 +
<syntaxhighlight lang="lua">bool setWaterLevel ( [water theWater], float level )</syntaxhighlight>
 +
 +
===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.
 +
 +
===Returns===
 +
Returns ''true'' if successful, ''false'' in case of failure.
 +
</section>
 +
 +
<section name="Client" class="client" show="true">
 
<syntaxhighlight lang="lua">bool setWaterLevel ( [float x, float y, float z,] float level )
 
<syntaxhighlight lang="lua">bool setWaterLevel ( [float x, float y, float z,] float level )
 
bool setWaterLevel ( [water theWater], float level )</syntaxhighlight>
 
bool setWaterLevel ( [water theWater], float level )</syntaxhighlight>
Line 21: Line 35:
 
===Returns===
 
===Returns===
 
Returns ''true'' if successful, ''false'' in case of failure (there is no water at the specified coordinates).
 
Returns ''true'' if successful, ''false'' in case of failure (there is no water at the specified coordinates).
 +
</section>
  
 
==Example==  
 
==Example==  
Line 36: Line 51:
 
</section>
 
</section>
 
<section name="Server" class="server" show="true">
 
<section name="Server" class="server" show="true">
 +
This example code will slowly drain away all rivers and seas.
 +
<syntaxhighlight lang="lua">
 +
local level = 0
 +
 +
function drainSomeWater()
 +
    level = level - 0.01
 +
    setWaterLevel ( level )
 +
end
 +
setTimer ( drainSomeWater, 100, 15000 )
 +
</syntaxhighlight>
 +
 
This example code adds a command ''water'' which can be used to change the current water level.
 
This example code adds a command ''water'' which can be used to change the current water level.
 
<syntaxhighlight lang="lua">
 
<syntaxhighlight lang="lua">

Revision as of 22:29, 8 May 2009

Sets the height of some or all the water in the game world.

Syntax

Click to collapse [-]
Server
bool setWaterLevel ( [water theWater], float level )

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.

Returns

Returns true if successful, false in case of failure.

Click to collapse [-]
Client
bool setWaterLevel ( [float x, float y, float z,] float level )
bool setWaterLevel ( [water theWater], float level )

Required Arguments

  • level: the new Z coordinate of the water surface. If x, y and z, or water, are specified, the area of water containing that point or corresponding to that water element is changed. Otherwise, all water in the game world is changed.

Optional Arguments

  • 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.

or:

  • theWater: the water element to change.

Returns

Returns true if successful, false in case of failure (there is no water at the specified coordinates).

Example

Click to collapse [-]
Client

This 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 [-]
Server

This 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
)

See Also