From Multi Theft Auto: Wiki
Jump to navigation Jump to search

This event is triggered when a player joins the server. This event is not cancellable.


No parameters.


The source of this event is the player who joined.


This example gets the joined client's name and sends him a welcome message including his name.

-- we register greetPlayer as a handler for the event
function greetPlayer ( )
	-- we store the player's name
	local joinedPlayerName = getPlayerName ( source )
	local serverName = getServerName( )
	-- and send him a greeting
	outputChatBox ( "Welcome " .. joinedPlayerName .. " to ".. serverName .."!" , source, 255, 255, 255 )
addEventHandler ( "onPlayerJoin", root, greetPlayer )

This example sets random color to every player who joins.

-- create a table to save the color
ChatColors = {}

-- sets colors when player join
function onJoin ()
        -- create a table to add rgb values. Index will be the player element
	ChatColors[source] = {math.random (50, 255), math.random (50, 255), math.random (50, 255)}
-- checks if player has sent a message
function onChat ( message, messageType )
	if messageType == 0 then
                -- use the table to get the saved rgb values
		outputChatBox ( getPlayerName ( source ) .. ": #E0D0B0" .. message, root, ChatColors[source][1], ChatColors[source][2], ChatColors[source][3], true )
addEventHandler ( "onPlayerJoin", root, onJoin)
addEventHandler ( "onPlayerChat", root, onChat )
Click to collapse [-]
Example 1

This example redirects any player joins to the server automatically to any other server, add the script for admin group.

function Redirect()
redirectPlayer (source, "server ip", "server port")
end    --End function
addEventHandler("onPlayerJoin", root, Redirect)

See Also

Player events

Event functions