Commands.getBlockInfos - Revision history

Magiczocker at 07:07, 4 August 2020

2020-08-04T07:07:59Z

Dan200: Clarified state

2015-12-26T23:25:28Z

Clarified state

Bomb Bloke: Created page with "{{lowercase}} {{Function |name=commands.getBlockInfos |args={{type|number}} x1, {{type|number}} y1, {{type|number}} z1, {{type|number}} x2, {{type|number}} y2, {{type|number}}..."

2015-12-26T04:10:31Z

Created page with "{{lowercase}} {{Function |name=commands.getBlockInfos |args={{type|number}} x1, {{type|number}} y1, {{type|number}} z1, {{type|number}} x2, {{type|number}} y2, {{type|number}}..."

New page

{{lowercase}}
{{Function
|name=commands.getBlockInfos
|args={{type|number}} x1, {{type|number}} y1, {{type|number}} z1, {{type|number}} x2, {{type|number}} y2, {{type|number}} z2
|returns={{type|table}} blocks info
|api=commands
|addon=ComputerCraft
|desc=Available only to [[Command Computer]]s as of ComputerCraft version 1.76, returns a numerically-indexed table containing information on the blocks within the specified world co-ordinates. Each sub-table is formatted per the output of [[commands.getBlockInfo]]():

{
state = {{type|table}} state information
name = {{type|string}} block's name,
metadata = {{type|number}} block's metadata
}

A maximum of 4096 (2^12) blocks may be inspected at a time (for example, a 16x16x16 cube); the function will error if the block count exceeds this.

The blocks are returned in the order of lowest x-co-ord to highest x-co-ord, then lowest z-co-ord to highest z-co-ord, then lowest y-co-ord to highest y-co-ord; that is to say, west to east, then north to south, then lowest altitude to highest altitude.

See also: [[commands.getBlockInfo]](), [http://minecraft.gamepedia.com/Data_values Data Values @ Minecraft wiki]

|examples=
{{Example
|desc=Reports on a 2x2x2 area, with the Command Computer being at the lowest north-west point.
|code=local x, y, z = commands.getBlockPosition()

local blocks = commands.getBlockInfos(x, y, z, x + 1, y + 1, z + 1)

print("North-west low block:"..blocks[1].name)
print("North-east low block:"..blocks[2].name)
print("South-west low block:"..blocks[3].name)
print("South-east low block:"..blocks[4].name)
print("North-west high block:"..blocks[5].name)
print("North-east high block:"..blocks[6].name)
print("South-west high block:"..blocks[7].name)
print("South-east high block:"..blocks[8].name)
}}
}}

{{CommandsAPIFunctions}}

[[Category:API_Functions]]

@@ Line 18: / Line 18: @@
 The blocks are returned in the order of lowest x-co-ord to highest x-co-ord, then lowest z-co-ord to highest z-co-ord, then lowest y-co-ord to highest y-co-ord; that is to say, west to east, then north to south, then lowest altitude to highest altitude.
-See also: [[commands.getBlockInfo]](), [http://minecraft.gamepedia.com/Block_states Block States @ Minecraft wiki]
+See also: [[commands.getBlockInfo]](), [https://minecraft.gamepedia.com/Block_states Block States @ Minecraft wiki]
 |examples=