Multi Theft Auto: Wiki - User contributions [en]

RU/onPlayerLogin

2017-12-06T12:15:56Z

Reitside:

{{RU/Server event}}
__NOTOC__
Это событие вызывается, когда игрок входит в свой аккаунт в игре.

==Параметры==
<syntaxhighlight lang="lua">
account thePreviousAccount, account theCurrentAccount
</syntaxhighlight>

*'''thePreviousAccount'''. Аккаунт, в который игрок вошёл ранее.
*'''theCurrentAccount'''. Аккаунт, в который игрок вошёл сейчас.

==Источник==
[[RU/Event system|Источником]] этого события является [[RU/Element/Player|игрок]], который только что вошёл в систему.

==Отмена эффекта==
Если это событие отменено, игрок не войдёт в систему.

==Примеры==
'''Пример 1'''. В этом примере выводится в чат, что игрок из одного аккаунта регистрируется в другой аккаунт.
<syntaxhighlight lang="lua">
addEventHandler("onPlayerLogin", root,
function()
outputChatBox(getPlayerName(source).." вошёл в систему!", root)
end
)
</syntaxhighlight>

'''Пример 2'''. В этом примере доступ к данным от аккаунтов имеют только запрограммированные серийные номера.
<syntaxhighlight lang="lua">
Firewall =
{
['3ash8'] = '9C9F3B55D9D7BB7135FF274D3BF444E4',
['test5'] = '1D6F76CF8D7193792D13789849498452',
}
addEventHandler("onPlayerLogin", getRootElement(),
function(_, theCurrentAccount)
local Serial = Firewall[getAccountName(theCurrentAccount)]
if Serial then
if Serial ~= getPlayerSerial(source) then
outputChatBox("К сожалению, Вам запрещён доступ к этому аккаунту.", source)
cancelEvent(true)
end
end
end
)
</syntaxhighlight>
{{RU/See also/Server event|RU/Player events|События игрока}}

[[en:onPlayerLogin]]

RU/onPlayerLogin

2017-12-06T12:15:31Z

Reitside: Created page with "{{RU/Server event}} __NOTOC__ Это событие вызывается, когда игрок входит в свой аккаунт в игре. ==Parameters== <syntaxhi..."

{{RU/Server event}}
__NOTOC__
Это событие вызывается, когда игрок входит в свой аккаунт в игре.

==Parameters==
<syntaxhighlight lang="lua">
account thePreviousAccount, account theCurrentAccount
</syntaxhighlight>

*'''thePreviousAccount'''. Аккаунт, в который игрок вошёл ранее.
*'''theCurrentAccount'''. Аккаунт, в который игрок вошёл сейчас.

==Источник==
[[RU/Event system|Источником]] этого события является [[RU/Element/Player|игрок]], который только что вошёл в систему.

==Отмена эффекта==
Если это событие отменено, игрок не войдёт в систему.

==Примеры==
'''Пример 1'''. В этом примере выводится в чат, что игрок из одного аккаунта регистрируется в другой аккаунт.
<syntaxhighlight lang="lua">
addEventHandler("onPlayerLogin", root,
function()
outputChatBox(getPlayerName(source).." вошёл в систему!", root)
end
)
</syntaxhighlight>

'''Пример 2'''. В этом примере доступ к данным от аккаунтов имеют только запрограммированные серийные номера.
<syntaxhighlight lang="lua">
Firewall =
{
['3ash8'] = '9C9F3B55D9D7BB7135FF274D3BF444E4',
['test5'] = '1D6F76CF8D7193792D13789849498452',
}
addEventHandler("onPlayerLogin", getRootElement(),
function(_, theCurrentAccount)
local Serial = Firewall[getAccountName(theCurrentAccount)]
if Serial then
if Serial ~= getPlayerSerial(source) then
outputChatBox("К сожалению, Вам запрещён доступ к этому аккаунту.", source)
cancelEvent(true)
end
end
end
)
</syntaxhighlight>
{{RU/See also/Server event|RU/Player events|События игрока}}

[[en:onPlayerLogin]]

OnPlayerLogin

2017-12-06T12:15:29Z

Reitside:

{{Server event}}
__NOTOC__
This event is triggered when a player logs into their account in-game.

==Parameters==
<syntaxhighlight lang="lua">
account thePreviousAccount, account theCurrentAccount
</syntaxhighlight>

*'''thePreviousAccount''': The account the player was logged into before
*'''theCurrentAccount''': The account the player logged into just now

==Source==
The [[event system#Event source|source]] of this event is the player [[element]] that just logged in.

==Cancel effect==
If this event is canceled the player will not be logged in.

==Example==
This example just outputs to the player console that a player in one account logged into an another account:
<syntaxhighlight lang="lua">
-- root = getElementRoot()
addEventHandler("onPlayerLogin", root,
function()
outputChatBox(getPlayerName(source).." has logged in!", root)
end
)
</syntaxhighlight>
This example allows only hardcoded serials to access given accounts.
<syntaxhighlight lang="lua">
Firewall =
{
-- [ 'accountName' ] = 'playerSerial',
[ '3ash8' ] = '9C9F3B55D9D7BB7135FF274D3BF444E4',
[ 'test5' ] = '1D6F76CF8D7193792D13789849498452',
}

addEventHandler ( 'onPlayerLogin', getRootElement ( ),
function ( _, theCurrentAccount )
local Serial = Firewall[getAccountName(theCurrentAccount)]
if ( Serial ) then
if Serial ~= getPlayerSerial ( source ) then
outputChatBox( "Sorry, you're not allowed to access this account.", source)
cancelEvent( true )
end
end
end
)
</syntaxhighlight>
{{See also/Server event|Player events}}

[[ru:onPlayerLogin]]

RU/onPlayerConnect

2017-12-05T18:42:16Z

Reitside:

__NOTOC__
{{RU/Server event}}
Это событие вызывается, когда игрок пытается подключиться к серверу.
{{RU/Important Note|Никогда, ни при каких обстоятельствах не следует изменять [[RU/Element/Player|игрока]], возвращаемого функцией [[RU/getPlayerFromName|getPlayerFromName]], перед событием [[RU/onPlayerJoin|onPlayerJoin]], дабы избежать десинхронизации (например, [[RU/setPlayerName|setPlayerName]]).}}

==Параметры==
<syntaxhighlight lang="lua">
string playerNick, string playerIP, string playerUsername, string playerSerial, int playerVersionNumber, string playerVersionString
</syntaxhighlight>

*'''playerNick'''. Текущий ник игрока.
*'''playerIP'''. Текущий IP-адрес игрока.
*'''playerUsername''': Имя пользователя сообщества игроков.
*'''playerSerial'''. Серийный номер игрока.
*'''playerVersionNumber''': Версия MTA игрока в чистой цифровой форме. Например, '''256''' для 1.0, '''257''' для 1.0.1 и т.д.
*'''playerVersionString''': Версия MTA игрока в сортируемой строковой форме. То же, что и возвращаемое значение функции [[RU/getPlayerVersion|getPlayerVersion]].

==Источник==
[[RU/Event system|Источником]] этого события является клиентский [[RU/Element tree|корневой элемент]].

==Отмена эффекта==
Если это событие [[RU/Event system#Отмена событий|отменено]], игрок будет отключён с сообщением об ошибке, указывающим причину, указанную в функции [[RU/cancelEvent|cancelEvent]], или "Disconnected: server refused the connection", если ни одна из причин не указана.

==Примеры==
'''Пример 1'''. В этом примере запрещается подключение игроков, использующих ник ''Player'' или, в противном случае, выводятся некоторые данные о подключающемся игроке.
<syntaxhighlight lang="lua">
function playerConnect(playerNick, playerIP, playerUsername, playerSerial, playerVersionNumber)
if playerNick == "Player" then
cancelEvent(true,"Ник \"Player\" запрещается использовать! Пожалуйста, измените его на другой. Вы можете изменить свой ник в меню \"Настройки\" во вкладке \"Мультиплеер\".")
else
outputChatBox(playerNick.." только что подключился к серверу.")
outputChatBox("IP-адрес: "..playerIP..", имя пользователя: "..playerUsername..", серийный номер: "..playerSerial..".")
end
end

addEventHandler("onPlayerConnect", getRootElement(), playerConnect)
</syntaxhighlight>

'''Пример 2'''. В этом примере закрывается соединение, если игрок старую версию MTA (ниже 1.0.3).
<syntaxhighlight lang="lua">
addEventHandler("onPlayerConnect", getRootElement(),
function(_,_,_,_, clientVersion )
if clientVersion < 259 then
cancelEvent(true, "Обновите Multi Theft Auto перед тем, как присоединиться к серверу." )
end
end
)
</syntaxhighlight>

{{RU/See also/Server event|RU/Player events|События игрока}}

[[en:onPlayerConnect]]

OnPlayerChangeNick

2017-12-05T18:41:53Z

Reitside:

{{Server event}}
__NOTOC__
This event is triggered when a player changes his nickname.

==Parameters==
<syntaxhighlight lang="lua">
string oldNick, string newNick, bool changedByUser
</syntaxhighlight>
*'''oldNick:''' the nickname the player had before.
*'''newNick:''' the new nickname of the player.
{{New items|3.0160|1.5.3|
*'''changedByUser:''' whether the name was changed using [[setPlayerName]] or by the user
|9765}}

==Source==
The source of this event is the player that changed his nick

==Cancel effect==
Cancelling this event depends on how it is called, if it is called by the scripting event then it is NOT cancelable. If it is called from the /nick command it IS cancelable. If this event is cancelled and can be cancelled then the name will not change.

==Example==
<section name="Server Example 1" class="server" show="true">
<syntaxhighlight lang="lua">
function nickChangeHandler(oldNick, newNick)
-- check if there's account with newNick as username
if getAccount(newNick) then
outputChatBox("Sorry, there already exists an account with your new nickname as username.", source, 0, 255, 0)
outputChatBox("Please choose another one.", source, 0, 255, 0)
-- cancel the event to prevent the nick from being changed
cancelEvent()
end
end
-- add an event handler
addEventHandler("onPlayerChangeNick", getRootElement(), nickChangeHandler)
</syntaxhighlight></section>

{{New items|3.0160|1.5.3|
<section name="Server Example 2" class="server" show="true">
This function checks if the nickname of a player was changed by a script, if so, a message is shown in the server logs.
<syntaxhighlight lang="lua">
function wasNickChangedByUser(oldNick, newNick, changedByUser)
if (changedByUser == false) then -- check if the nickname was not changed by the user
outputServerLog("Player "..oldNick.."'s name was changed to "..newNick.." by a script") -- output to the server's logs
end
end
addEventHandler("onPlayerChangeNick", getRootElement(), wasNickChangedByUser) -- add an event handler
</syntaxhighlight></section>|9765}}

==Issues==
{{Issues|
{{Issue|7362|onPlayerChangeNick triggered when nick doesn't changed}}
{{GH_Issue|52|Add 'manuallyChanged' parameter to onPlayerChangeNick}}
}}

{{See also/Server event|Player events}}

[[ru:onPlayerChangeNick]]

RU/onPlayerChangeNick

2017-12-05T18:41:25Z

Reitside:

{{RU/Server event}}
__NOTOC__
Это событие вызывается, когда игрок меняет свой ник.

==Параметры==
<syntaxhighlight lang="lua">
string oldNick, string newNick, bool changedByUser
</syntaxhighlight>
*'''oldNick'''. Ник, который игрок имел раньше.
*'''newNick'''. Новый ник игрока.
{{RU/New items|3.0160|1.5.3|
*'''changedByUser'''. Было ли имя изменено с помощью функции [[RU/setPlayerName|setPlayerName]] или пользователем.
|9765}}

==Источник==
[[RU/Event system|Источником]] этого события является [[RU/Element/Player|игрок]], который изменил свой ник.

==Отмена эффекта==
[[RU/Event system#Отмена событий|Отмена]] этого события зависит от того, как оно вызывается. Если оно вызывается скриптинговым событием, тогда оно не отменяется. Если оно вызывается командой ''/nick'', оно отменяется. Если это событие отменено и может быть отменено, имя не изменится.

==Примеры==
'''Пример 1'''. В этом примере отменяется событие, если ник уже существует.
<syntaxhighlight lang="lua">
function nickChangeHandler(oldNick, newNick)
if getAccount(newNick) then
outputChatBox("К сожалению, уже существует аккаунт с Вашим новым ником как имя пользователя.", source, 0, 255, 0)
outputChatBox("Пожалуйста, выберите другой.", source, 0, 255, 0)
cancelEvent()
end
end
addEventHandler("onPlayerChangeNick", getRootElement(), nickChangeHandler)
</syntaxhighlight>

{{RU/New items|3.0160|1.5.3|
'''Пример 2'''. В этом примере проверяется, был ли ник игрока изменён скриптом и, если это так, логируется.
<syntaxhighlight lang="lua">
function wasNickChangedByUser(oldNick, newNick, changedByUser)
if changedByUser == false then
outputServerLog("Имя игрока "..oldNick.." было изменено на "..newNick.." скриптом.")
end
end
addEventHandler("onPlayerChangeNick", getRootElement(), wasNickChangedByUser)
</syntaxhighlight>|9765}}

==Проблемы==
{{RU/Issues|
{{Issue|7362|Событие onPlayerChangeNick запускается, когда ник не изменяется}}
{{GH_Issue|52|Добавьте параметр ''manuallyChanged'' в событие onPlayerChangeNick}}
}}

{{RU/See also/Server event|RU/Player events|События игрока}}

[[en:onPlayerChangeNick]]

RU/onPlayerChangeNick

2017-12-05T18:40:41Z

Reitside:

{{Server event}}
__NOTOC__
Это событие вызывается, когда игрок меняет свой ник.

==Параметры==
<syntaxhighlight lang="lua">
string oldNick, string newNick, bool changedByUser
</syntaxhighlight>
*'''oldNick'''. Ник, который игрок имел раньше.
*'''newNick'''. Новый ник игрока.
{{RU/New items|3.0160|1.5.3|
*'''changedByUser'''. Было ли имя изменено с помощью функции [[RU/setPlayerName|setPlayerName]] или пользователем.
|9765}}

==Источник==
[[RU/Event system|Источником]] этого события является [[RU/Element/Player|игрок]], который изменил свой ник.

==Отмена эффекта==
[[RU/Event system#Отмена событий|Отмена]] этого события зависит от того, как оно вызывается. Если оно вызывается скриптинговым событием, тогда оно не отменяется. Если оно вызывается командой ''/nick'', оно отменяется. Если это событие отменено и может быть отменено, имя не изменится.

==Примеры==
'''Пример 1'''. В этом примере отменяется событие, если ник уже существует.
<syntaxhighlight lang="lua">
function nickChangeHandler(oldNick, newNick)
if getAccount(newNick) then
outputChatBox("К сожалению, уже существует аккаунт с Вашим новым ником как имя пользователя.", source, 0, 255, 0)
outputChatBox("Пожалуйста, выберите другой.", source, 0, 255, 0)
cancelEvent()
end
end
addEventHandler("onPlayerChangeNick", getRootElement(), nickChangeHandler)
</syntaxhighlight>

{{RU/New items|3.0160|1.5.3|
'''Пример 2'''. В этом примере проверяется, был ли ник игрока изменён скриптом и, если это так, логируется.
<syntaxhighlight lang="lua">
function wasNickChangedByUser(oldNick, newNick, changedByUser)
if changedByUser == false then
outputServerLog("Имя игрока "..oldNick.." было изменено на "..newNick.." скриптом.")
end
end
addEventHandler("onPlayerChangeNick", getRootElement(), wasNickChangedByUser)
</syntaxhighlight>|9765}}

==Проблемы==
{{RU/Issues|
{{Issue|7362|Событие onPlayerChangeNick запускается, когда ник не изменяется}}
{{GH_Issue|52|Добавьте параметр ''manuallyChanged'' в событие onPlayerChangeNick}}
}}

{{RU/See also/Server event|RU/Player events|События игрока}}

[[en:onPlayerChangeNick]]

RU/onPlayerChangeNick

2017-12-05T18:39:32Z

Reitside: Created page with "{{Server event}} __NOTOC__ Это событие вызывается, когда игрок меняет свой ник. ==Параметры== <syntaxhighlight lang="lua..."

{{Server event}}
__NOTOC__
Это событие вызывается, когда игрок меняет свой ник.

==Параметры==
<syntaxhighlight lang="lua">
string oldNick, string newNick, bool changedByUser
</syntaxhighlight>
*'''oldNick'''. Ник, который игрок имел раньше.
*'''newNick'''. Новый ник игрока.
{{RU/New items|3.0160|1.5.3|
*'''changedByUser'''. Было ли имя изменено с помощью функции [[RU/setPlayerName|setPlayerName]] или пользователем.
|9765}}

==Источник==
[[RU/Event system|Источником]] этого события является [[RU/Element/Player|игрок]], который изменил свой ник.

==Отмена эффекта==
[[RU/Event system#Отмена событий|Отмена]] этого события зависит от того, как оно вызывается. Если оно вызывается скриптинговым событием, тогда оно не отменяется. Если оно вызывается командой ''/nick'', оно отменяется. Если это событие отменено и может быть отменено, имя не изменится.

==Примеры==
'''Пример 1'''. В этом примере отменяется событие, если ник уже существует.
<syntaxhighlight lang="lua">
function nickChangeHandler(oldNick, newNick)
if getAccount(newNick) then
outputChatBox("К сожалению, уже существует аккаунт с Вашим новым ником как имя пользователя.", source, 0, 255, 0)
outputChatBox("Пожалуйста, выберите другой.", source, 0, 255, 0)
cancelEvent()
end
end
addEventHandler("onPlayerChangeNick", getRootElement(), nickChangeHandler)
</syntaxhighlight>

{{New items|3.0160|1.5.3|
This function checks if the nickname of a player was changed by a script, if so, a message is shown in the server logs.
'''Пример 2'''. В этом примере проверяется, был ли ник игрока изменён скриптом и, если это так, логируется.
<syntaxhighlight lang="lua">
function wasNickChangedByUser(oldNick, newNick, changedByUser)
if changedByUser == false then
outputServerLog("Имя игрока "..oldNick.." было изменено на "..newNick.." скриптом.")
end
end
addEventHandler("onPlayerChangeNick", getRootElement(), wasNickChangedByUser) -- add an event handler
</syntaxhighlight>|9765}}

==Проблемы==
{{RU/Issues|
{{Issue|7362|Событие onPlayerChangeNick запускается, когда ник не изменяется}}
{{GH_Issue|52|Добавьте параметр ''manuallyChanged'' в событие onPlayerChangeNick}}
}}

{{RU/See also/Server event|RU/Player events|События игрока}}

[[en:onPlayerChangeNick]]

Template:RU/New items

2017-12-05T18:39:02Z

Reitside:

<includeonly>{{#ifexpr:({{{1|}}})>{{Current Version}}|<div style='font-weight: bold;background:black;color:white;padding:2px; padding-left:8px;'>С версии {{{2}}} {{#if:{{{4|}}}|{{r|{{{4}}}}}|}} и выше</div><div style='border: 2px solid black;padding: 3px;'>{{{3}}} </div>| {{{3}}}}}</includeonly><noinclude>Используйте этот шаблон для списков функций/событий. На страницах функций и событий используйте <nowiki>{{RU/New feature/item}}</nowiki>. Это предохранит от появления неверных страниц в категории с изменениями.
[[Category:Utility templates]]</noinclude>

Template:RU/Issues

2017-12-05T18:34:45Z

Reitside:

{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
! Идентификатор проблемы
! class="unsortable" | Описание
|-
<includeonly>{{{1}}}</includeonly>
|}

Template:RU/Issues

2017-12-05T18:34:28Z

Reitside:

{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
! Идентификатор проблемы
! class="unsortable" | Description
|-
<includeonly>{{{1}}}</includeonly>
|}

RU/onPlayerConnect

2017-12-05T18:21:12Z

Reitside:

__NOTOC__
{{RU/Server event}}
Это событие вызывается, когда игрок пытается подключиться к серверу.
{{RU/Important Note|Никогда, ни при каких обстоятельствах не следует изменять [[RU/Element/Player|игрока]], возвращаемого функцией [[RU/getPlayerFromName|getPlayerFromName]], перед событием [[RU/onPlayerJoin|onPlayerJoin]], дабы избежать десинхронизации (например, [[RU/setPlayerName|setPlayerName]]).}}

==Параметры==
<syntaxhighlight lang="lua">
string playerNick, string playerIP, string playerUsername, string playerSerial, int playerVersionNumber, string playerVersionString
</syntaxhighlight>

*'''playerNick'''. Текущий ник игрока.
*'''playerIP'''. Текущий IP-адрес игрока.
*'''playerUsername''': Имя пользователя сообщества игроков.
*'''playerSerial'''. Серийный номер игрока.
*'''playerVersionNumber''': Версия MTA игрока в чистой цифровой форме. Например, '''256''' для 1.0, '''257''' для 1.0.1 и т.д.
*'''playerVersionString''': Версия MTA игрока в сортируемой строковой форме. То же, что и возвращаемое значение функции [[RU/getPlayerVersion|getPlayerVersion]].

==Источник==
[[RU/Event system|Источником]] этого события является клиентский [[RU/Element tree|корневой элемент]].

==Отмена эффекта==
Если это событие [[RU/Event system#Отмена событий|отменено]], игрок будет отключён с сообщением об ошибке, указывающим причину, указанную в функции [[RU/cancelEvent|cancelEvent]], или "Disconnected: server refused the connection", если ни одна из причин не указана.

==Примеры==
'''Пример 1'''. В этом примере запрещается подключение игроков, использующих ник ''Player'' или, в противном случае, выводятся некоторые данные о подключающемся игроке.
<syntaxhighlight lang="lua">
function playerConnect(playerNick, playerIP, playerUsername, playerSerial, playerVersionNumber)
if playerNick == "Player" then
cancelEvent(true,"Ник \"Player\" запрещается использовать! Пожалуйста, измените его на другой. Вы можете изменить свой ник в меню \"Настройки\" во вкладке \"Мультиплеер\".")
else
outputChatBox(playerNick.." только что подключился к серверу.")
outputChatBox("IP-адрес: "..playerIP..", имя пользователя: "..playerUsername..", серийный номер: "..playerSerial..".")
end
end

addEventHandler("onPlayerConnect", getRootElement(), playerConnect)
</syntaxhighlight>

'''Пример 2'''. В этом примере закрывается соединение, если игрок старую версию MTA (ниже 1.0.3).
<syntaxhighlight lang="lua">
addEventHandler("onPlayerConnect", getRootElement(),
function(_,_,_,_, clientVersion )
if clientVersion < 259 then
cancelEvent(true, "Обновите Multi Theft Auto перед тем, как присоединиться к серверу." )
end
end
)
</syntaxhighlight>

{{RU/See also/Server event|Player events|События игрока}}

[[en:onPlayerConnect]]

RU/onPlayerConnect

2017-12-05T14:49:02Z

Reitside:

__NOTOC__
{{RU/Server event}}
Это событие вызывается, когда игрок пытается подключиться к серверу.
{{RU/Important Note|Никогда, ни при каких обстоятельствах не следует изменять [[RU/Element/Player|игрока]], возвращаемого функцией [[RU/getPlayerFromName|getPlayerFromName]], перед событием [[RU/onPlayerJoin|onPlayerJoin]], дабы избежать десинхронизации (например, [[RU/setPlayerName|setPlayerName]]).}}

==Параметры==
<syntaxhighlight lang="lua">
string playerNick, string playerIP, string playerUsername, string playerSerial, int playerVersionNumber, string playerVersionString
</syntaxhighlight>

*'''playerNick'''. Текущий ник игрока.
*'''playerIP'''. Текущий IP-адрес игрока.
*'''playerUsername''': Имя пользователя сообщества игроков.
*'''playerSerial'''. Серийный номер игрока.
*'''playerVersionNumber''': Версия MTA игрока в чистой цифровой форме. Например, '''256''' для 1.0, '''257''' для 1.0.1 и т.д.
*'''playerVersionString''': Версия MTA игрока в сортируемой строковой форме. То же, что и возвращаемое значение функции [[RU/getPlayerVersion|getPlayerVersion]].

==Источник==
[[RU/Event system|Источником]] этого события является клиентский [[RU/Element tree|корневой элемент]].

==Отмена эффекта==
Если это событие [[RU/Event system#Отмена событий|отменено]], игрок будет отключён с сообщением об ошибке, указывающим причину, указанную в функции [[RU/cancelEvent|cancelEvent]], или "Disconnected: server refused the connection", если ни одна из причин не указана.

==Пример==
'''Пример 1'''. В этом примере запрещается подключение игроков, использующих ник ''Player'' или, в противном случае, выводятся некоторые данные о подключающемся игроке.
<syntaxhighlight lang="lua">
function playerConnect(playerNick, playerIP, playerUsername, playerSerial, playerVersionNumber)
if playerNick == "Player" then
cancelEvent(true,"Ник \"Player\" запрещается использовать! Пожалуйста, измените его на другой. Вы можете изменить свой ник в меню \"Настройки\" во вкладке \"Мультиплеер\".")
else
outputChatBox(playerNick.." только что подключился к серверу.")
outputChatBox("IP-адрес: "..playerIP..", имя пользователя: "..playerUsername..", серийный номер: "..playerSerial..".")
end
end

addEventHandler("onPlayerConnect", getRootElement(), playerConnect)
</syntaxhighlight>

'''Пример 2'''. В этом примере закрывается соединение, если игрок старую версию MTA (ниже 1.0.3).
<syntaxhighlight lang="lua">
addEventHandler("onPlayerConnect", getRootElement(),
function(_,_,_,_, clientVersion )
if clientVersion < 259 then
cancelEvent(true, "Обновите Multi Theft Auto перед тем, как присоединиться к серверу." )
end
end
)
</syntaxhighlight>

{{RU/See also/Server event|Player events|События игрока}}

[[en:onPlayerConnect]]

RU/onPlayerConnect

2017-12-05T14:48:16Z

Reitside: Created page with "__NOTOC__ {{RU/Server event}} Это события вызывается, когда игрок пытается подключиться к серверу. {{RU/Important Not..."

__NOTOC__
{{RU/Server event}}
Это события вызывается, когда игрок пытается подключиться к серверу.
{{RU/Important Note|Никогда, ни при каких обстоятельствах не следует изменять [[RU/Element/Player|игрока]], возвращаемого функцией [[RU/getPlayerFromName|getPlayerFromName]], перед событием [[RU/onPlayerJoin|onPlayerJoin]], дабы избежать десинхронизации (например, [[RU/setPlayerName|setPlayerName]]).}}

==Параметры==
<syntaxhighlight lang="lua">
string playerNick, string playerIP, string playerUsername, string playerSerial, int playerVersionNumber, string playerVersionString
</syntaxhighlight>

*'''playerNick'''. Текущий ник игрока.
*'''playerIP'''. Текущий IP-адрес игрока.
*'''playerUsername''': Имя пользователя сообщества игроков.
*'''playerSerial'''. Серийный номер игрока.
*'''playerVersionNumber''': Версия MTA игрока в чистой цифровой форме. Например, '''256''' для 1.0, '''257''' для 1.0.1 и т.д.
*'''playerVersionString''': Версия MTA игрока в сортируемой строковой форме. То же, что и возвращаемое значение функции [[RU/getPlayerVersion|getPlayerVersion]].

==Источник==
[[RU/Event system|Источником]] этого события является клиентский [[RU/Element tree|корневой элемент]].

==Отмена эффекта==
Если это событие [[RU/Event system#Отмена событий|отменено]], игрок будет отключён с сообщением об ошибке, указывающим причину, указанную в функции [[RU/cancelEvent|cancelEvent]], или "Disconnected: server refused the connection", если ни одна из причин не указана.

==Пример==
'''Пример 1'''. В этом примере запрещается подключение игроков, использующих ник ''Player'' или, в противном случае, выводятся некоторые данные о подключающемся игроке.
<syntaxhighlight lang="lua">
function playerConnect(playerNick, playerIP, playerUsername, playerSerial, playerVersionNumber)
if playerNick == "Player" then
cancelEvent(true,"Ник \"Player\" запрещается использовать! Пожалуйста, измените его на другой. Вы можете изменить свой ник в меню \"Настройки\" во вкладке \"Мультиплеер\".")
else
outputChatBox(playerNick.." только что подключился к серверу.")
outputChatBox("IP-адрес: "..playerIP..", имя пользователя: "..playerUsername..", серийный номер: "..playerSerial..".")
end
end

addEventHandler("onPlayerConnect", getRootElement(), playerConnect)
</syntaxhighlight>

'''Пример 2'''. В этом примере закрывается соединение, если игрок старую версию MTA (ниже 1.0.3).
<syntaxhighlight lang="lua">
addEventHandler("onPlayerConnect", getRootElement(),
function(_,_,_,_, clientVersion )
if clientVersion < 259 then
cancelEvent(true, "Обновите Multi Theft Auto перед тем, как присоединиться к серверу." )
end
end
)
</syntaxhighlight>

{{RU/See also/Server event|Player events|События игрока}}

[[en:onPlayerConnect]]

OnPlayerConnect

2017-12-05T14:48:10Z

Reitside:

__NOTOC__
{{Server event}}
This event is triggered when a player attempts to connect to the server.
{{MessageBox|
bordercolorhex = CC3333 |
bgcolorhex = FF8888 |
message = '''WARNING:''' You should never, under any circumstances, modify the player returned by [[getPlayerFromName]] before '''onPlayerJoin''' to avoid desynchronization (e.g. [[setPlayerName]]). }}

==Parameters==
<syntaxhighlight lang="lua">
string playerNick, string playerIP, string playerUsername, string playerSerial, int playerVersionNumber, string playerVersionString
</syntaxhighlight>

*'''playerNick''': The player's current nickname.
*'''playerIP''': The player's current IP.
*'''playerUsername''': The player's community username.
*'''playerSerial''': The player's serial number.
*'''playerVersionNumber''': The player's MTA version in pure numerical form, e.g. ''''256'''' for 1.0, ''''257'''' for 1.0.1, etc.
*'''playerVersionString''': The player's MTA version in sortable string form. Same as the return value from [[getPlayerVersion]].

==Source==
The [[event system#Event source|source]] of this event is the client's [[root element]].

==Cancel effect==
If this event is [[Event system#Canceling|canceled]], the player will be disconnected with an error message saying the reason specified in cancelEvent or "Disconnected: server refused the connection" if none was specified.

==Example==

This example cancels connection attempts of people who use the nick "Player" or outputs some data about the connecting player otherwise.

<syntaxhighlight lang="lua">
--when a player connects
function playerConnect (playerNick, playerIP, playerUsername, playerSerial, playerVersionNumber)
if playerNick == "Player" then --check if his nick is "Player"
cancelEvent(true,"The nick \"Player\" is not allowed, please change it to something else. You can change your nick in Settings menu Multiplayer tab.") --in that case refuse the connection
else
--output some data about the player
outputChatBox (playerNick.." just connected to the server.")
outputChatBox ("IP: "..playerIP.." Username: "..playerUsername.." Serial: "..playerSerial)
end
end

--add the playerConnect function as a handler for onPlayerConnect
addEventHandler ("onPlayerConnect", getRootElement(), playerConnect)
</syntaxhighlight>

This example cancels connection if player uses older MTA (older than 1.0.3)
<syntaxhighlight lang="lua">
addEventHandler( "onPlayerConnect", getRootElement(),
function ( _,_,_,_, clientVersion )
if ( clientVersion < 259 ) then
cancelEvent( true, "Update your MTA before you join this server!" );
end
end
)
</syntaxhighlight>

{{See also/Server event|Player events}}

[[ru:onPlayerConnect]]

RU/onPlayerBan

2017-12-05T13:44:47Z

Reitside:

__NOTOC__
{{RU/Server event}}
Это событие вызывается, когда игрок выдаёт [[RU/Ban|бан]] (например, [[RU/onBan|onBan]]).

==Параметры==
<syntaxhighlight lang="lua">
ban banPointer, player responsibleElement
</syntaxhighlight>

*'''banPointer'''. Указатель бана, который был выдан.
*'''responsibleElement'''. Игрок, выдавший бан (ответственный элемент).

==Источник==
[[RU/Event system|Источником]] этого события является [[RU/Element/Player|игрок]], который был забанен.

==Пример==
'''Пример 1'''. В этом примере выводится в чат ответственный элемент и имя забаненого игрока, когда происходит бан.
<syntaxhighlight lang="lua">
function outputBan(banPointer, responsibleElement)
local banner = getPlayerName(responsibleElement) or "Console"
outputChatBox("Игрок "..banner.." забанен игроком ".. getPlayerName(source)..".", getRootElement(), 255, 0, 0)
end
addEventHandler("onPlayerBan", getRootElement(), outputBan)
</syntaxhighlight>

==Изменения==
{{RU/ChangelogHeader}}
{{ChangelogItem|1.3.0-9.03908|Исправлен параметр ответственного элемента}}

{{RU/See also/Server event|RU/Player events|События игрока}}

[[en:onPlayerBan]]

RU/onPlayerBan

2017-12-04T18:10:02Z

Reitside:

__NOTOC__
{{RU/Server event}}
Это событие вызывается, когда игрок добавляет [[RU/Ban|бан]] (например, [[RU/onBan|onBan]]).

==Параметры==
<syntaxhighlight lang="lua">
ban banPointer, player responsibleElement
</syntaxhighlight>

*'''banPointer'''. Указатель бана, который был добавлен.
*'''responsibleElement'''. Игрок, добавивший бан.

==Источник==
[[RU/Event system|Источником]] этого события является [[RU/Element/Player|игрок]], который был забанен.

==Пример==
'''Пример 1'''. В этом примере идёт вывод в чат игрока, добавившего бан (ответственный элемент) и имя забаненого игрока, когда происходит бан.
<syntaxhighlight lang="lua">
function outputBan(banPointer, responsibleElement)
local banner = getPlayerName(responsibleElement) or "Console"
outputChatBox("Игрок "..banner.." забанен игроком ".. getPlayerName(source)..".", getRootElement(), 255, 0, 0)
end
addEventHandler("onPlayerBan", getRootElement(), outputBan)
</syntaxhighlight>

==Изменения==
{{RU/ChangelogHeader}}
{{ChangelogItem|1.3.0-9.03908|Исправлен параметр ответственного элемента}}

{{RU/See also/Server event|RU/Player events|События игрока}}

[[en:onPlayerBan]]

RU/onPlayerPrivateMessage

2017-12-04T18:09:22Z

Reitside:

__NOTOC__
{{RU/Server event}}
Это событие вызывается, когда игрок отправляет личное сообщение с помощью команды ''msg''.

==Параметры==
<syntaxhighlight lang="lua">
string message, player recipient
</syntaxhighlight>
*'''message'''. Строка, представляющая собой введённое личное сообщение.
*'''recipient'''. [[RU/Element/Player|Игрок]], которому отправляется сообщение.

==Источник==
[[RU/Event system|Источником]] этого события является [[RU/Element/Player|игрок]], который отправил личное сообщение.

==Отмена эффекта==
Если это событие [[RU/Event system#Отмена событий|отменено]], система чата игры не будет отправлять сообщения. Вы можете использовать функцию [[RU/outputChatBox|outputChatBox]] для отправки потом сообщений.

==Пример==
'''Пример 1'''. В этом примере игрок ''Bob'' не принимает личные сообщения от других игроков.
<syntaxhighlight lang="lua">
function blockPM(msg, r)
if getPlayerName(r) == "Bob" then
cancelEvent()
outputChatBox("Игрок Bob не принимает личные сообщения в это время.", source, 255, 0, 0)
end
end
addEventHandler("onPlayerPrivateMessage", getRootElement(), blockPM)
</syntaxhighlight>

{{RU/See also/Server event|RU/Player events|События игрока}}

[[en:onPlayerPrivateMessage]]

RU/onPlayerPrivateMessage

2017-12-04T18:09:05Z

Reitside:

OnPlayerPrivateMessage

2017-12-04T18:07:43Z

Reitside:

__NOTOC__
{{Server event}}
This event is triggered when a player sends a private message with ''msg'' command.

==Parameters==
<syntaxhighlight lang="lua">
string message, player recipient
</syntaxhighlight>
*'''message''': A string representing the private message typed.
*'''recipient''': The [[player]] to whom the message is being sent.

==Source==
The [[event system#Event source|source]] of this event is the [[player]] who sent the private message.

==Cancel effect==
If this event is [[Event system#Canceling|canceled]], the game's chat system won't deliver the message. You may use [[outputChatBox]] to send the messages then.

==Example==
This example blocks players sending a PM to a player named "Bob".
<syntaxhighlight lang="lua">
function blockPM(msg,r)
if (getPlayerName(r) == "Bob") then -- If they sent a PM to "Bob"
cancelEvent() -- Then cancel it
outputChatBox("Bob is not accepting PM's at this time.",source,255,0,0) -- And output it was cancelled.
end
end
addEventHandler("onPlayerPrivateMessage",getRootElement(),blockPM)
</syntaxhighlight>
{{See also/Server event|Player events}}

[[ru:onPlayerPrivateMessage]]

RU/onPlayerPrivateMessage

2017-12-04T18:07:15Z

Reitside: Created page with "__NOTOC__ {{RU/Server event}} Это событие вызывается, когда игрок отправляет личное сообщение с помощью кома..."

__NOTOC__
{{RU/Server event}}
Это событие вызывается, когда игрок отправляет личное сообщение с помощью команды ''msg''.

==Параметры==
<syntaxhighlight lang="lua">
string message, player recipient
</syntaxhighlight>
*'''message'''. Строка, представляющая собой введённое личное сообщение.
*'''recipient'''. [[RU/Element/Player|Игрок]], которому отправляется сообщение.

==Источник==
[[RU/Event system|Источником]] этого события является [[RU/Element/Player|игрок]], который отправил личное сообщение.

==Отмена эффекта==
Если это событие [[RU/Event system#Отмена событий|отменено]], система чата игры не будет отправлять сообщения. Вы можете использовать функцию [[RU/outputChatBox|outputChatBox]] для отправки потом сообщений.

==Пример==
'''Пример 1'''. В этом примере игрок ''Bob'' не принимает личные сообщения от других игроков.
<syntaxhighlight lang="lua">
function blockPM(msg, r)
if getPlayerName(r) == "Bob" then
cancelEvent()
outputChatBox("Игрок Bob не принимает личные сообщения в это время.", source, 255, 0, 0)
end
end
addEventHandler("onPlayerPrivateMessage", getRootElement(), blockPM)
</syntaxhighlight>

{{See also/Server event|RU/Player events|События игроков}}

[[en:onPlayerPrivateMessage]]

RU/onPlayerChat

2017-12-04T17:10:42Z

Reitside:

__NOTOC__
{{RU/Server event}}
Это событие вызывается, когда игрок отправляет сообщение в чат.

==Параметры==
<syntaxhighlight lang="lua">
string message, int messageType
</syntaxhighlight>

*'''message'''. Строка, представляющая собой сообщение, введённое в чат.
*'''messageType'''. Целочисленное значение, представляющее тип сообщения:
**'''0'''. обычное сообщение;
**'''1'''. сообщение о действии (/me);
**'''2'''. командное сообщение.

==Источник==
[[RU/Event system#Источник|Источником]] этого события является [[RU/Element/Player|игрок]], который отправил сообщение в чат.

==Отмена эффекта==
Если это событие [[RU/Event system#Отмена событий|отменено]], система чата игры не будет отправлять сообщения. Вы можете использовать функцию [[RU/outputChatBox|outputChatBox]] для отправки потом сообщений.
Отмена этого события также означает, что чат не будет отображаться в консоли сервера или логах. Если Вы хотите вести логирование чата, Вам нужно будет добавить вызов функции [[RU/outputServerLog|outputServerLog]].

==Примеры==
'''Пример 1'''. В этом примере ограничивается приём сообщений чата сферической области вокруг игрока, который отправил сообщение, а также блокирует действие и текст команды.
<syntaxhighlight lang="lua">
local chatRadius = 20
function sendMessageToNearbyPlayers(message, messageType)
if messageType == 0 then
local posX, posY, posZ = getElementPosition(source)
local chatSphere = createColSphere(posX, posY, posZ, chatRadius)
local nearbyPlayers = getElementsWithinColShape(chatSphere, "player")
destroyElement(chatSphere)
for index, nearbyPlayer in ipairs(nearbyPlayers) do
outputChatBox(message, nearbyPlayer)
end
end
end
addEventHandler("onPlayerChat", getRootElement(), sendMessageToNearbyPlayers)
function blockChatMessage()
cancelEvent()
end
addEventHandler("onPlayerChat", getRootElement(), blockChatMessage)
</syntaxhighlight>

'''Пример 2'''. В этом примере реализованы цветные имена игроков в чате.
<syntaxhighlight lang="lua">
local function playerJoin()
local red, green, blue = math.random(50, 255), math.random(50, 255), math.random(50, 255)
setPlayerNametagColor(source, red, green, blue)
end
addEventHandler("onPlayerJoin", root, playerJoin)
local function playerChat(message, messageType)
if messageType == 0 then
cancelEvent()
local red, green, blue = getPlayerNametagColor(source)
outputChatBox(getPlayerName(source)..": #FFFFFF"..message, root, red, green, blue, true )
outputServerLog("Чат: "..getPlayerName(source)..": "..message)
end
end
addEventHandler("onPlayerChat", root, playerChat)
</syntaxhighlight>

'''Пример 3'''. В этом примере убивается тот игрок, который отправил в чат сообщение ''kill''.
<syntaxhighlight lang="lua">
function onChat(message, messageType)
if string.find(message, 'kill') then
killPed(source, source)
end
end
addEventHandler("onPlayerChat", getRootElement(), onChat)
</syntaxhighlight>

{{RU/See also/Server event|RU/Player events|События игрока}}

[[en:onPlayerChat]]

OnPlayerChat

2017-12-04T17:09:55Z

Reitside:

__NOTOC__
{{Server event}}
This event is triggered when a player chats inside the chat box.

==Parameters==
<syntaxhighlight lang="lua">
string message, int messageType
</syntaxhighlight>

*'''message''': A string representing the message typed into the chat.
*'''messageType''': An integer value representing the message type:
**'''0''': normal message
**'''1''': action message (/me)
**'''2''': team message

==Source==
The [[event system#Event source|source]] of this event is the [[player]] who sent the chatbox message.

==Cancel effect==
If this event is [[Event system#Canceling|canceled]], the game's chat system won't deliver the posts. You may use [[outputChatBox]] to send the messages then.
Cancelling this event also means the chat will not appear in the server console or logs. If you want chat logging, you will have to add a call to [[outputServerLog]] - See the second example.

==Examples==

<section name="Example 1" class="server" show="true">
This example limits receiving of chat messages to a spherical area around the player who sent the message, also blocking action and team text.

<syntaxhighlight lang="lua">
-- define our chat radius
local chatRadius = 20 --units

-- define a handler that will distribute the message to all nearby players
function sendMessageToNearbyPlayers( message, messageType )
-- we will only send normal chat messages, action and team types will be ignored
if messageType == 0 then
-- get the chatting player's position
local posX, posY, posZ = getElementPosition( source )

-- create a sphere of the specified radius in that position
local chatSphere = createColSphere( posX, posY, posZ, chatRadius )
-- get a table all player elements inside it
local nearbyPlayers = getElementsWithinColShape( chatSphere, "player" )
-- and destroy the sphere, since we're done with it
destroyElement( chatSphere )

-- deliver the message to each player in that table
for index, nearbyPlayer in ipairs( nearbyPlayers ) do
outputChatBox( message, nearbyPlayer )
end
end
end
-- attach our new chat handler to onPlayerChat
addEventHandler( "onPlayerChat", getRootElement(), sendMessageToNearbyPlayers )

-- define another handler function that cancels the event so that the message won't be delivered through the
function blockChatMessage()
cancelEvent()
end
-- attach it as a handler to onPlayerChat
addEventHandler( "onPlayerChat", getRootElement(), blockChatMessage )
</syntaxhighlight>
</section>

<section name="Example 2" class="server" show="true">
This example implements colored player names in chat.

<syntaxhighlight lang="lua">
--This function is executed when a player joins, it sets the player's name-tag color to a random color.
local function playerJoin()
local red, green, blue = math.random (50, 255), math.random (50, 255), math.random (50, 255)
setPlayerNametagColor(source, red, green, blue)
end
addEventHandler ("onPlayerJoin", root, playerJoin)

--This function is executed when a player says something in chat, it outputs the player's message, with their nick colored to match their name tag color.
local function playerChat(message, messageType)
if messageType == 0 then --Global (main) chat
cancelEvent()
local red, green, blue = getPlayerNametagColor(source)
outputChatBox(getPlayerName(source)..": #FFFFFF"..message, root, red, green, blue, true )
outputServerLog("CHAT: "..getPlayerName(source)..": "..message)--NOTE: Beacuse we cancelled the onPlayerChat event, we need to log chat manually.
end
end
addEventHandler("onPlayerChat", root, playerChat)
</syntaxhighlight>
</section>

<section name="Example 3" class="server" show="true">
This is a script that kills any player that says 'kill'.

<syntaxhighlight lang="lua">
function onChat(message, messageType)
if string.find(message, 'kill') then -- Searches for the string 'kill' in the message sent
killPed ( source, source ) -- Kills that player that typed the string 'kill'
end
end --End of the function
addEventHandler("onPlayerChat", getRootElement(), onChat)
</syntaxhighlight>
</section>

{{See also/Server event|Player events}}

[[ru:onPlayerChat]]

RU/onPlayerChat

2017-12-04T17:09:40Z

Reitside: Created page with "__NOTOC__ {{RU/Server event}} Это событие вызывается, когда игрок отправляет сообщение в чат. ==Parameters== <syntaxhighl..."

__NOTOC__
{{RU/Server event}}
Это событие вызывается, когда игрок отправляет сообщение в чат.

==Parameters==
<syntaxhighlight lang="lua">
string message, int messageType
</syntaxhighlight>

*'''message'''. Строка, представляющая собой сообщение, введённое в чат.
*'''messageType'''. Целочисленное значение, представляющее тип сообщения:
**'''0'''. обычное сообщение;
**'''1'''. сообщение о действии (/me);
**'''2'''. командное сообщение.

==Источник==
[[RU/Event system#Источник|Источником]] этого события является [[RU/Element/Player|игрок]], который отправил сообщение в чат.

==Отмена эффекта==
Если это событие [[RU/Event system#Отмена событий|отменено]], система чата игры не будет отправлять сообщения. Вы можете использовать функцию [[RU/outputChatBox|outputChatBox]] для отправки потом сообщений.
Отмена этого события также означает, что чат не будет отображаться в консоли сервера или логах. Если Вы хотите вести логирование чата, Вам нужно будет добавить вызов функции [[RU/outputServerLog|outputServerLog]].

==Примеры==
'''Пример 1'''. В этом примере ограничивается приём сообщений чата сферической области вокруг игрока, который отправил сообщение, а также блокирует действие и текст команды.
<syntaxhighlight lang="lua">
local chatRadius = 20
function sendMessageToNearbyPlayers(message, messageType)
if messageType == 0 then
local posX, posY, posZ = getElementPosition(source)
local chatSphere = createColSphere(posX, posY, posZ, chatRadius)
local nearbyPlayers = getElementsWithinColShape(chatSphere, "player")
destroyElement(chatSphere)
for index, nearbyPlayer in ipairs(nearbyPlayers) do
outputChatBox(message, nearbyPlayer)
end
end
end
addEventHandler("onPlayerChat", getRootElement(), sendMessageToNearbyPlayers)
function blockChatMessage()
cancelEvent()
end
addEventHandler("onPlayerChat", getRootElement(), blockChatMessage)
</syntaxhighlight>

'''Пример 2'''. В этом примере реализованы цветные имена игроков в чате.
<syntaxhighlight lang="lua">
local function playerJoin()
local red, green, blue = math.random(50, 255), math.random(50, 255), math.random(50, 255)
setPlayerNametagColor(source, red, green, blue)
end
addEventHandler("onPlayerJoin", root, playerJoin)
local function playerChat(message, messageType)
if messageType == 0 then
cancelEvent()
local red, green, blue = getPlayerNametagColor(source)
outputChatBox(getPlayerName(source)..": #FFFFFF"..message, root, red, green, blue, true )
outputServerLog("Чат: "..getPlayerName(source)..": "..message)
end
end
addEventHandler("onPlayerChat", root, playerChat)
</syntaxhighlight>

'''Пример 3'''. В этом примере убивается тот игрок, который отправил в чат сообщение ''kill''.
<syntaxhighlight lang="lua">
function onChat(message, messageType)
if string.find(message, 'kill') then
killPed(source, source)
end
end
addEventHandler("onPlayerChat", getRootElement(), onChat)
</syntaxhighlight>

{{RU/See also/Server event|RU/Player events|События игрока}}

[[en:onPlayerChat]]

RU/onPlayerBan

2017-12-04T16:59:10Z

Reitside:

__NOTOC__
{{RU/Server event}}
Это событие вызывается, когда игрок добавляет [[RU/Ban|бан]] (например, [[RU/onBan|onBan]]).

==Параметры==
<syntaxhighlight lang="lua">
ban banPointer, player responsibleElement
</syntaxhighlight>

*'''banPointer'''. Указатель бана, который был добавлен.
*'''responsibleElement'''. Игрок, добавивший бан.

==Источник==
[[RU/Event system|Источником]] этого события является [[RU/Element/Player|игрок]], который был забанен.

==Пример==
'''Пример 1'''. В этом примере идёт вывод в чат игрока, добавившего бан (ответственный элемент) и имя забаненого игрока, когда происходит бан.
<syntaxhighlight lang="lua">
function outputBan(banPointer, responsibleElement)
local banner = getPlayerName(responsibleElement) or "Console"
outputChatBox("Игрок "..banner.." забанен игроком".. getPlayerName(source)..".", getRootElement(), 255, 0, 0)
end
addEventHandler("onPlayerBan", getRootElement(), outputBan)
</syntaxhighlight>

==Изменения==
{{RU/ChangelogHeader}}
{{ChangelogItem|1.3.0-9.03908|Исправлен параметр ответственного элемента}}

{{RU/See also/Server event|RU/Player events|События игрока}}

[[en:onPlayerBan]]

OnPlayerBan

2017-12-04T16:57:41Z

Reitside:

__NOTOC__
{{Server event}}
This event is triggered when a player added a [[ban]] (like [[onBan]]).

==Parameters==
<syntaxhighlight lang="lua">
ban banPointer, player responsibleElement
</syntaxhighlight>

*'''banPointer''': The ban pointer which was added.
*'''responsibleElement''': The player who added the ban

==Source==
The [[event system#Event source|source]] of this event is the [[player]] who was banned.

==Example==
This example outputs the responsible element and the banned player's name when a ban takes place.
<syntaxhighlight lang="lua">
function outputBan ( banPointer, responsibleElement ) -- Define the banner and the ban pointer in the function.
local banner = getPlayerName( responsibleElement ) or "Console" -- Get the banner's name.

outputChatBox ( banner .." has banned ".. getPlayerName( source ) ..".", getRootElement(), 255, 0, 0 ) -- Output the ban.
end
addEventHandler ( "onPlayerBan", getRootElement(), outputBan ) -- Trigger the function when there is a ban.
</syntaxhighlight>

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.3.0-9.03908|Fixed responsible element parameter}}

{{See also/Server event|Player events}}

[[ru:onPlayerBan]]

RU/onPlayerBan

2017-12-04T16:57:22Z

Reitside:

__NOTOC__
{{RU/Server event}}
Это событие вызывается, когда игрок добавляет [[RU/Ban|бан]] (например, [[RU/onBan|onBan]]).

==Параметры==
<syntaxhighlight lang="lua">
ban banPointer, player responsibleElement
</syntaxhighlight>

*'''banPointer'''. Указатель бана, который был добавлен.
*'''responsibleElement'''. Игрок, добавивший бан.

==Источник==
[[RU/Event system|Источником]] этого события является [[RU/Element/Player|игрок]], который был забанен.

==Пример==
'''Пример 1.''' В этом примере идёт вывод в чат игрока, добавившего бан (ответственный элемент) и имя запрещённого игрока, когда происходит бан.
<syntaxhighlight lang="lua">
function outputBan(banPointer, responsibleElement)
local banner = getPlayerName(responsibleElement) or "Console"
outputChatBox("Игрок "..banner.." забанен игроком".. getPlayerName(source)..".", getRootElement(), 255, 0, 0)
end
addEventHandler("onPlayerBan", getRootElement(), outputBan)
</syntaxhighlight>

==Изменения==
{{RU/ChangelogHeader}}
{{ChangelogItem|1.3.0-9.03908|Исправлен параметр ответственного элемента}}

{{RU/See also/Server event|RU/Player events|События игрока}}

[[en:onPlayerBan]]

RU/onConsole

2017-12-04T16:24:01Z

Reitside:

__NOTOC__
{{RU/Server event}}
Это событие вызывается, когда игрок вводит сообщение в свою консоль.

==Параметры==
<syntaxhighlight lang="lua">
string theMessage
</syntaxhighlight>

*'''theMessage''': строка, представляющая сообщение введенное в консоль.

==Источник==
[[event system#Event source|Источником]] данного события является [[player|игрок]], который вводит сообщение в консоль. Это может быть игрок или консоль сервера.

==Пример==
Этот пример добавляет ''мне'' команду в скрипт. Например, если игрок Боб вводит "мне нравится торт" в консоль, то появится "* Боб любит торт" в окне чата.

:'''ПРИМЕЧАНИЕ:''' этот скрипт только для примера. Это можно сделать более эффективным способом, с помощью [[addCommandHandler]].
<syntaxhighlight lang="lua">
function input_Console ( text ) -- когда игрок пишет в консоли
-- если этот игрок в игре
if ( getElementType ( source ) == "player" ) then
-- делим команду пробелами (ASCII 32) и получаем первую часть текста
local command = gettok ( text, 1, 32 )
-- если первая часть текста "me",
if ( command == "me" ) then
-- получаем имя игрока
local playerName = getPlayerName ( source )
-- получаем текст действий, путем вырезания первых 3 символов ("me ")
local actionText = string.sub ( text, 3 )
-- объявляем мне команду в чате
outputChatBox ( "* " .. playerName .. " " .. actionText, getRootElement(), 255, 255, 0 )
end
end
end
addEventHandler ( "onConsole", getRootElement(), input_Console ) -- добавляем обработчик событий для onConsole
</syntaxhighlight>

{{RU/See also/Server event|RU/Client events|События клиента}}

[[en:onConsole]]

RU/onPlayerBan

2017-12-04T16:23:27Z

Reitside:

__NOTOC__
{{RU/Server event}}
Это событие вызывается, когда игрок добавляет [[RU/Ban|бан]] (например, [[RU/onBan|onBan]]).

==Параметры==
<syntaxhighlight lang="lua">
ban banPointer, player responsibleElement
</syntaxhighlight>

*'''banPointer'''. Указатель бана, который был добавлен.
*'''responsibleElement'''. Игрок, добавивший бан.

==Источник==
[[RU/Event system|Источником]] этого события является [[RU/Element/Player|игрок]], который был забанен.

==Пример==
'''Пример 1.''' В этом примере идёт вывод в чат игрока, добавившего бан (ответственный элемент) и имя запрещённого игрока, когда происходит бан.
<syntaxhighlight lang="lua">
function outputBan(banPointer, responsibleElement)
local banner = getPlayerName(responsibleElement) or "Console"
outputChatBox("Игрок "..banner.." забанен игроком".. getPlayerName(source)..".", getRootElement(), 255, 0, 0)
end
addEventHandler("onPlayerBan", getRootElement(), outputBan)
</syntaxhighlight>

==Изменения==
{{RU/ChangelogHeader}}
{{ChangelogItem|1.3.0-9.03908|Исправлен параметр ответственного элемента}}

{{RU/See also/Server event|RU/Player events|События игрока}}

Template:RU/See also/Event

2017-12-04T16:23:15Z

Reitside:

==Смотрите также==
==={{{2}}}===
{{{{{1}}}}}
===Функции событий===
{{RU/Event functions}}

RU/onPlayerBan

2017-12-04T16:06:59Z

Reitside:

__NOTOC__
{{RU/Server event}}
Это событие вызывается, когда игрок добавляет [[RU/Ban|бан]] (например, [[RU/onBan|onBan]]).

==Параметры==
<syntaxhighlight lang="lua">
ban banPointer, player responsibleElement
</syntaxhighlight>

*'''banPointer'''. Указатель бана, который был добавлен.
*'''responsibleElement'''. Игрок, добавивший бан.

==Источник==
[[RU/Event system|Источником]] этого события является [[RU/Element/Player|игрок]], который был забанен.

==Пример==
'''Пример 1.''' В этом примере идёт вывод в чат игрока, добавившего бан (ответственный элемент) и имя запрещённого игрока, когда происходит бан.
<syntaxhighlight lang="lua">
function outputBan(banPointer, responsibleElement)
local banner = getPlayerName(responsibleElement) or "Console"
outputChatBox("Игрок "..banner.." забанен игроком".. getPlayerName(source)..".", getRootElement(), 255, 0, 0)
end
addEventHandler("onPlayerBan", getRootElement(), outputBan)
</syntaxhighlight>

==Изменения==
{{RU/ChangelogHeader}}
{{ChangelogItem|1.3.0-9.03908|Исправлен параметр ответственного элемента}}

{{RU/See also/Server event|RU/Player events}}

RU/onPlayerBan

2017-12-04T16:04:38Z

Reitside:

__NOTOC__
{{RU/Server event}}
Это событие вызывается, когда игрок добавляет [[RU/Ban|бан]] (например, [[RU/onBan|onBan]]).

==Параметры==
<syntaxhighlight lang="lua">
ban banPointer, player responsibleElement
</syntaxhighlight>

*'''banPointer'''. Указатель бана, который был добавлен.
*'''responsibleElement'''. Игрок, добавивший бан.

==Источник==
[[RU/Event system|Источником]] этого события является [[RU/Element/Player|игрок]], который был забанен.

==Пример==
'''Пример 1.''' В этом примере идёт вывод в чат игрока, добавившего бан (ответственный элемент) и имя запрещённого игрока, когда происходит бан.
<syntaxhighlight lang="lua">
function outputBan(banPointer, responsibleElement)
local banner = getPlayerName(responsibleElement) or "Console"
outputChatBox(Игрок "..banner.." забанен игроком".. getPlayerName(source)..".", getRootElement(), 255, 0, 0)
end
addEventHandler("onPlayerBan", getRootElement(), outputBan)
</syntaxhighlight>

==Изменения==
{{RU/ChangelogHeader}}
{{ChangelogItem|1.3.0-9.03908|Исправлен параметр ответственного элемента}}

{{RU/See also/Server event|RU/Player events}}

RU/onPlayerBan

2017-12-04T16:04:10Z

Reitside: Created page with "__NOTOC__ {{RU/Server event}} Это событие вызывается, когда игрок добавляет бан (например, onBan). =..."

__NOTOC__
{{RU/Server event}}
Это событие вызывается, когда игрок добавляет [[RU/ban|бан]] (например, [[RU/onBan|onBan]]).

==Параметры==
<syntaxhighlight lang="lua">
ban banPointer, player responsibleElement
</syntaxhighlight>

*'''banPointer'''. Указатель бана, который был добавлен.
*'''responsibleElement'''. Игрок, добавивший бан.

==Источник==
[[RU/Event system|Источником]] этого события является [[RU/Element/Player|игрок]], который был забанен.

==Пример==
'''Пример 1.''' В этом примере идёт вывод в чат игрока, добавившего бан (ответственный элемент) и имя запрещённого игрока, когда происходит бан.
<syntaxhighlight lang="lua">
function outputBan(banPointer, responsibleElement)
local banner = getPlayerName(responsibleElement) or "Console"
outputChatBox(Игрок "..banner.." забанен игроком".. getPlayerName(source)..".", getRootElement(), 255, 0, 0)
end
addEventHandler("onPlayerBan", getRootElement(), outputBan)
</syntaxhighlight>

==Изменения==
{{RU/ChangelogHeader}}
{{ChangelogItem|1.3.0-9.03908|Исправлен параметр ответственного элемента}}

{{RU/See also/Server event|RU/Player events}}

Template:RU/ChangelogHeader

2017-12-04T15:54:56Z

Reitside: Created page with "{| cellpadding="4" style="border-collapse: collapse; border-width: 1px; border-style: solid; border-color: #FFF" |- !width=140 style="background-color: #d0d0e0; border-style:..."

{| cellpadding="4" style="border-collapse: collapse; border-width: 1px; border-style: solid; border-color: #FFF"
|-
!width=140 style="background-color: #d0d0e0; border-style: solid; border-width: 1px; border-color: #FFF; color:#00000"| Версия
!width=500 style="white-space: nowrap; background-color: #d0d0e0; border-style: solid; border-width: 1px; border-color: #FFF"| Описание
|}

RU/Server Scripting Events

2017-12-04T14:04:56Z

Reitside:

<pageclass class="server"></pageclass>
На этой странице располагается список всех '''серверных''' [[RU/Event system|событий]] скриптинга, которые были реализованы и доступны в моде Deathmatch.

Чтобы запросить новую функцию или событие, напишите об этом [[Requested Functions and Events|сюда]].

'''Клиентские события скриптинга можно найти [[RU/Client Scripting Events| здесь]].

==События игрока==
{{RU/Player_events}}

==События клиента==
{{RU/Client_events}}

==События колшейпа==
{{RU/Colshape_events}}

==События маркера==
{{RU/Marker_events}}

==События оружия==
{{RU/Weapon_events}}

==События педа==
{{RU/Ped_events}}

==События пикапа==
{{RU/Pickup_events}}

==События ресурса==
{{RU/Resource_events}}

==События сервера==
{{RU/Server_events}}

==События транспорта==
{{RU/Vehicle_events}}

==События элемента==
{{RU/Element_events}}

[[en:Server Scripting Events]]
[[fr:Server Scripting Events]]
[[pt-br:Eventos de Scripting do Servidor]]
[[tr:Server Scripting Events]]

RU/Event system

2017-12-04T14:03:25Z

Reitside: Created page with "__NOTOC__ Система событий лежит в основе MTA-скриптинга. События тесно связаны с RU/Element_tree|деревом эл..."

__NOTOC__
Система событий лежит в основе MTA-скриптинга. События тесно связаны с [[RU/Element_tree|деревом элементов]]. События срабатывают, когда что-либо происходит: игрок встаёт на маркер, выбирается элемент и т.д. Каждое событие имеет исходный элемент, а именно элемент, который выполнил действие

==Обработчики событий==
Чтобы использовать систему событий, Вы присоединяете обработчики событий к элементам в дереве элементов с помощью функции [[RU/addEventHandler|addEventHandler]]. Когда Вы это сделаете, Ваша функция будет активирована для всех событий, инициированных этим элементом, это родители (и их родители) и дети (и их дети). Таким образом, обработчик событий, прикрепленный к корневому элементу, запускается, когда событие происходит для любого элемента. Как правило, Вы должны обычно использовать специфичный обработчик, как можете. Если Вы хотите просто увидеть, когда игрок встаёт на определённый маркер, просто присоедините обработчик события к этому маркеру.

Каждый обработчик событий имеет три "скрытые" переменные:
* '''source'''. Это элемент, от которого произошло событие.
* '''this'''. Это элемент, на который запускается обработчик (т.е. тот, к которому Вы привязывали его функцией addEventHandler).
* '''eventName'''. Это строка имени события, которое было вызвано (т.е имя, которое было добавлено функцией addEventHandler).

Кроме того, серверная система событий также имеет ещё одну "скрытую" переменную:
* '''client''': Это клиент, который вызвал событие с помощью функции [[RU/triggerServerEvent|triggerServerEvent]]. Это значение не задано, если событие не было инициировано клиентом.

Исходная переменная является наиболее важной для большинства обработчиков. Вы почти всегда захотите ссылаться на эту переменную, чтобы сообщить, какой элемент вызвал событие. Эта переменная используется для обеспечения того, чтобы событие было вызвано элементом, к которому присоединён обработчик.

Важно отметить, что события следуют за иерархией элементов. Все события изначально запускаются в элементе ''source'', за которым следуют все родительские и дочерние элементы. Это имеет мало важных последствий:

* Событие, инициированное на корневом элементе, будет инициировано для каждого элемента в дереве элементов. Этого следует избегать, когда это возможно.
* Все события в любом месте дерева элементов будут инициированы на корневом элементе. Это означает, что вы можете легко поймать каждое событие типа, связав обработчик с корневым элементом. Это следует делать только в том случае, если действительно требуется любое событие этого типа, иначе же прикрепите его к более специфичному элементу дерева элементов.
* Вы можете прикрепить обработчик события к корневому элементу вашего ресурса, чтобы получить все события, инициированные элементами, содержащими Ваш ресурс.
* Вы можете создавать фиктивные элементы для захвата событий из группы дочерних элементов.
* Вы можете использовать фиктивные элементы, указанные в файле ''.map'' (например, ''<flag>'') и создать для них реальные представления (например, объекты), и сделать эти реальные элементы дочерними элементами фиктивного элемента. Обработчики событий затем могут быть прикреплены к фиктивному элементу и будут получать все события реальных элементов. Это полезно, когда один ресурс управляет представлением элемента (например, создавая объекты), а другой хочет обрабатывать специальные события. Это может быть ресурс карты, который хочет обработать флаг, захваченный определенным образом. Ресурс карты, как правило, не будет знать о том, как представлен флаг. Это не имеет значения, поскольку он может просто привязывать обработчики к своему фиктивному элементу флага, в то время как другой ресурс игрового режима может обрабатывать представление.

Функция, которую Вы привязали к событию, вызывается и передает множество аргументов. Эти аргументы специфичны для событий. Каждое событие имеет определенные параметры, например [[RU/onClientGUIClick|onClientGUIClick]] имеет 4 параметра.
<syntaxhighlight lang="lua">string button, string state, int absoluteX, int absoluteY</syntaxhighlight>
Функция, которую Вы привязали к этому событию, будет передана этими параметрами в качестве аргументов. Вы должны помнить, что каждое событие имеет разные параметры.

==Встроенные события==
MTA имеет ряд встроенных событий. Они перечислены на страницах "[[RU/Client Scripting Events|Клиентские события скриптинга]]" и "[[RU/Scripting Events|Скриптинговые события]]".

==Пользовательские события==
Вы можете создавать свои собственные события, которые могут запускаться во всех ресурсах. Это важный способ связаться с другими ресурсами и позволить им подключиться к вашему коду. Чтобы добавить свое собственное событие, просто вызовите функцию [[RU/addEvent|addEvent]]. Затем Вы можете использовать функцию [[RU/triggerEvent|triggerEvent]] для запуска этого события в любое время: либо с использованием таймера, либо на основе более общего события.

Например, Вы можете сделать игровой режим ''Capture the Flag'' и вызвать событие, когда игрок фиксирует флаг. Вы можете сделать это, связав обработчик события со стандартным событием MTA [[RU/onMarkerHit|onMarkerHit]] и проверив, что игрок, входящий в маркер, имеет флаг. Если Вы сделаете это, Вы можете затем запустить своё более специфическое событие ''onFlagCaptured'', и другие ресурсы смогут справиться с этим, как им заблагорассудится.

==Отмена событий==
События могут быть отменены с помощью функции [[RU/cancelEvent|cancelEvent]]. Это может иметь множество последствий, но в целом это означает, что сервер не будет выполнять никаких действий, которые обычно выполняются. Например, отмена события [[RU/onPickupUse|onPickupUse]] не позволит игроку использовать пикап, отмена события [[RU/onVehicleStartEnter|onVehicleStartEnter]] помешает игроку войти в транспорт. Вы можете проверить, было ли отменено текущее активное событие, используя функцию [[RU/wasEventCanceled|wasEventCanceled]]. Важно отметить, что событие отмены не предотвращает запуск других обработчиков событий.

[[Category:Scripting Concepts]]
[[en:Event system]]
[[es:Sistema de eventos]]
[[pt-br:Sistema de eventos]]

Event system

2017-12-04T14:03:21Z

Reitside:

__NOTOC__
The event system is at the core of MTA scripting. Events work closely in conjunction with the element tree. Events are triggered when something happens - a player enters a marker, an element is clicked on etc. Each event has a source element, this is the element that performed the action.

==Event handlers==
To use the event system, you attach event handlers to elements in the element tree using [[addEventHandler]]. When you do this, your function will get triggered for all the events triggered on that element, it's parents (and their parents, etc.) and it's children (and their children). As such, an event handler attached to the ''root'' element will be triggered when an event occurs for any element. As a consequence you should generally use as specific a handler as you can. If you wish to just see when the player enters a specific marker, just attach the event handler to that marker.

Each event handler has three 'hidden' variables:
* '''source''': This is the element that the event originated from.
* '''this''': This is the element that the handler is being triggered on (i.e. the one you attached it to with addEventHandler).
* '''eventName''': This is the string of the name of the event that was called upon (i.e. the event name that was added with addEventHandler).

Additionally, the server-side event system also has one more 'hidden' variable:
* '''client''': This is the client that triggered the event using triggerServerEvent. This is not set if the event was not triggered from a client.

The ''source'' variable is the most important one for most handlers. You almost always will want to reference this variable to tell what element triggered the event. The ''this'' variable has some uses for ensuring that an event was emitted by the element that you attached the handler to.

It is ''important'' to note that events follow the element hierachy. All events are initially triggered on the ''source'' element, followed by all the parent and children elements. This has few important implications:

* An event triggered on the root element will be triggered on every element in the element tree. This should be avoided where possible.
* All events anywhere in the element tree will be triggered on the root element. This means you can easily catch every event of a type by attaching a handler to the root element. Only do this if you genuinely want every event of that type, otherwise attach it somewhere more specific in the element tree.
* You can attach an event handler to your resource's root element to get all the events triggered by elements your resource contains.
* You can create 'dummy' elements to catch events from a group of child elements
* You can use dummy elements specified in a .map file (e.g. <flag>) and create 'real' representations for them (e.g. objects) and make these real elements children of the dummy element. Event handlers can then be attached to the dummy element and it will receive all the events of the real elements. This is useful for when one resource manages the representation of the element (creating the objects, for example), while another wants to handle special events. This could be a map resource that wants to handle a flag being captured in a specific way - the map resource would (generally) not be aware of the way the flag is represented. This doesn't matter as it can just attach handlers to it's dummy flag element while the other gamemode resource can handle the representation.

The function you attached to an event gets called and passed a bunch of arguments. These arguments are event-specific. Each event has specific parameters, for instance [[onClientGUIClick]] has 4 parameters, which are:
<syntaxhighlight lang="lua">string button, string state, int absoluteX, int absoluteY</syntaxhighlight>
The function you attached to this event will be passed these parameters as arguments. You must remember that each event has different parameters.

==Built in events==
MTA has a number of built in events. These are listed on the pages [[Client Scripting Events]] and [[Scripting Events]].

==Custom events==
You can create your own events that can be triggered across all resources. This is an important way to communicate with other resources and allow them to hook into your code. To add your own custom event, just call the [[addEvent]] function. You can then use the [[triggerEvent]] function to trigger that event any time you want - either using a timer, or based on a more general event.

For example, you could be making a Capture the Flag game mode and want to trigger an event when a player captures the flag. You could do this by attaching a event handler to the standard MTA [[onMarkerHit]] event and checking that the player entering the marker has the flag. if they do, you can then trigger your more specific ''onFlagCaptured'' event and other resources could handle this as they please.

==Canceling==
Events can be canceled with [[cancelEvent]]. This can have a variety of effects, but in general this means that the server will not perform whatever action it would usually do. For example, canceling [[onPickupUse]] would prevent a player being given what they tried to pick up, canceling [[onVehicleStartEnter]] would prevent the player entering the vehicle. You can check if the currently active event has been canceled using [[wasEventCanceled]]. It's important to note that canceling event ''does not'' prevent other event handlers being triggered.

[[Category:Scripting Concepts]]
[[es:Sistema de eventos]]
[[pt-br:Sistema de eventos]]
[[ru:Event system]]

RU/Server Scripting Events

2017-12-03T19:40:01Z

Reitside:

<pageclass class="server"></pageclass>
На этой странице располагается список всех '''серверных''' [[RU/Event system|событий]] скриптинга, которые были реализованы и доступны в моде Deathmatch.

Чтобы запросить новую функцию или событие, напишите об этом [[RU/Requested Functions and Events|сюда]].

'''Клиентские события скриптинга можно найти [[RU/Client Scripting Events| здесь]].

==События игрока==
{{RU/Player_events}}

==События клиента==
{{RU/Client_events}}

==События колшейпа==
{{RU/Colshape_events}}

==События маркера==
{{RU/Marker_events}}

==События оружия==
{{RU/Weapon_events}}

==События педа==
{{RU/Ped_events}}

==События пикапа==
{{RU/Pickup_events}}

==События ресурса==
{{RU/Resource_events}}

==События сервера==
{{RU/Server_events}}

==События транспорта==
{{RU/Vehicle_events}}

==События элемента==
{{RU/Element_events}}

[[en:Server Scripting Events]]
[[fr:Server Scripting Events]]
[[pt-br:Eventos de Scripting do Servidor]]
[[tr:Server Scripting Events]]

RU/Server Scripting Events

2017-12-03T19:36:14Z

Reitside:

<pageclass class="server"></pageclass>
На этой странице располагается список всех '''серверных''' [[RU/Event system|событий]] скриптинга, которые были реализованы и доступны в моде Deathmatch.

Чтобы запросить новую функцию или событие, напишите об этом [[RU/Requested Functions and Events|сюда]].

'''Клиентские события скриптинга можно найти [[RU/Client Scripting Events| здесь]].

==События игроков==
{{RU/Player_events}}

==События клиента==
{{RU/Client_events}}

==События колшейпа==
{{RU/Colshape_events}}

==События маркера==
{{RU/Marker_events}}

==События оружия==
{{RU/Weapon_events}}

==События педа==
{{RU/Ped_events}}

==События пикапов==
{{RU/Pickup_events}}

==События ресурса==
{{RU/Resource_events}}

==События сервера==
{{RU/Server_events}}

==События транспорта==
{{RU/Vehicle_events}}

==События элемента==
{{RU/Element_events}}

[[en:Server Scripting Events]]
[[fr:Server Scripting Events]]
[[pt-br:Eventos de Scripting do Servidor]]
[[tr:Server Scripting Events]]

Template:RU/Weapon events

2017-12-03T19:32:20Z

Reitside: Created page with "{{New items|3.0140|1.4 r4876| * onWeaponFire }}"

{{New items|3.0140|1.4 r4876|
* [[RU/onWeaponFire|onWeaponFire]]
}}

Template:RU/Server events

2017-12-03T19:31:03Z

Reitside:

*[[RU/onBan|onBan]]
*[[RU/onDebugMessage|onDebugMessage]]
*[[RU/onSettingChange|onSettingChange]]
*[[RU/onAccountDataChange|onAccountDataChange]]
*[[RU/onUnban|onUnban]]
{{New items|3.0120|1.2|
*[[RU/onChatMessage|onChatMessage]]
}}
<noinclude>[[Category:Events templates]]</noinclude>

Template:RU/Resource events

2017-12-03T19:30:02Z

Reitside: Created page with "*onResourceStart {{New items|3|1.0| *onResourcePreStart }} *onResourceStop <noinclude>Category:Events..."

*[[RU/onResourceStart|onResourceStart]]
{{New items|3|1.0|
*[[RU/onResourcePreStart|onResourcePreStart]]
}}
*[[RU/onResourceStop|onResourceStop]]
<noinclude>[[Category:Events templates]]</noinclude>

Template:RU/Player events

2017-12-03T19:29:17Z

Reitside: Created page with "*onPlayerBan *onPlayerChat *onPlayerPrivateMessage *onPlayerConnect *RU/onPlayerC..."

*[[RU/onPlayerBan|onPlayerBan]]
*[[RU/onPlayerChat|onPlayerChat]]
*[[RU/onPlayerPrivateMessage|onPlayerPrivateMessage]]
*[[RU/onPlayerConnect|onPlayerConnect]]
*[[RU/onPlayerChangeNick|onPlayerChangeNick]]
*[[RU/onPlayerLogin|onPlayerLogin]]
*[[RU/onPlayerLogout|onPlayerLogout]]
*[[RU/onPlayerDamage|onPlayerDamage]]
*[[RU/onPlayerJoin|onPlayerJoin]]
*[[RU/onPlayerQuit|onPlayerQuit]]
*[[RU/onPlayerSpawn|onPlayerSpawn]]
*[[RU/onPlayerWasted|onPlayerWasted]]
*[[RU/onPlayerTarget|onPlayerTarget]]
*[[RU/onPlayerVehicleEnter|onPlayerVehicleEnter]]
*[[RU/onPlayerVehicleExit|onPlayerVehicleExit]]
{{New items|3.0153|1.5.3|
*[[RU/onPlayerWeaponFire|onPlayerWeaponFire]]
|9921}}
*[[RU/onPlayerWeaponSwitch|onPlayerWeaponSwitch]]
*[[RU/onPlayerMarkerHit|onPlayerMarkerHit]]
*[[RU/onPlayerMarkerLeave|onPlayerMarkerLeave]]
*[[RU/onPlayerPickupHit|onPlayerPickupHit]]
*[[RU/onPlayerPickupUse|onPlayerPickupUse]]
*[[RU/onPlayerClick|onPlayerClick]]
*[[RU/onPlayerContact|onPlayerContact]]
*[[RU/onPlayerStealthKill|onPlayerStealthKill]]
*[[RU/onPlayerMute|onPlayerMute]]
*[[RU/onPlayerUnmute|onPlayerUnmute]]
*[[RU/onPlayerCommand|onPlayerCommand]]
{{New items|3.0152|1.5.1-7633|
*[[RU/onPlayerACInfo|onPlayerACInfo]]
}}
*[[RU/onPlayerModInfo|onPlayerModInfo]]
*[[RU/onPlayerVoiceStart|onPlayerVoiceStart]]
*[[RU/onPlayerVoiceStop|onPlayerVoiceStop]]
*[[RU/onPlayerScreenShot|onPlayerScreenShot]]
{{New items|3.0142|1.4.1-7295|
*[[RU/onPlayerNetworkStatus|onPlayerNetworkStatus]]
}}
<noinclude>[[Category:Events templates]]</noinclude>

Template:RU/Pickup events

2017-12-03T19:26:42Z

Reitside: Created page with "*onPickupSpawn *onPickupHit *onPickupUse"

*[[RU/onPickupSpawn|onPickupSpawn]]
*[[RU/onPickupHit|onPickupHit]]
*[[RU/onPickupUse|onPickupUse]]

Template:RU/Ped events

2017-12-03T19:26:14Z

Reitside: Created page with "{{New items|3|1.0| *onPedWasted *onPedWeaponSwitch }} <noinclude>Category:Events templates</noinclude>"

{{New items|3|1.0|
*[[RU/onPedWasted|onPedWasted]]
*[[RU/onPedWeaponSwitch|onPedWeaponSwitch]]
}}
<noinclude>[[Category:Events templates]]</noinclude>

Template:RU/Marker events

2017-12-03T19:25:41Z

Reitside: Created page with "*onMarkerHit *onMarkerLeave"

*[[RU/onMarkerHit|onMarkerHit]]
*[[RU/onMarkerLeave|onMarkerLeave]]

Template:RU/Element events

2017-12-03T19:25:10Z

Reitside: Created page with "*onElementDestroy *onElementDataChange *onElementColShapeHit *RU/onElementColShapeLeave|onElem..."

*[[RU/onElementDestroy|onElementDestroy]]
*[[RU/onElementDataChange|onElementDataChange]]
*[[RU/onElementColShapeHit|onElementColShapeHit]]
*[[RU/onElementColShapeLeave|onElementColShapeLeave]]
*[[RU/onElementClicked|onElementClicked]]
*[[RU/onElementStartSync|onElementStartSync]]
*[[RU/onElementStopSync|onElementStopSync]]
*[[RU/onElementModelChange|onElementModelChange]]
<noinclude>[[Category:Events templates]]</noinclude>

Template:RU/Colshape events

2017-12-03T19:24:09Z

Reitside: Created page with "*onColShapeHit *onColShapeLeave"

*[[RU/onColShapeHit|onColShapeHit]]
*[[RU/onColShapeLeave|onColShapeLeave]]

RU/Weather

2017-12-03T11:38:45Z

Reitside:

Погода может быть изменена с помощью функций [[RU/setWeather|setWeather]] и [[RU/setWeatherBlended|setWeatherBlended]]. В GTA:SA каждая погода имеет разные параметры для восхода солнца, утра, в полдень, после полудня, заката солнца, ночи и полуночи, поэтому погода может сильно различаться по времени дня.

{{New feature|3|1.0|
Также поддерживаются нестандартные погодные идентификаторы, начиная с 20 и заканчивая 255, но в некоторых моментах дня они могут быть нестабильными.
}}

MTA:SA имеет пользовательские функции погоды, которые могут изменять способ визуализации погоды, но в этом списке погода описывается без учета этого. Кроме того, использование [[RU/setWeatherBlended|setWeatherBlended]] позволяет получить больше недокументированных эффектов.

Полная галерея погоды, содержащая изображения каждого идентификатора погоды (от 0 до 255), зафиксированного в каждый игровой час, находится [http://dev.prineside.com/ru/gtasa_weather_id/ здесь].

==Стандартные идентификаторы погоды в GTA:SA (зарегистрировано в ''timecyc.dat'')==
{|class="wikitable" style="margin: 1em auto 1em auto;"
|-
! ID погоды || Название из ''timecyc.dat'' || Скриншоты в 12:00 || Описание
|-
! 0
| EXTRASUNNY_LA
| [[File:Weather 0.png|150px|thumb|center|Применяет эффект теплового тумана]]
| rowspan="5" style="margin-left:10px; | В одиночной игре это '''специфические погодные условия в Los Santos'''.<br>Это ясная погода с голубым небом и несколькими облаками.
|-
! 1
| SUNNY_LA
| [[File:Weather 1.png|150px|thumb|center]]
|-
! 2
| EXTRASUNNY_SMOG_LA
| [[File:Weather 2.png|150px|thumb|center]]
|-
! 3
| SUNNY_SMOG_LA
| [[File:Weather 3.png|150px|thumb|center]]
|-
! 4
| CLOUDY_LA
| [[File:Weather 4.png|150px|thumb|center]]
|-
! 5
| SUNNY_SF
| [[File:Weather 5.png|150px|thumb|center]]
| rowspan="5" style="margin-left:10px; | В одиночной игре это '''специфические погодные условия в San Fierro'''.<br>Они более разнообразные, чем в Los Santos: некоторые из них ясные, а другие - дождливые или туманные.
|-
! 6
| EXTRASUNNY_SF
| [[File:Weather 6.png|150px|thumb|center]]
|-
! 7
| CLOUDY_SF
| [[File:Weather 7.png|150px|thumb|center]]
|-
! 8
| RAINY_SF
| [[File:Weather 8.png|150px|thumb|center|Начинает грозу с дождём и молниями]]
|-
! 9
| FOGGY_SF
| [[File:Weather 9.png|150px|thumb|center|Начинает облачный, густой туман]]
|-
! 10
| SUNNY_VEGAS
| [[File:Weather 10.png|150px|thumb|center]]
| rowspan="3" style="margin-left:10px; | В одиночной игре это '''специфические погодные условия в Las Venturas'''.<br>Они ясные и сухие.
|-
! 11
| EXTRASUNNY_VEGAS
| [[File:Weather 11.png|150px|thumb|center|Применяет жаркую погоду с эффектом теплового тумана]]
|-
! 12
| CLOUDY_VEGAS
| [[File:Weather 12.png|150px|thumb|center]]
|-
! 13
| EXTRASUNNY_COUNTRYSIDE
| [[File:Weather 13.png|150px|thumb|center]]
| rowspan="4" style="margin-left:10px; | В одиночной игре это '''специфические погодные условия в сельской местности в Los Santos'''.<br>Они тусклые, туманные, и дождливые.
|-
! 14
| SUNNY_COUNTRYSIDE
| [[File:Weather 14.png|150px|thumb|center]]
|-
! 15
| CLOUDY_COUNTRYSIDE
| [[File:Weather 15.png|150px|thumb|center]]
|-
! 16
| RAINY_COUNTRYSIDE
| [[File:Weather 16.png|150px|thumb|center|Начинает грозу]]
|-
! 17
| EXTRASUNNY_DESERT
| [[File:Weather 17.png|150px|thumb|center|Применяет эффект теплового тумана]]
| rowspan="3" style="margin-left:10px; | В одиночной игре это '''специфические погодные в Bone County'''.<br>Они ясные, сухие и жаркие.
|-
! 18
| SUNNY_DESERT
| [[File:Weather 18.png|150px|thumb|center|Применяет эффект теплового тумана]]
|-
! 19
| SANDSTORM_DESERT
| [[File:Weather 19.png|150px|thumb|center|Начинает густую песчаную бурю]]
|-
! 20
| UNDERWATER
| [[File:Weather 20.png|150px|thumb|center]]
| style="margin-left:10px; | В одиночной игре это, вероятно, '''погода, используемая в воде'''.<br>Она зеленоватая и облачная, поэтому кажется, что она какая-то "загрязнённая".
|-
! 21
| EXTRACOLOURS_1
| [[File:Weather 21.png|150px|thumb|center|Добавляет фиолетовый цвет к небу и объектам]]
| rowspan="2" style="margin-left:10px; | В одиночной игре это '''погода, используемая в интерьерах'''.<br>Она тёмная с градиентными цветами линии горизонта.
|-
! 22
| EXTRACOLOURS_2
| [[File:Weather 22.png|150px|thumb|center|Добавляет черно-белое небо и однородный свет к объектам]]
|-
|}

==Прочие идентификаторы погоды==
* '''23 - 26'''. Бледно-оранжевая погода.
* '''27 - 29'''. Свежая синяя погода.
* '''30 - 32'''. Темная, облачная, синеватая погода.
* '''33'''. Темная, облачная, бурая погода.
* '''34'''. Сине-фиолетовая, постоянная погода.
* '''35'''. Тускло-коричневая погода.
* '''36 - 38'''. Яркая, туманная, оранжевая погода.
* '''39'''. Очень яркая погода. Ночь выглядит как день.
* '''40 - 42'''. Сине-фиолетовая, пасмурная погода.
* '''43'''. Токсичные, загрязнённые облака.
* '''44'''. Черно-белое небо, похожее на '''22'''.
* '''45 - 60'''. Нормальная в визуальном плане погода с графическими ошибками на вечер.
* '''100'''. Странная погода, из-за которой объекты исчезают.
* '''118'''. Бурная погода с розовым небом и хрустальной водой.
* '''126 - 150'''. Ужасно мигающая красная погода.
* '''151 - 175'''. Дальняя погода с розовыми, фиолетовыми и бирюзовыми облаками.

==Смотрите также==
[[RU/Id|Список идентификаторов]]

[[de:Wetter]]
[[en:Weather]]
[[es:Climas]]
[[pl:Weather]]

[[Category:RU/ID Lists]]

RU/Modules/MTA-MySQL/mysql select db

2017-12-02T16:43:21Z

Reitside:

<pageclass class="#AA7592" subcaption="Модуль MTA MySQL"></pageclass>
__NOTOC__
{{RU/ModuleFunction|MTA-MySQL|MTA MySQL}}
Изменяет текущую базу данных по умолчанию.

==Синтаксис==
<syntaxhighlight lang="lua">
bool mysql_select_db(MySQLConnection handler, string database)
</syntaxhighlight>
===Обязательные аргументы===
* '''handler'''. Действительная MySQL-ссылка.
* '''database'''. Новое имя базы данных.

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

==Пример==
'''Пример 1:''' В этом примере изменяется текущая база данных по умолчанию на ''another_database''.
<syntaxhighlight lang="lua">
local handler = mysql_connect("localhost", "user", "password", "my_mta_server")
if not mysql_select_db(handler, "another_database") then
outputDebugString("Невозможно изменить базу данных по умолчанию. Причина ошибки: "..mysql_error(handler).." ("..mysql_error(handler)..").")
end
</syntaxhighlight>

==Смотрите также==
{{RU/Modules/MTA-MySQL/Handler_functions}}

[[EN:Modules/MTA-MySQL/mysql_select_db]]