Multi Theft Auto: Wiki - User contributions [en]

RU/addAccount

2015-02-09T07:53:47Z

Kernell: Не также, а является именно статической

{{RU/Server function}}
__NOTOC__
Данная функция добавляет [[аккаунт]] на сервер.

==Синтаксис==
<syntaxhighlight lang="lua">
account addAccount ( string name, string pass )
</syntaxhighlight>
{{RU/OOP|Данная функция является статической функцией класса Account.|[[Account]].add||}}
===Обязательные аргументы===
*'''name:''' Имя аккаунта, который вы хотите добавить, обычно это имя игрока.
*'''pass:''' Пароль от аккаунта.

===Возвращает===
Возвращает [[аккаунт]] или ''false'', если аккаунт уже существует.

===Ограничения===
*'''name:'''
** Минимальная длина имени аккаунта - 1 символ.
** Имена аккаунтов чувствительны к регистру.
** Имя аккаунта не может быть "*****"
*'''pass:'''
** Минимальная длина пароля аккаунта - 1 символ.
** Максимальная длина пароля аккаунта - 30 символов.
** Пароль от аккаунта не может быть "*****"

==Пример==
<section name="Сервер" class="server" show="true">
'''Пример 1:''' Этот пример показывает регистрацию на сервере командой /register <password>.
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, password )
-- Проверим не пустой ли пароль
if ( password ~= "" and password ~= nil ) then
-- Попытаемся добавить учетную запись
local accountAdded = addAccount( getPlayerName(source), password )
if ( accountAdded ) then
-- Сообщим пользователю
outputChatBox ( "Спасибо, " .. getPlayerName(source) .. ", теперь вы зарегистрированы, вы можете войти используя /login", source )
else
-- Сообщим пользователю то, что он ошибся при вводе
outputChatBox ( "Ошибка в создании аккаунта, свяжитесь с администратором.", source )
end
else
-- Покажем пользователю как нужно вводить
outputChatBox ( "Ошибка в создании аккаунта, правильный синтаксис: /register <пароль>", source )
end
end
addCommandHandler ( "register", registerPlayer ) -- создадим команду /register
</syntaxhighlight>
'''Пример 2:''' Этот пример показывает регистрацию на сервере командой /register <password>.
'''Этот пример отличается от первого тем, что в нем пользователь может задать себе имя.'''
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, username, password )
if(password ~= "" and password ~= nil and username ~= "" and username ~= nil) then
local accountAdded = addAccount(username,password)
if(accountAdded) then
outputChatBox("Спасибо, " .. getPlayerName(source) .. ", теперь вы зарегистрированы, вы можете войти используя /login",source)
else
outputChatBox("Ошибка в создании аккаунта, свяжитесь с администратором.",source)
end
else
outputChatBox("Ошибка в создании аккаунта, правильный синтаксис: /register <nick> <pass>",source)
end
end
addCommandHandler ( "register", registerPlayer ) -- создадим команду /register
</syntaxhighlight>

'''Пример 3:''' Этот пример показывает регистрацию на сервере командой /register <password>.
<syntaxhighlight lang="lua">
local bRegisteredOnce = false

function registerPlayer ( source, commandName, username, password )
if(password ~= "" and password ~= nil and username ~= "" and username ~= nil and bRegisteredOnce == false) then
local accountAdded = addAccount(username,password)
if(accountAdded) then
outputChatBox("Спасибо, " .. getPlayerName(source) .. ", теперь вы зарегистрированы, вы можете войти используя /login",source)
bRegisteredOnce = true
else
outputChatBox("Ошибка в создании аккаунта, свяжитесь с администратором.",source)
end
else
if bRegisteredOnce == true then
outputChatBox("Вы уже зарегистрированы на сервере!",source)
else
outputChatBox("Ошибка в создании аккаунта, правильный синтаксис: /register <nick> <pass>",source)
end
end
end
addCommandHandler ( "register", registerPlayer ) -- создадим команду /register
</syntaxhighlight>
</section>

==Смотрите также==
{{RU/Account_functions}}

[[en:addAccount]]
[[es:addAccount]]

GetEasingValue

2014-02-19T15:09:38Z

Kernell: "Lua" is right, but not "LUA"! http://www.lua.org/about.html

__NOTOC__
{{Server client function}}

Used for custom Lua based interpolation, returns the easing value (animation time to use in your custom interpolation) given a progress and an [[Easing|easing function]].
In most cases, either [[moveObject]] or [[interpolateBetween]] can do the job. getEasingValue is only provided in case you want to do your own custom interpolation based on easing.

==Syntax==
<syntaxhighlight lang="lua">float getEasingValue( float fProgress, string strEasingType [, float fEasingPeriod, float fEasingAmplitude, float fEasingOvershoot] )</syntaxhighlight>

===Required Arguments===
*'''fProgress:''' float between 0 and 1 indicating the interpolation progress (0 at the beginning of the interpolation, 1 at the end).
*'''strEasingType:''' the [[Easing|easing function]] to use for the interpolation

===Optional Arguments===
*'''fEasingPeriod:''' the period of the [[Easing|easing function]] (only some easing functions use this parameter)
*'''fEasingAmplitude:''' the amplitude of the [[Easing|easing function]] (only some easing functions use this parameter)
*'''fEasingOvershoot:''' the overshoot of the [[Easing|easing function]] (only some easing functions use this parameter)

===Returns===
Returns ''fAnimationTime '' the animation time given by the easing function (can be < 0 or > 1 since some [[Easing|easing functions]] have overshoot or bounce/spring effects, ''false'' otherwise (error in parameters).

== Example ==
The example below is only clientside examples even though the function can be used on both sides. Indeed it makes more sense to use it with onClientRender/onClientPreRender but the freedom is given to use it in any other context.
<section name="Client" class="client" show="true">
This clientside example uses getEasingValue to make a custom camera fade.
The command to test it is "/fade".
The fading out is done with "InQuad" to have a slow fading which then accelerates and "OutQuad" is used for fading in to have a smooth end of the fading.
In this example [[interpolateBetween]] could have been used directly to interpolate the alpha between 0 and 255 and then 255 and 0 but is example is just to illustrate the use of getEasingValue by itself.
<syntaxhighlight lang="lua">
local g_Fade = nil
addCommandHandler("fade",
function ()
if g_Fade then return end
g_Fade = {}
g_Fade.startTime = getTickCount()
g_Fade.endTime = g_Fade.startTime + 2000
g_Fade.easingFunction = "InQuad" --Slow at first and accelerating
addEventHandler("onClientRender", getRootElement(), fadeCameraOut)
end)

function fadeCameraOut()
local now = getTickCount()
local elapsedTime = now - g_Fade.startTime
local duration = g_Fade.endTime - g_Fade.startTime
local progress = elapsedTime / duration

local fAnimationTime = getEasingValue(progress, g_Fade.easingFunction)

local alpha = fAnimationTime*255
local width, height = guiGetScreenSize()
dxDrawRectangle(0, 0, width, height, tocolor(0, 0, 0, alpha), true)

if now > g_Fade.endTime then
removeEventHandler("onClientRender", getRootElement(), fadeCameraOut)
g_Fade.startTime = getTickCount()
g_Fade.endTime = g_Fade.startTime + 2000
g_Fade.easingFunction = "OutQuad" --Fast at first then decelerating
addEventHandler("onClientRender", getRootElement(), fadeCameraIn)
end
end

function fadeCameraIn()
local now = getTickCount()
local elapsedTime = now - g_Fade.startTime
local duration = g_Fade.endTime - g_Fade.startTime
local progress = elapsedTime / duration

local fAnimationTime = getEasingValue(progress, g_Fade.easingFunction)

local alpha = (1-fAnimationTime)*255
local width, height = guiGetScreenSize()
dxDrawRectangle(0, 0, width, height, tocolor(0, 0, 0, alpha), true)

if now > g_Fade.endTime then
removeEventHandler("onClientRender", getRootElement(), fadeCameraIn)
g_Fade = nil
end
end
</syntaxhighlight>
</section>

==See Also==
{{Utility functions}}

SetCursorAlpha

2013-11-06T19:41:06Z

Kernell: /* Syntax */

{{client function}}
This function is used to change alpha (transparency) from the client's cursor.

==Syntax==
<syntaxhighlight lang="lua">
bool setCursorAlpha( int alpha )
</syntaxhighlight>

===Required Arguments===
*'''alpha ''': The alpha value to set. Value can be 0-255, where 255 is fully opaque and 0 is fully transparent.

===Returns===
Returns ''true'' if the new alpha value was set, or ''false'' otherwise.

==Requirements==
{{Requirements|n/a|1.3.2}}

==Example==
<syntaxhighlight lang="lua">
-- Simple command to test the setCursorAlpha function
addCommandHandler( "cursorAlpha",
function ()
-- Show the cursor if it is not showing or hide the cursor if it is
showCursor( not isCursorShowing ( ) )
-- Set the alpha to 100
setCursorAlpha(100)
end
)
</syntaxhighlight>

==See Also==
{{GUI_functions}}

Template:Comparison of Versions

2013-05-05T12:38:49Z

Kernell: Lua (pron.: /ˈluːə/ LOO-ə, from Portuguese: lua [ˈlu.(w)ɐ] meaning "moon"; explicitly not "LUA") - http://en.wikipedia.org/wiki/Lua_(programming_language)

{| class="wikitable" style="width: auto; text-align: center; table-layout: fixed;"
|+ Comparison of MTA Versions
! style="width: 100px;" |
! Version
! GTA Version(s)
! Release Date
! Support Status
! Works on Windows Vista and higher
! Core
! Client Type
! License
! Synchronization
! Max Players Per Server
! Gamemodes
! Scripting
! Frame limit
! Map Editor
|-
! Multi Theft Auto 0.5
| 0.5
| III, Vice City
| January 31, 2005
| {{Partial|Community}}
| {{Yes}}
| 0.3
| External
| {{Partial|Freeware}}
| {{Partial|Basic (Vehicle and on-foot)}}
| 32
| [[MTA:VC Deathmatch Gamemode|DM (VC)]], [[MTA:VC Stunt Gamemode|Stunt (VC)]], [[GTA3 SSV]], [[GTA3 Portland]], [[GTA3 Staunton]]
| External ([[MTA:mA]])
| User defined (On/Off)
| {{No}}
|-
! MTA:SA Race
| 1.1.2
| San Andreas
| May 18, 2008
| {{No|Unsupported}}
| {{No}}
| [[Blue]]
| In-game
| {{Partial|Freeware}}
| {{Partial|Vehicles only}}
| 32
| Race, Freeroam, Destruction Derby
| External (MTA:mA)
| Fixed
| {{Yes}}
|-
! MTA:SA
| [[Changes in {{padleft:|5|{{Current Version|full}}}}|{{padleft:|5|{{Current Version|full}}}}]]
| San Andreas
| May 5, 2013
| {{Yes|Supported}}
| {{Yes}}
| Blue
| In-game
| {{Yes|GPLv3}}
| {{Yes|Fully Synchronized}}
| 4096
| Custom
| [[Scripting Introduction|Build-in Lua]]
| Server owner defined
| {{Yes|[[Resource:Editor|Yes+]]}}
|-
|}

RU/copyAccountData

2012-08-02T11:39:50Z

Kernell:

__NOTOC__
{{Server function}}
Эта функция используется для копирования данных между двумя аккаунтами

==Использование==
<syntaxhighlight lang="lua">
bool copyAccountData ( account targetAccount, account fromAccount )
</syntaxhighlight>

===Обязательные параметры===
*'''targetAccount:''' Целевой аккаунт
*'''fromAccount:''' Исходный аккаунт

===Что возвращается===
Возвращает ''true'' если аккаунты были корректными, в противном случае ''false''

==Пример==
Этот пример иллюстрирует использование функции copyAccountData
<syntaxhighlight lang="lua">
function copyDataOnLogin( previousAccount, currentAccount, autoLogin )
copyAccountData( currentAccount, previousAccount ) -- Копируем данные с предыдущего аккаунта (previousAccount) на текущий (currentAccount)
end

addEventHandler( "onPlayerLogin", root, copyDataOnLogin ) -- Добавляем обработчик события авторизации игрока

</syntaxhighlight>

==Смотри также==
{{Account_functions}}
[[en:copyAccountData]]

RU/copyAccountData

2012-08-02T11:38:40Z

Kernell:

__NOTOC__
{{Server function}}
Эта функция используется для копирования данных между двумя аккаунтами

==Использование==
<syntaxhighlight lang="lua">
bool copyAccountData ( account targetAccount, account fromAccount )
</syntaxhighlight>

===Обязательные параметры===
*'''targetAccount:''' Целевой аккаунт
*'''fromAccount:''' Исходный аккаунт

===Что возвращается===
Возвращает ''true'' если аккаунты были корректными, в противном случае ''false''

==Пример==
Этот пример иллюстрирует использование функции copyAccountData
<syntaxhighlight lang="lua">
function copyDataOnLogin( previousAccount, currentAccount, autoLogin )
copyAccountData( currentAccount, previousAccount ) -- Копируем данные с предыдущего аккаунта на текущий
end

addEventHandler( "onPlayerLogin", root, copyDataOnLogin ) -- Добавляем обработчик события авторизации игрока

</syntaxhighlight>

==Смотри также==
{{Account_functions}}
[[en:copyAccountData]]

RU/copyAccountData

2012-08-02T11:35:30Z

Kernell:

__NOTOC__
{{Server function}}
Эта функция копирует данные с одного аккаунта на другой.

==Использование==
<syntaxhighlight lang="lua">
bool copyAccountData ( account theAccount, account fromAccount )
</syntaxhighlight>

===Обязательные параметры===
*'''theAccount:''' Целевой аккаунт.
*'''fromAccount:''' Исходный аккаунт.

===Что возвращается===
Возвращает ''true'' если аккаунты были корректными, в противном случае ''false'' .

==Пример==
Этот пример иллюстрирует использование функции copyAccountData.
<syntaxhighlight lang="lua">
function copyDataOnLogin( previousAccount, currentAccount, autoLogin )
copyAccountData( currentAccount, previousAccount ) -- Копируем данные с предыдущего аккаунта на текущий
end

addEventHandler( "onPlayerLogin", root, copyDataOnLogin ) -- Добавляем обработчик события авторизации игрока

</syntaxhighlight>

==Смотри также==
{{Account_functions}}
[[en:copyAccountData]]

UtfLen

2012-06-13T11:26:10Z

Kernell:

__NOTOC__
{{Server client function}}
The function gets the real length of a string, in characters.

==Syntax==
<syntaxhighlight lang="lua">
int utfLen ( string theString )
</syntaxhighlight>

===Required Arguments===
*'''theString:''' The [[string]] to get the length of.

===Returns===
Returns an ''[[int]]'' if the function was successful, ''false'' otherwise.

==Example==
<section name="Client" class="client" show="true">
This example adds a command ''russian_text_length'' which prints out a length russian text.
<syntaxhighlight lang="lua">
addCommandHandler( 'russian_text_length',
function( )
outputChatBox( string.format( 'Russian text length is: %d', utfLen( 'Текст' ) ) )
end
)
</syntaxhighlight>
</section>
==See Also==
{{Utility_functions}}

[[Category:Needs Example]]

User:Kernell

2012-06-11T17:20:26Z

Kernell: Created page with "test"

test

BlendPedAnimation

2012-06-11T17:17:29Z

Kernell:

__NOTOC__
{{Server client function}}
{{Important Note|This function doesn't exists. See the bugtracker for updates and more information.}}
Sets the current animation of a player or ped. Not specifying the type of animation will automatically cancel the current one.

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
bool blendPedAnimation ( ped thePed [, string block, string name, float speed=1.0, float blendSpeed=1.0, float startTime=0.0, bool loop=true, bool updatePosition=true, bool interruptable=false, function callbackFunction=nil, var arguments, ... ] )
</syntaxhighlight>

===Required Arguments===
*'''thePed:''' the player or ped you want to apply an animation to.

===Optional Arguments===
{{OptionalArg}}
*'''block:''' the [[Animations|animation]] block's name.
*'''anim:''' the name of the [[Animations|animation]] within the block.
*'''speed:''' the speed at which the animation is played.
*'''blendSpeed:''' the speed at which the previous and current animation are blended.
*'''startTime:''' how far into the animation (in seconds) you want to skip
*'''loop:''' indicates whether or not the animation will loop.
*'''updatePosition:''' will change the actual coordinates of the ped according to the animation. Use this for e.g. walking animations.
*'''interruptable:''' If set to 'false', the animation will not be interrupted by other tasks (eg: falling)
*'''callbackFunction:''' A function that is called when the animation is finished
*'''arguments:''' Any arguments you want to pass to the callbackFunction, eg: animation name
</section>

===Returns===
Returns ''true'' if succesful, ''false'' otherwise.

==Example==

<section name="Client" class="client" show="true">
This example creates a ped, rotates them, and makes them walk:
<syntaxhighlight lang="lua">
function makePed()
ped1 = createPed(56, 1, 1, 4)
setPedRotation(ped1, 315)
blendPedAnimation(ped1, "ped", "WOMAN_walknorm")
end
addEventHandler("onClientResourceStart", getResourceRootElement(), makePed)
</syntaxhighlight>
</section>

==See Also==
{{Ped_functions}}

RU/GetVehicleLandingGearDown

2011-05-29T23:57:17Z

Kernell:

__NOTOC__
{{RU/Server client function}}
Функция используется для проверки состояния шасси самолёта.

==Синтаксис==
<syntaxhighlight lang="lua">
bool getVehicleLandingGearDown ( vehicle theVehicle )
</syntaxhighlight>

===Необходимые аргументы===
*'''theVehicle:''' Транспортное средство для проверки шасси

===Возвращения===
Возвращает ''true'' если шасси опущены, ''false'' если шасси подняты.<br />
Возвращает ''nil'' если транспортное средство не имеет шасси, или оно недействительно.

==Пример==
Эта функция говорит вам, поднять шасси, если вы находитесь в Hydra с опущенными шасси.
<syntaxhighlight lang="lua">
function checkGear( thePlayer )
local theVehicle = getPlayerOccupiedVehicle( thePlayer )
if ( getElementModel(theVehicle) == 520 and getVehicleLandingGearDown( theVehicle ) == true ) then
outputChatBox( "Поднимите шасси!", thePlayer )
end
end
</syntaxhighlight>

==Смотрите также==
{{RU/Vehicle_functions}}
[[en:getVehicleLandingGearDown ]]

RU/GetVehicleLandingGearDown

2011-05-29T23:51:58Z

Kernell:

__NOTOC__
{{RU/Server client function}}
Функция используется для проверки опущено ли шасси у самолёта или нет.

==Синтаксис==
<syntaxhighlight lang="lua">
bool getVehicleLandingGearDown ( vehicle theVehicle )
</syntaxhighlight>

===Необходимые аргументы===
*'''theVehicle:''' Транспортное средство для проверки шасси

===Возвращения===
Возвращает ''true'' если шасси опущено, ''false'' если шасси подняты.<br />
Возвращает ''nil'' если транспортное средство не имеет шасси, или оно недействительно.

==Пример==
<syntaxhighlight lang="lua">
function checkGear( thePlayer )
local theVehicle = getPlayerOccupiedVehicle( thePlayer )
if ( getElementModel(theVehicle) == 520 and getVehicleLandingGearDown( theVehicle ) == true ) then
outputChatBox( "Поднимите шасси!", thePlayer )
end
end
</syntaxhighlight>

==Смотрите также==
{{RU/Vehicle_functions}}
[[en:getVehicleLandingGearDown ]]

RU/GetVehicleLandingGearDown

2011-05-29T23:51:14Z

Kernell: moved RU\GetVehicleLandingGearDown to RU/GetVehicleLandingGearDown

__NOTOC__
{{RU/Server client function}}
{{translate}}
Функция используется для проверки опущено ли шасси у самолёта или нет.

==Синтаксис==
<syntaxhighlight lang="lua">
bool getVehicleLandingGearDown ( vehicle theVehicle )
</syntaxhighlight>

===Необходимые аргументы===
*'''theVehicle:''' Транспортное средство для проверки шасси

===Возвращения===
Возвращает ''true'' если шасси опущено, ''false'' если шасси подняты.<br />
Возвращает ''nil'' если транспортное средство не имеет шасси, или оно недействительно.

==Пример==
<syntaxhighlight lang="lua">
function checkGear( thePlayer )
local theVehicle = getPlayerOccupiedVehicle( thePlayer )
if ( getElementModel(theVehicle) == 520 and getVehicleLandingGearDown( theVehicle ) == true ) then
outputChatBox( "Поднимите шасси!", thePlayer )
end
end
</syntaxhighlight>

==Смотрите также==
{{RU/Vehicle_functions}}
[[en:getVehicleLandingGearDown ]]

RU/GetVehicleLandingGearDown

2011-05-29T23:50:47Z

Kernell: moved GetVehicleLandingGearDown RU to RU\GetVehicleLandingGearDown

RU/getVehicleLandingGearDown

2011-04-22T19:14:25Z

Kernell: Created page with "__NOTOC__ {{RU/Server client function}} {{translate}} Функция используется для проверки опущено ли шасси у самолёта или н..."

GetVehicleLandingGearDown

2011-04-22T19:12:33Z

Kernell:

__NOTOC__
{{server client function}}
This function is used to check whether a vehicle's landing gear is down or not. Only planes can be used with this function.

==Syntax==
<syntaxhighlight lang="lua">
bool getVehicleLandingGearDown ( vehicle theVehicle )
</syntaxhighlight>

===Required Arguments===
*'''theVehicle:''' The vehicle of which you wish to check the landing gear state.

===Returns===
Returns ''true'' if landing gear is down, ''false'' if the landing gear is up.<br />
Returns ''nil'' if the vehicle has no landing gear, or is invalid.

==Example==
This function tells you to pull up the landing gear if you're in a Hydra with its landing gear down.
<syntaxhighlight lang="lua">
function checkGear( thePlayer )
local theVehicle = getPlayerOccupiedVehicle( thePlayer ) --Get the players vehicle
if ( getVehicleID(theVehicle) == 520 and getVehicleLandingGearDown( theVehicle ) == false ) then --if the vehicle is a hydra, and the landing gear is up
outputChatBox( "Pull up!", thePlayer ) --tell the player to pull up.
end
end
</syntaxhighlight>

==See Also==
{{Vehicle functions}}
[[ru:getVehicleLandingGearDown ]]

RU/GetVehicleLandingGearDown

2011-04-22T19:12:17Z

Kernell:

RU/GetVehicleLandingGearDown

2011-04-22T19:09:18Z

Kernell: Created page with "__NOTOC__ {{RU/Server function}} {{translate}} Функция используется для проверки опущено ли шасси у самолёта или нет. ..."

__NOTOC__
{{RU/Server function}}
{{translate}}
Функция используется для проверки опущено ли шасси у самолёта или нет.

==Синтаксис==
<syntaxhighlight lang="lua">
bool getVehicleLandingGearDown ( vehicle theVehicle )
</syntaxhighlight>

===Необходимые аргументы===
*'''theVehicle:''' Транспортное средство для проверки шасси

===Возвращения===
Возвращает ''true'' если шасси опущено, ''false'' если шасси подняты.<br />
Возвращает ''nil'' если транспортное средство не имеет шасси, или оно недействительно.

==Пример==
<syntaxhighlight lang="lua">
function checkGear( thePlayer )
local theVehicle = getPlayerOccupiedVehicle( thePlayer )
if ( getElementModel(theVehicle) == 520 and getVehicleLandingGearDown( theVehicle ) == true ) then
outputChatBox( "Поднимите шасси!", thePlayer )
end
end
</syntaxhighlight>

==Смотрите также==
{{RU/Vehicle_functions}}
[[en:getVehicleLandingGearDown ]]