GetPlayerSerial
Jump to navigation
Jump to search
This function returns the serial for a specified player.
Important Note: You should use this function in conjunction with account system (e.g: login & password) - especially for critical things, because serials could be invalid (as in, non-unique or faked). See: Script security. |
Syntax
Click to collapse [-]
Serverstring getPlayerSerial ( player thePlayer )
OOP Syntax Help! I don't understand this!
- Method: player:getSerial(...)
- Variable: .serial
Required Arguments
- thePlayer: A player object referencing the specified player.
Returns
Returns the serial as a string if it was found, false otherwise.
Syntax
Click to collapse [-]
Clientstring getPlayerSerial ( )
OOP Syntax Help! I don't understand this!
- Method: localPlayer:getSerial(...)
Required Arguments
None
Returns
Returns the serial as a string if it was found, false otherwise.
Serverside examples
Click to collapse [-]
ServerThis example creates a command with which player can check their own serial.
function checkMySerial( thePlayer, command ) local theSerial = getPlayerSerial( thePlayer ) if theSerial then outputChatBox( "Your serial is: " .. theSerial, thePlayer ) else outputChatBox( "Sorry, you have no serial. =(", thePlayer ) end end addCommandHandler( "myserial", checkMySerial )
This example adds a command to ban a player's serial.
local function banSerialCommand ( source, command, playerName, reason ) if playerName then local player, serial = getPlayerFromName ( playerName ), getPlayerSerial ( playerName ) if player then addBan ( serial, source, reason ) end end end addCommandHandler ( "banplayerserial", banSerialCommand )
This example only allows clients with a certain serial to log in into an account.
local allowedAccountSerials = { -- List of allowed serials to log in into an account. Format: -- [ Account name ] = { Allowed serial array } [ "3ash8" ] = { "9C9F3B55D9D7BB7135FF274D3BF444E4" }, [ "test5" ] = { "1D6F76CF8D7193792D13789849498452" }, } addEventHandler("onPlayerLogin", root, function(_, account) -- Get the player serial and the allowed serial list for that account -- (If no serial is allowed for the account, do not allow the player to log in as a safety measure) local playerSerial, allowedSerials = getPlayerSerial(source), allowedAccountSerials[getAccountName(account)] or {} -- Check whether the client has an allowed serial or not for i = 1, #allowedSerials do if allowedSerials[i] == playerSerial then -- The serial is allowed. Proceed with the normal log in proccess return end end -- If we reach this point the serial is not allowed. Do not let the player log in cancelEvent(true, "Client serial not allowed to log in into the account") end )
See Also
- forcePlayerMap
- getAlivePlayers
- getDeadPlayers
- getPlayerACInfo
- getPlayerAnnounceValue
- getPlayerBlurLevel
- getPlayerCount
- getPlayerFromName
- getPlayerIdleTime
- getPlayerIP
- getPlayerMoney
- getPlayerName
- getPlayerNametagColor
- getPlayerNametagText
- getPlayerPing
- getPlayerScriptDebugLevel
- getPlayerSerial
- getPlayerTeam
- getPlayerVersion
- getPlayerWantedLevel
- getRandomPlayer
- givePlayerMoney
- isPlayerMapForced
- isPlayerMuted
- isPlayerNametagShowing
- isVoiceEnabled
- redirectPlayer
- resendPlayerACInfo
- resendPlayerModInfo
- setPlayerAnnounceValue
- setPlayerBlurLevel
- setPlayerHudComponentVisible
- setPlayerMoney
- setPlayerMuted
- setPlayerName
- setPlayerNametagColor
- setPlayerNametagShowing
- setPlayerNametagText
- setPlayerScriptDebugLevel
- setPlayerTeam
- setPlayerVoiceBroadcastTo
- setPlayerVoiceIgnoreFrom
- setPlayerWantedLevel
- spawnPlayer
- takePlayerMoney
- takePlayerScreenShot