CanPlayerUseFunction: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(updated)
m (Changed "DeprecatedWithAlt" template to "Deprecated")
 
(8 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Needs_Checking|Should the function still be string? --[[User:Talidan2|Talidan2]] 15:44, 15 July 2007 (CDT)}}
__NOTOC__  
__NOTOC__  
{{Server function}}
{{Deprecated|hasObjectPermissionTo|}}
This function can be used to check if the player can use a function, based on their current access level. Access levels for functions are stored in the server's config file. Use this if you want to prevent a player using a function unless they are logged in with enough rights.
This function can be used to check if the player can use a function, based on their current access level. Access levels for functions are stored in the server's config file. Use this if you want to prevent a player using a function unless they are logged in with enough rights.
==Syntax==  
==Syntax==  
Line 18: Line 20:
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function adminKillPlayer ( source, commandName, killPlayerName )
function adminKillPlayer ( source, commandName, killPlayerName )
     if ( canPlayerUseFunction ( source, "kill_player" ) ) then --if the player can use the "kill_player" function.
     if ( canPlayerUseFunction ( source, "kill_player" ) ) then     -- if the player can use the "kill_player" function
         playerToKill = getPlayerFromNick ( killPlayerName )
         local playerToKill = getPlayerFromNick ( killPlayerName ) -- look up the player to kill
         if ( playerToKill ~= false ) then --if the player exists from the name
         if ( playerToKill ~= false ) then                         -- check if we found him
             killPlayer ( playerToKill ) --kill him
             killPlayer ( playerToKill )                           -- if so, kill him
             outputConsole ( killPlayerName .. " has been killed!", source )--and notify the admin
             outputConsole ( killPlayerName .. " has been killed!", source )   -- and notify the admin
         else
         else
             outputConsole ( "Couldn't find a player called '" .. killPlayerName .. "'", source ) --otherwise tell him the player was not found
             outputConsole ( "Couldn't find a player called '" .. killPlayerName .. "'", source ) -- otherwise tell him the player was not found
         end
         end
     else
     else
         outputConsole ( "You do not have access to this function!", source ) --if he cant use the function, tell him he has no access
         outputConsole ( "You do not have access to this function!", source ) -- if he isn't allowed to use the function, tell him so
     end
     end
end
end

Latest revision as of 16:21, 13 February 2015

Emblem-important.png This function is deprecated. This means that its use is discouraged and that it might not exist in future versions.

Please use hasObjectPermissionTo instead.


This function can be used to check if the player can use a function, based on their current access level. Access levels for functions are stored in the server's config file. Use this if you want to prevent a player using a function unless they are logged in with enough rights.

Syntax

bool canPlayerUseFunction ( player thePlayer, string functionName )

Required Arguments

  • thePlayer: The player who you consider is running the function.
  • functionName The name of the function which you want to check.

Returns

Returns true if the player specified can use the function specified, false otherwise.

Example

This example adds a console function called kill_player that can only be used by players with enough access rights. These access rights can be specified in the server's config file.

function adminKillPlayer ( source, commandName, killPlayerName )
    if ( canPlayerUseFunction ( source, "kill_player" ) ) then     -- if the player can use the "kill_player" function
        local playerToKill = getPlayerFromNick ( killPlayerName )  -- look up the player to kill
        if ( playerToKill ~= false ) then                          -- check if we found him
            killPlayer ( playerToKill )                            -- if so, kill him
            outputConsole ( killPlayerName .. " has been killed!", source )   -- and notify the admin
        else
            outputConsole ( "Couldn't find a player called '" .. killPlayerName .. "'", source ) -- otherwise tell him the player was not found
        end
    else
        outputConsole ( "You do not have access to this function!", source ) -- if he isn't allowed to use the function, tell him so
    end
end
addCommandHandler ( "kill_player", adminKillPlayer )

See Also