GetCommandHandlers: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
Line 6: | Line 6: | ||
==Syntax== | ==Syntax== | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
table getCommandHandlers ( [ resource theResource ] ) | table getCommandHandlers ( [ resource theResource ] ) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==Optional Arguments== | ===Optional Arguments=== | ||
{{OptionalArg}} | |||
*'''theResource:''' The resource from which you wish to retrieve all command handlers. Or leave it empty to retrieve command handlers of all resources. | *'''theResource:''' The resource from which you wish to retrieve all command handlers. Or leave it empty to retrieve command handlers of all resources. | ||
===Returns=== | ===Returns=== | ||
Line 23: | Line 22: | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
addCommandHandler( "commands", | addCommandHandler( "commands", | ||
function(player) | |||
local commandsList = {} --table to store commands | |||
--store/sort commands in the table where key is resource and value is table with commands | |||
for _, subtable in pairs( getCommandHandlers() ) do | |||
local commandName = subtable[1] | |||
local theResource = subtable[2] | |||
if not commandsList[theResource] then | |||
commandsList[theResource] = {} | |||
end | |||
table.insert( commandsList[theResource], commandName ) | |||
end | |||
--output sorted information in the chat | |||
for theResource, commands in pairs( commandsList ) do | |||
local resourceName = getResourceInfo( theResource, "name" ) or getResourceName( theResource ) --try to get full name, if no full name - use short name | |||
outputChatBox( "== "..resourceName.. " ==", player, 0, 255, 0 ) | |||
--output list of commands | |||
for _, command in pairs( commands ) do | |||
outputChatBox( "/"..command, player, 255, 255, 255 ) | |||
end | |||
end | |||
end | |||
) | ) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Line 56: | Line 55: | ||
This example add a command to output list of all commands for the resource in the chat. Syntax: /commands [resource-name] | This example add a command to output list of all commands for the resource in the chat. Syntax: /commands [resource-name] | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
addCommandHandler( "commands", | addCommandHandler("commands", | ||
function( player, _, resourceName) | |||
local theResource = (resourceName and getResourceFromName(resourceName)) or resource | |||
outputChatBox( "* Commands from "..getResourceName(theResource).." resource", player, 0, 255, 0 ) | |||
local commands = getCommandHandlers( theResource ) | |||
for _, command in pairs( commands ) do | |||
outputChatBox( "/"..command, player, 255, 255, 255 ) | |||
end | |||
end | |||
) | ) | ||
</syntaxhighlight> | </syntaxhighlight> |
Revision as of 20:12, 9 October 2016
This function is used to retrieve a list of all the registered command handlers of a given resource (or of all resources).
Syntax
table getCommandHandlers ( [ resource theResource ] )
Optional Arguments
NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.
- theResource: The resource from which you wish to retrieve all command handlers. Or leave it empty to retrieve command handlers of all resources.
Returns
Returns a table containing all the commands of the given resource or a table with subtables containing the command and theResource pointer ( { "command", theResource } ). See examples below if you don't understand it.
Example
Click to collapse [-]
ServerThis example add a command to output list of all commands in the chat.
addCommandHandler( "commands", function(player) local commandsList = {} --table to store commands --store/sort commands in the table where key is resource and value is table with commands for _, subtable in pairs( getCommandHandlers() ) do local commandName = subtable[1] local theResource = subtable[2] if not commandsList[theResource] then commandsList[theResource] = {} end table.insert( commandsList[theResource], commandName ) end --output sorted information in the chat for theResource, commands in pairs( commandsList ) do local resourceName = getResourceInfo( theResource, "name" ) or getResourceName( theResource ) --try to get full name, if no full name - use short name outputChatBox( "== "..resourceName.. " ==", player, 0, 255, 0 ) --output list of commands for _, command in pairs( commands ) do outputChatBox( "/"..command, player, 255, 255, 255 ) end end end )
Click to collapse [-]
ServerThis example add a command to output list of all commands for the resource in the chat. Syntax: /commands [resource-name]
addCommandHandler("commands", function( player, _, resourceName) local theResource = (resourceName and getResourceFromName(resourceName)) or resource outputChatBox( "* Commands from "..getResourceName(theResource).." resource", player, 0, 255, 0 ) local commands = getCommandHandlers( theResource ) for _, command in pairs( commands ) do outputChatBox( "/"..command, player, 255, 255, 255 ) end end )
See Also
- getMaxPlayers
- getServerConfigSetting
- getServerHttpPort
- getServerName
- getServerPassword
- getServerPort
- isGlitchEnabled
- setGlitchEnabled
- setMaxPlayers
- setServerConfigSetting
- setServerPassword
- shutdown