View source for RU/onPlayerConnect

__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]]