OnPlayerConnect: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Example #3 is a duplicate of #1. Example #4 = useless)
Line 22: Line 22:


==Example==  
==Example==  
<section name="Server" class="server" show="true">
<!-- Explain what the example is in a single sentance -->
<!-- Explain what the example is in a single sentance -->
This example cancels connection attempts of people who use the nick "Player" or outputs some data about the connecting player otherwise.
This example cancels connection attempts of people who use the nick "Player" or outputs some data about the connecting player otherwise.
Line 41: Line 40:
addEventHandler ("onPlayerConnect", getRootElement(), playerConnect)
addEventHandler ("onPlayerConnect", getRootElement(), playerConnect)
</syntaxhighlight>
</syntaxhighlight>
</section>


<section name="Server" class="server" show="true">
This example cancels connection if player uses older MTA (older than 1.0.3)
This example cancels connection if player uses older MTA (older than 1.0.3)
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 53: Line 49:
         end
         end
     end
     end
)
</syntaxhighlight>
</section>
<section name="Server" class="server" show="true">
This example show the player in the Chatbox if connect the Server
<syntaxhighlight lang="lua">
function playerConnect(playerNick, playerIP, playerUsername, playerSerial, playerVersionNumber)
    outputChatBox("* " .. playerNick .. " has connected the Server.", getRootElement(), 255, 100, 100, false)
    -- Show the Player Connect the Server, for all Users good
end
addEventHandler("onPlayerConnect", getRootElement(), playerConnect)
</syntaxhighlight>
</section>
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
addEventHandler ( 'onPlayerConnect', getRootElement ( ),
function ( playerNick )
if ( string.len ( playerNick ) <= 3 ) then
cancelEvent ( true, 'Nickname short' )
end
end
)
)
</syntaxhighlight>
</syntaxhighlight>


</section>
{{See also/Server event|Player events}}
{{See also/Server event|Player events}}

Revision as of 11:27, 7 January 2013

This event is triggered when a player attempts to connect to the server.

Parameters

string playerNick, string playerIP, string playerUsername, string playerSerial, int playerVersionNumber, string playerVersionString
  • playerNick: The player's current nickname.
  • playerIP: The player's current IP.
  • playerUsername: The player's community username.
  • playerSerial: The player's serial number.
  • playerVersionNumber: The player's MTA version in pure numerical form, e.g. '256' for 1.0, '257' for 1.0.1, etc.
  • playerVersionString: The player's MTA version in sortable string form. Same as the return value from getPlayerVersion.

Source

The source of this event is the client's root element.

Cancel effect

If this event is canceled, the player will be disconnected with an error message saying the reason specified in cancelEvent or "Disconnected: server refused the connection" if none was specified.

Example

This example cancels connection attempts of people who use the nick "Player" or outputs some data about the connecting player otherwise.

--when a player connects
function playerConnect (playerNick, playerIP, playerUsername, playerSerial, playerVersionNumber)
    if playerNick == "Player" then --check if his nick is "Player"
        cancelEvent(true,"The nick \"Player\" is not allowed, please change it to something else. You can change your nick in Settings menu Multiplayer tab.") --in that case refuse the connection
    else
        --output some data about the player
        outputChatBox (playerNick.." just connected to the server.")
        outputChatBox ("IP: "..playerIP.." Username: "..playerUsername.." Serial: "..playerSerial)
    end
end

--add the playerConnect function as a handler for onPlayerConnect
addEventHandler ("onPlayerConnect", getRootElement(), playerConnect)

This example cancels connection if player uses older MTA (older than 1.0.3)

addEventHandler( "onPlayerConnect", getRootElement(),
    function ( _,_,_,_, clientVersion )
        if ( clientVersion < 259 ) then
            cancelEvent( true, "Update your MTA before you join this server!" );
        end
    end
)

See Also

Player events


Event functions