Difference between revisions of "Command Block (API)"
From ComputerCraft Wiki
MKlegoman357 (Talk | contribs) m (Recreated the table using {{API table}} tag) |
MKlegoman357 (Talk | contribs) (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| | + | |{{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:
 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()
