GetCommandHandlers

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

This function is used to retrieve a list of all the registered command handlers of a given resource (or of all resources).

Syntax

Click to collapse [-]
Server
table getElementsByType ( [ resource theResource ] ) 

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 } )

Example

Click to collapse [-]
Server

This simple 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
)

See Also