OnPlayerChangeNick: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Removed old issues)
 
(10 intermediate revisions by 6 users not shown)
Line 7: Line 7:
string oldNick, string newNick, bool changedByUser
string oldNick, string newNick, bool changedByUser
</syntaxhighlight>
</syntaxhighlight>
*'''oldNick:''' the nickname the player had before.
*'''oldNick:''' the nickname the [[player]] had before.
*'''newNick:''' the new nickname of the player.
*'''newNick:''' the new nickname of the player.
{{New items|3.0160|1.5.3|
{{New items|3.0154|1.5.3|
*'''changedByUser:''' whether the name was changed using [[setPlayerName]] or by the user
*'''changedByUser:''' a [[boolean]] representing whether the name was changed using [[setPlayerName]] or by the user.
|9765}}
|9765}}


==Source==
==Source==
The source of this event is the player that changed his nick
The [[event system#Event source|source]] of this event is the player that changed his nick


==Cancel effect==
==Cancel effect==
Line 32: Line 32:
end
end
-- add an event handler
-- add an event handler
addEventHandler("onPlayerChangeNick", getRootElement(), nickChangeHandler)
addEventHandler("onPlayerChangeNick", root, nickChangeHandler)
</syntaxhighlight></section>
</syntaxhighlight></section>
{{New items|3.0160|1.5.3|
 
{{New items|3.0154|1.5.3|
<section name="Server Example 2" class="server" show="true">
<section name="Server Example 2" class="server" show="true">
This function checks if the nickname of a player was changed by a script, if so, a message is shown in the server logs.
This function checks if the nickname of a player was changed by a script, if so, a message is shown in the server logs.
Line 43: Line 44:
end
end
end
end
addEventHandler("onPlayerChangeNick", getRootElement(), wasNickChangedByUser) -- add an event handler
addEventHandler("onPlayerChangeNick", root, wasNickChangedByUser) -- add an event handler
</syntaxhighlight></section>|9765}}
</syntaxhighlight></section>|9765}}


==Issues==
{{See also/Server event|Player events}}
{{Issues|
{{Issue|7362|onPlayerChangeNick triggered when nick doesn't changed}}
{{GH_Issue|52|Add 'manuallyChanged' parameter to onPlayerChangeNick}}
}}


{{See also/Server event|Player events}}
[[ru:onPlayerChangeNick]]

Latest revision as of 10:40, 30 January 2022

This event is triggered when a player changes his nickname.

Parameters

string oldNick, string newNick, bool changedByUser
  • oldNick: the nickname the player had before.
  • newNick: the new nickname of the player.
  • changedByUser: a boolean representing whether the name was changed using setPlayerName or by the user.

Source

The source of this event is the player that changed his nick

Cancel effect

Cancelling this event depends on how it is called, if it is called by the scripting event then it is NOT cancelable. If it is called from the /nick command it IS cancelable. If this event is cancelled and can be cancelled then the name will not change.

Example

Click to collapse [-]
Server Example 1
function nickChangeHandler(oldNick, newNick)
    -- check if there's account with newNick as username
    if getAccount(newNick) then
        outputChatBox("Sorry, there already exists an account with your new nickname as username.", source, 0, 255, 0)
        outputChatBox("Please choose another one.", source, 0, 255, 0)
        -- cancel the event to prevent the nick from being changed
        cancelEvent()
    end
end
-- add an event handler
addEventHandler("onPlayerChangeNick", root, nickChangeHandler)
Click to collapse [-]
Server Example 2

This function checks if the nickname of a player was changed by a script, if so, a message is shown in the server logs.

function wasNickChangedByUser(oldNick, newNick, changedByUser)
	if (changedByUser == false) then -- check if the nickname was not changed by the user
		outputServerLog("Player "..oldNick.."'s name was changed to "..newNick.." by a script") -- output to the server's logs
	end	
end
addEventHandler("onPlayerChangeNick", root, wasNickChangedByUser) -- add an event handler

See Also

Player events


Event functions