RU/onPlayerChangeNick: Difference between revisions

Revision as of 18:40, 5 December 2017

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

Параметры

string oldNick, string newNick, bool changedByUser

oldNick. Ник, который игрок имел раньше.
newNick. Новый ник игрока.

9765

Источник

Источником этого события является игрок, который изменил свой ник.

Отмена эффекта

Отмена этого события зависит от того, как оно вызывается. Если оно вызывается скриптинговым событием, тогда оно не отменяется. Если оно вызывается командой /nick, оно отменяется. Если это событие отменено и может быть отменено, имя не изменится.

Примеры

Пример 1. В этом примере отменяется событие, если ник уже существует.

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)

9765

Проблемы

Template:GH Issue

Идентификатор проблемы	Описание
#7362	Событие onPlayerChangeNick запускается, когда ник не изменяется

Смотрите также

События игрока

onPlayerNetworkStatus

Функции событий

Серверные функции

getCancelReason - получает причину отмены события
triggerClientEvent - позволяет вызвать срабатывание события, предварительно созданного на клиенте
triggerLatentClientEvent - аналог triggerClientEvent, но скорость передачи может быть ограничена

Клиентские функции

triggerLatentServerEvent - аналог triggerServerEvent, но скорость передачи может быть ограничена
triggerServerEvent - позволяет вызвать срабатывание события, предварительно созданного на сервере

Общие функции

addEvent - позволяет зарегистрировать своё собственное событие
addEventHandler - прикрепляет к событию обработчик
cancelEvent - останавливает автоматическую внутреннюю обработку события
cancelLatentEvent - останавливает автоматическую внутреннюю обработку скрытого события
getEventHandlers - получает прикреплённые функции из события и присоединённый элемент из текущего lua-скрипта
getLatentEventHandles - получает текущие скрытые события в очереди
getLatentEventStatus - получает состояние одного скрытого события в очереди
removeEventHandler - открепляет от события обработчик
triggerEvent - вызывает срабатывание указанного события для указанного элемента в дереве элементов
wasEventCancelled - проверяет, было ли отменено последнее завершённое событие

@@ Line 33: / Line 33: @@
-{{New items|3.0160|1.5.3|
+{{RU/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">
@@ Line 42: / Line 41: @@
      end
 end
-addEventHandler("onPlayerChangeNick", getRootElement(), wasNickChangedByUser) -- add an event handler
+addEventHandler("onPlayerChangeNick", getRootElement(), wasNickChangedByUser)
 </syntaxhighlight>|9765}}