Creates a Block with {0,0,0} coordinates. (Block.Position)

Block.PaletteIndex is set to paletteIndex, but Block.Properties remains nil before the block is added to a MutableShape (owns the Palette).

Creates a Block with {x,y,z} coordinates. (Block.Position)

Block.PaletteIndex is set to paletteIndex, but Block.Properties remains nil before the block is added to a MutableShape (owns the Palette).

Creates a Block with position coordinates. (Block.Position)

Block.PaletteIndex is set to paletteIndex, but Block.Properties remains nil before the block is added to a MutableShape (owns the Palette).

Adds a Block, adjacent to the face passed as parameter.

Returns created Block (or nil if it fails).

⚠️ Won't work with read-only Blocks.

-- add block when Action2 is triggered
Client.Action2 = function()
  -- cast a ray, see if it touches a block
  local impact = Player:CastRay()
  if impact.Block ~= nil then
    -- add block, adjacent to the face that's been touched
    impact.Block:AddNeighbor(Block(1), impact.FaceTouched)
  end
end

Removes the Block from its parent MutableShape.

⚠️ Won't work with read-only Blocks.

-- remove block when Action2 is triggered
Client.Action2 = function()
  -- cast a ray, see if it touches a block
  local impact = Player:CastRay()
  -- won't do anything if impact.Block is nil
  impact.Block:Remove()
end

Replaces the Block with the one passed as parameter. The position remains the same, Block.PaletteIndex is the only property being set.

block:Replace(otherBlock) actually has the same effect as block.PaletteIndex = otherBlock.PaletteIndex

⚠️ Won't work with read-only Blocks.

-- replace block when Action2 is triggered
Client.Action2 = function()
  -- cast a ray, see if it touches a block
  local impact = Player:CastRay()
  -- won't do anything if impact.Block is nil
  impact.Block:Replace(Block(1)) -- make it a block with PaletteIndex == 1
end

Block's coordinates in Shape or MutableShape.

local b = someShape:GetBlock(1, 2, 3)
if b ~= nil then
  print(b.Coordinates) -- prints "[Number3 X: 1 Y: 2 Z: 3]"
end

Shortcut to Coordinates.

Position of Block's center in local coordinates (local to parent Shape or MutableShape)

local b = someShape:GetBlock(1, 2, 3)
if b ~= nil then
  print(b.LocalPosition)
end

Block's palette index. (first index is 1)

⚠️ Block.Properties remains nil if the block does not belong to a Shape or MutableShape (instances owning a Palette).

local b = someMutableShape:GetBlock(1, 2, 3)
if b ~= nil then
  -- changes block's properties
  -- using different palette index
  b.PaletteIndex = 10 
end

Shortcut to Position.

Position of Block's center in world coordinates.

local b = someShape:GetBlock(1, 2, 3)
if b ~= nil then
  print(b.Position)
end

Returns Block's BlockProperties.

nil if the Block does not belong to a Shape or MutableShape.