Difference between revisions of "Command Block (API)"

From ComputerCraft Wiki
Jump to: navigation, search
m (Recreated the table using {{API table}} tag)
(Fixed return parameters)
 
(3 intermediate revisions by 2 users not shown)
Line 2: Line 2:
  
 
The Command Block API allows you to run commands in a Command Block, using it as a [[peripheral]].
 
The Command Block API allows you to run commands in a Command Block, using it as a [[peripheral]].
(The peripheral can only be used if allowed in the [[ComputerCraft.cfg|config]], which disables it by default.)
+
(The peripheral can only be used if allowed in the [[ComputerCraft.cfg|config]], which disables it by default.) Under CC 1.7 or later, it may be easier to use a [[Command Computer]].
  
 
==API==
 
==API==
Line 9: Line 9:
  
 
{{API table/row
 
{{API table/row
|[[commandBlock.getCommand]]()
+
|[[commandBlock.getCommand|''commandBlock''.getCommand]]()
 
|{{type|string}} command
 
|{{type|string}} command
 
|Returns a string containing the command currently inside the Command Block.
 
|Returns a string containing the command currently inside the Command Block.
Line 15: Line 15:
  
 
{{API table/row
 
{{API table/row
|[[commandBlock.setCommand]]({{type|string}} command)
+
|[[commandBlock.setCommand|''commandBlock''.setCommand]]({{type|string}} command)
 
|{{type|nil}}
 
|{{type|nil}}
 
|Sets the command in the Command Block to ''command''. '''This does not run it.'''}}
 
|Sets the command in the Command Block to ''command''. '''This does not run it.'''}}
  
 
{{API table/row
 
{{API table/row
|[[commandBlock.runCommand]]()
+
|[[commandBlock.runCommand|''commandBlock''.runCommand]]()
|{{type|nil}}
+
|{{type|boolean}} success [<nowiki/>, {{type|string}} error]
|Runs the command inside the Command Block previously set by manually editing it or by using [[commandBlock.setCommand]]().
+
|Runs the command inside the Command Block previously set by manually editing it or by using [[commandBlock.setCommand|''commandBlock''.setCommand]]().
 
|odd}}
 
|odd}}
 
}}
 
}}

Latest revision as of 19:25, 16 February 2015

This API requires the use of a wrapped peripheral!
This API does not behave like a regular API, to use it you must first wrap the peripheral and call the methods on the wrapped object. For more information see this page.

The Command Block API allows you to run commands in a Command Block, using it as a peripheral. (The peripheral can only be used if allowed in the config, which disables it by default.) Under CC 1.7 or later, it may be easier to use a Command Computer.

API

Functions exposed by the Command Block, where "commandBlock" is a wrapped Command Block:

Grid disk.png  Command Block (API)
Function Return values Description
commandBlock.getCommand() string command Returns a string containing the command currently inside the Command Block.
commandBlock.setCommand(string command) nil Sets the command in the Command Block to command. This does not run it.
commandBlock.runCommand() boolean success [, string error] Runs the command inside the Command Block previously set by manually editing it or by using commandBlock.setCommand().

Usage

All Command Block functions are to be used after wrapping the block as a peripheral. Example:

local commandBlock = peripheral.wrap("left")

commandBlock.setCommand("time set 1000")
commandBlock.runCommand()

local currentCommand = commandBlock.getCommand()