Skip to content

方块模块管理接口 Block

具体函数名及描述如下:

序号函数名函数描述
1GetBlockID(...)获取指定位置的方块类型
2DestroyBlock(...)摧毁方块
3PlaceBlock(...)放置方块
4ReplaceBlock(...)替换方块
5GetBlockData(...)获取方块数据
6GetBlockDir(...)获取方块朝向
7PlayAnim(...)播放方块动作
8SetBlockSettingAttState(...)设置方块设置属性状态
9GetBlockSettingAttState(...)获取方块设置属性状态
10GetBlockSwitchStatus(...)获取功能方块的开关状态
11RandomBlockID(...)在资源库里随机获取一个方块
12GetBlockDefName(...)获取方块名称
13GetBlockDefDesc(...)获取方块描述
14ReplaceBluePrint(...)放置蓝图
15SetBlockColor(...)设置方块颜色
16SetBlockSwichState(...)设置方块开关状态
17SetBlockDir(...)设置方块方向

GetBlockID

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取指定位置的方块类型
  • 具体使用案例如下:
lua
    local blockID = Block:GetBlockID(x, y, z)

DestroyBlock

  • 参数及类型:
  • 返回值及类型:
    • ret:bool是否成功
  • 该方法的主要作用: 摧毁方块
  • 具体使用案例如下:
lua
    -- 删除方块,没有掉落物

    local success = Block:DestroyBlock(x, y, z, false)

PlaceBlock

  • 参数及类型:
    • blockid:number方块类型ID
    • x,y,z:number位置坐标
    • face:number朝向
    • color:number十六进制颜色值(0XFFFFFF 颜色方块类型才生效)
  • 返回值及类型:
    • ret:bool是否成功
  • 该方法的主要作用: 放置方块
  • 具体使用案例如下:
lua
    -- 摆放方块,376 是方块ID,x, y, z 是位置,FaceDir.PosX 是方向,0XFFFFFF 是颜色

    local success2 = Block:PlaceBlock(376, x, y, z, FaceDir.PosX)

     -- 创建颜色方块

     local success = Block:PlaceBlock(605, x + 1, y, z, FaceDir.PosX, 0XFFFFFF)

ReplaceBlock

  • 参数及类型:
    • blockid:number方块类型ID
    • x,y,z:number位置坐标
    • face:number朝向
    • color:number十六进制颜色值(0XFFFFFF 颜色方块类型才生效)
  • 返回值及类型:
    • ret:bool是否成功
  • 该方法的主要作用: 替换方块
  • 具体使用案例如下:
lua
    local success = Block:ReplaceBlock(105, x, y, z)

GetBlockData

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取方块数据
  • 具体使用案例如下:
lua
    local blockData = Block:GetBlockData(x, y, z)

GetBlockDir

  • 参数及类型:
  • 返回值及类型:
    • ret:number返回类型 FaceDir
  • 该方法的主要作用: 获取方块朝向
  • 具体使用案例如下:
lua
    local blockDir = Block:GetBlockDir(x, y, z)

PlayAnim

  • 参数及类型:
  • 返回值及类型:
    • ret:bool是否成功
  • 该方法的主要作用: 播放方块动作
  • 具体使用案例如下:
lua
    local success = Block:PlayAnim({x, y, z}, 100100, 1, AnimMode.Default)

SetBlockSettingAttState

  • 参数及类型:
  • 返回值及类型:
    • ret:bool是否成功
  • 该方法的主要作用: 设置方块设置属性状态
  • 具体使用案例如下:
lua
    -- 设置爆炸抗性打开

    local success = Block:SetBlockSettingAttState(x, y, z, BlockAttr.ExplodeResistance, true)

GetBlockSettingAttState

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取方块设置属性状态
  • 具体使用案例如下:
lua
    local state = Block:GetBlockSettingAttState(x, y, z, BlockAttr.ExplodeResistance)

GetBlockSwitchStatus

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取功能方块的开关状态
  • 具体使用案例如下:
lua
    local status = Block:GetBlockSwitchStatus(x, y, z)

RandomBlockID

  • 参数及类型: 无
  • 返回值及类型:
    • ret:number随机的方块类型
  • 该方法的主要作用: 在资源库里随机获取一个方块
  • 具体使用案例如下:
lua
    local blockID = Block:RandomBlockID()

GetBlockDefName

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取方块名称
  • 具体使用案例如下:
lua
    local blockDefName = Block:GetBlockDefName(x, y, z)

GetBlockDefDesc

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取方块描述
  • 具体使用案例如下:
lua
    local blockDefDesc = Block:GetBlockDefDesc(x, y, z)

ReplaceBluePrint

  • 参数及类型:
  • 返回值及类型:
    • ret:bool是否成功
  • 该方法的主要作用: 放置蓝图
  • 具体使用案例如下:
lua
    local success = Block:ReplaceBluePrint(x, y, z, [=[1,bp6666_1687921429_0_,]=], 90, false, true)

SetBlockColor

  • 参数及类型:
  • 返回值及类型:
    • ret:bool是否成功
  • 该方法的主要作用: 设置方块颜色
  • 具体使用案例如下:
lua
    local success = Block:SetBlockColor(x, y, z, 0XFF0000)

SetBlockSwichState

  • 参数及类型:
  • 返回值及类型:
    • ret:bool是否成功
  • 该方法的主要作用: 设置方块开关状态
  • 具体使用案例如下:
lua
    local success = Block:SetBlockSwichState(x, y, z, true)

SetBlockDir

  • 参数及类型:
  • 返回值及类型:
    • ret:bool是否成功
  • 该方法的主要作用: 设置方块方向
  • 具体使用案例如下:
lua
    local success = Block:SetBlockDir(x, y, z, FaceDir.PosZ)

    -- self:ThreadWait(1)