SetAircraftMaxVelocity: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 2: Line 2:
{{Server client function}}
{{Server client function}}
{{New feature/item|4.0132|1.3.1|5000|
{{New feature/item|4.0132|1.3.1|5000|
This function sets the maximum velocity at which aircrafts could fly. Default value is 1.5 (around 276 km/h). Only positive values, including 0, are accepted. Using this function server-side will overwrite the value that was previously set client-side.
This function sets the maximum velocity at which aircrafts could fly. Using this function server-side will overwrite the value that was previously set client-side.
}}
}}


==Syntax==
==Syntax==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool setAircraftMaxVelocity ( float fVelocity )
bool setAircraftMaxVelocity ( float velocity )
</syntaxhighlight>
</syntaxhighlight>
===Required Arguments===
*'''velocity:''' The max velocity, can be 0 or any positive value. Default is '''1.5'''.


===Returns===
===Returns===

Revision as of 15:16, 8 February 2013

ADDED/UPDATED IN VERSION 1.3.1 r5000:

This function sets the maximum velocity at which aircrafts could fly. Using this function server-side will overwrite the value that was previously set client-side.

Syntax

bool setAircraftMaxVelocity ( float velocity )

Required Arguments

  • velocity: The max velocity, can be 0 or any positive value. Default is 1.5.

Returns

Returns true if the max velocity was set correctly, false otherwise.

Example

Click to collapse [-]
Client

This example will increase or decrease the max velocity by pressing numpad keys + or -.

function handleKeyboard( key, state )

    if state then

        if key == "num_add" then

            local fMaxVelocity = getAircraftMaxVelocity() + 0.1

            if setAircraftMaxVelocity( fMaxVelocity ) then
                outputChatBox( string.format( "Max velocity set to %.1f", fMaxVelocity ))
            else
                outputChatBox( string.format( "Unable to set max velocity to %.1f", fMaxVelocity ) )
            end

        elseif key == "num_sub" then

            local fMaxVelocity = getAircraftMaxVelocity() - 0.1

            if setAircraftMaxVelocity( fMaxVelocity ) then
                outputChatBox( string.format( "Max velocity set to %.1f", fMaxVelocity ) )
            else
                outputChatBox( string.format( "Unable to set max velocity to %.1f", fMaxVelocity ) )
            end
        end
    end
end

addEventHandler( "onClientKey", root, handleKeyboard )
Click to collapse [-]
Server

This example will double the max velocity for everyone when the resource is started.

function handleResourceStart( )
    setAircraftMaxVelocity( 3 )
end
addEventHandler( "onResourceStart",  resourceRoot, handleResourceStart )

See Also