RU/onPlayerConnect - Revision history

Reitside at 18:42, 5 December 2017

2017-12-05T18:42:16Z

← Older revision		Revision as of 18:42, 5 December 2017
Line 49:		Line 49:
	</syntaxhighlight>		</syntaxhighlight>

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

	[[en:onPlayerConnect]]		[[en:onPlayerConnect]]

Reitside at 18:21, 5 December 2017

2017-12-05T18:21:12Z

← Older revision		Revision as of 18:21, 5 December 2017
Line 22:		Line 22:
	Если это событие [[RU/Event system#Отмена событий\|отменено]], игрок будет отключён с сообщением об ошибке, указывающим причину, указанную в функции [[RU/cancelEvent\|cancelEvent]], или "Disconnected: server refused the connection", если ни одна из причин не указана.		Если это событие [[RU/Event system#Отмена событий\|отменено]], игрок будет отключён с сообщением об ошибке, указывающим причину, указанную в функции [[RU/cancelEvent\|cancelEvent]], или "Disconnected: server refused the connection", если ни одна из причин не указана.

	==~~Пример~~==		==Примеры==
	'''Пример 1'''. В этом примере запрещается подключение игроков, использующих ник ''Player'' или, в противном случае, выводятся некоторые данные о подключающемся игроке.		'''Пример 1'''. В этом примере запрещается подключение игроков, использующих ник ''Player'' или, в противном случае, выводятся некоторые данные о подключающемся игроке.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
Line 36:		Line 36:
	addEventHandler("onPlayerConnect", getRootElement(), playerConnect)		addEventHandler("onPlayerConnect", getRootElement(), playerConnect)
	</syntaxhighlight>		</syntaxhighlight>


	'''Пример 2'''. В этом примере закрывается соединение, если игрок старую версию MTA (ниже 1.0.3).		'''Пример 2'''. В этом примере закрывается соединение, если игрок старую версию MTA (ниже 1.0.3).

Reitside at 14:49, 5 December 2017

2017-12-05T14:49:02Z

← Older revision		Revision as of 14:49, 5 December 2017
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{RU/Server event}}		{{RU/Server event}}
	Это ~~события~~ вызывается, когда игрок пытается подключиться к серверу.		Это событие вызывается, когда игрок пытается подключиться к серверу.
	{{RU/Important Note\|Никогда, ни при каких обстоятельствах не следует изменять [[RU/Element/Player\|игрока]], возвращаемого функцией [[RU/getPlayerFromName\|getPlayerFromName]], перед событием [[RU/onPlayerJoin\|onPlayerJoin]], дабы избежать десинхронизации (например, [[RU/setPlayerName\|setPlayerName]]).}}		{{RU/Important Note\|Никогда, ни при каких обстоятельствах не следует изменять [[RU/Element/Player\|игрока]], возвращаемого функцией [[RU/getPlayerFromName\|getPlayerFromName]], перед событием [[RU/onPlayerJoin\|onPlayerJoin]], дабы избежать десинхронизации (например, [[RU/setPlayerName\|setPlayerName]]).}}

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

2017-12-05T14:48:16Z

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

New page

__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 - Revision history

Reitside at 18:42, 5 December 2017

Reitside at 18:21, 5 December 2017

Reitside at 14:49, 5 December 2017

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

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