RU/onPlayerChangeNick: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
(Removed fixed issues)
 
(2 intermediate revisions by one other user not shown)
Line 9: Line 9:
*'''oldNick'''. Ник, который игрок имел раньше.
*'''oldNick'''. Ник, который игрок имел раньше.
*'''newNick'''. Новый ник игрока.
*'''newNick'''. Новый ник игрока.
{{RU/New items|3.0160|1.5.3|
{{RU/New items|3.0154|1.5.3|
*'''changedByUser'''. Было ли имя изменено с помощью функции [[RU/setPlayerName|setPlayerName]] или пользователем.
*'''changedByUser'''. Было ли имя изменено с помощью функции [[RU/setPlayerName|setPlayerName]] или пользователем.
|9765}}
|9765}}
Line 32: Line 32:
</syntaxhighlight>
</syntaxhighlight>


 
{{RU/New items|3.0154|1.5.3|
{{RU/New items|3.0160|1.5.3|
'''Пример 2'''. В этом примере проверяется, был ли ник игрока изменён скриптом и, если это так, логируется.
'''Пример 2'''. В этом примере проверяется, был ли ник игрока изменён скриптом и, если это так, логируется.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 43: Line 42:
addEventHandler("onPlayerChangeNick", getRootElement(), wasNickChangedByUser)
addEventHandler("onPlayerChangeNick", getRootElement(), wasNickChangedByUser)
</syntaxhighlight>|9765}}
</syntaxhighlight>|9765}}
==Проблемы==
{{RU/Issues|
{{Issue|7362|Событие onPlayerChangeNick запускается, когда ник не изменяется}}
{{GH_Issue|52|Добавьте параметр ''manuallyChanged'' в событие onPlayerChangeNick}}
}}


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


[[en:onPlayerChangeNick]]
[[en:onPlayerChangeNick]]

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


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

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

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

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

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

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

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

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

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