Difference between revisions of "Command Block (API)"
From ComputerCraft Wiki
MKlegoman357 (Talk | contribs) (Fixed grammar (hopefully) and improved example) |
MKlegoman357 (Talk | contribs) (Fixed return parameters) |
||
| (5 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{PeripheralAPI}} | {{PeripheralAPI}} | ||
| − | 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 config, which | + | (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]]. |
| − | Functions exposed by the Command Block, where commandBlock is a wrapped Command Block: | + | ==API== |
| + | Functions exposed by the Command Block, where "commandBlock" is a [[peripheral.wrap|wrapped]] Command Block: | ||
| + | {{API table|Command Block|image=Grid disk.png|2= | ||
| − | + | {{API table/row | |
| − | + | |[[commandBlock.getCommand|''commandBlock''.getCommand]]() | |
| − | [[ | + | |{{type|string}} command |
| − | Command Block | + | |Returns a string containing the command currently inside the Command Block. |
| − | + | |odd}} | |
| − | + | {{API table/row | |
| + | |[[commandBlock.setCommand|''commandBlock''.setCommand]]({{type|string}} command) | ||
| + | |{{type|nil}} | ||
| + | |Sets the command in the Command Block to ''command''. '''This does not run it.'''}} | ||
| − | + | {{API table/row | |
| − | < | + | |[[commandBlock.runCommand|''commandBlock''.runCommand]]() |
| − | + | |{{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|''commandBlock''.setCommand]](). | |
| − | + | |odd}} | |
| − | + | }} | |
| − | + | ||
| − | + | ||
| − | + | ||
==Usage== | ==Usage== | ||
| − | All Command Block functions are to be used ''after'' wrapping the block as a peripheral. | + | All Command Block functions are to be used ''after'' [[peripheral.wrap|wrapping]] the block as a peripheral. |
'''Example''': | '''Example''': | ||
<span> | <span> | ||
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()
