RU/onPlayerChangeNick: Difference between revisions

Latest revision as of 19:04, 30 January 2022

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

Параметры

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

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

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

onPlayerNetworkStatus

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

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

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

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

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

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

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

@@ Line 9: / Line 9: @@
 *'''oldNick'''. Ник, который игрок имел раньше.
 *'''newNick'''. Новый ник игрока.
-{{RU/New items|3.0160|1.5.3|
+{{RU/New items|3.0154|1.5.3|
 *'''changedByUser'''. Было ли имя изменено с помощью функции [[RU/setPlayerName|setPlayerName]] или пользователем.
 |9765}}
@@ Line 32: / Line 32: @@
 </syntaxhighlight>
+{{RU/New items|3.0154|1.5.3|
-{{RU/New items|3.0160|1.5.3|
 '''Пример 2'''. В этом примере проверяется, был ли ник игрока изменён скриптом и, если это так, логируется.
 <syntaxhighlight lang="lua">
@@ Line 43: / Line 42: @@
 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]]