Appearance
方块模块管理接口 Block
具体函数名及描述如下:
序号 | 函数名 | 函数描述 |
---|---|---|
1 | GetBlockID(...) | 获取指定位置的方块类型 |
2 | DestroyBlock(...) | 摧毁方块 |
3 | PlaceBlock(...) | 放置方块 |
4 | ReplaceBlock(...) | 替换方块 |
5 | GetBlockData(...) | 获取方块数据 |
6 | GetBlockDir(...) | 获取方块朝向 |
7 | PlayAnim(...) | 播放方块动作 |
8 | SetBlockSettingAttState(...) | 设置方块设置属性状态 |
9 | GetBlockSettingAttState(...) | 获取方块设置属性状态 |
10 | GetBlockSwitchStatus(...) | 获取功能方块的开关状态 |
11 | RandomBlockID(...) | 在资源库里随机获取一个方块 |
12 | GetBlockDefName(...) | 获取方块名称 |
13 | GetBlockDefDesc(...) | 获取方块描述 |
14 | ReplaceBluePrint(...) | 放置蓝图 |
15 | SetBlockColor(...) | 设置方块颜色 |
16 | SetBlockSwichState(...) | 设置方块开关状态 |
17 | SetBlockDir(...) | 设置方块方向 |
GetBlockID
lua
local blockID = Block:GetBlockID(x, y, z)
DestroyBlock
lua
-- 删除方块,没有掉落物
local success = Block:DestroyBlock(x, y, z, false)
PlaceBlock
- 参数及类型:
- 返回值及类型:
- ret:
bool
是否成功
- ret:
- 该方法的主要作用: 放置方块
- 具体使用案例如下:
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
- 参数及类型:
- 返回值及类型:
- ret:
bool
是否成功
- ret:
- 该方法的主要作用: 替换方块
- 具体使用案例如下:
lua
local success = Block:ReplaceBlock(105, x, y, z)
GetBlockData
lua
local blockData = Block:GetBlockData(x, y, z)
GetBlockDir
lua
local blockDir = Block:GetBlockDir(x, y, z)
PlayAnim
- 参数及类型:
- 返回值及类型:
- ret:
bool
是否成功
- ret:
- 该方法的主要作用: 播放方块动作
- 具体使用案例如下:
lua
local success = Block:PlayAnim({x, y, z}, 100100, 1, AnimMode.Default)
SetBlockSettingAttState
- 参数及类型:
- 返回值及类型:
- ret:
bool
是否成功
- ret:
- 该方法的主要作用: 设置方块设置属性状态
- 具体使用案例如下:
lua
-- 设置爆炸抗性打开
local success = Block:SetBlockSettingAttState(x, y, z, BlockAttr.ExplodeResistance, true)
GetBlockSettingAttState
- 参数及类型:
- 返回值及类型:
- ret:
boolean
是否开启
- ret:
- 该方法的主要作用: 获取方块设置属性状态
- 具体使用案例如下:
lua
local state = Block:GetBlockSettingAttState(x, y, z, BlockAttr.ExplodeResistance)
GetBlockSwitchStatus
lua
local status = Block:GetBlockSwitchStatus(x, y, z)
RandomBlockID
- 参数及类型: 无
- 返回值及类型:
- ret:
number
随机的方块类型
- ret:
- 该方法的主要作用: 在资源库里随机获取一个方块
- 具体使用案例如下:
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
是否成功
- ret:
- 该方法的主要作用: 放置蓝图
- 具体使用案例如下:
lua
local success = Block:ReplaceBluePrint(x, y, z, [=[1,bp6666_1687921429_0_,]=], 90, false, true)
SetBlockColor
lua
local success = Block:SetBlockColor(x, y, z, 0XFF0000)
SetBlockSwichState
lua
local success = Block:SetBlockSwichState(x, y, z, true)
SetBlockDir
lua
local success = Block:SetBlockDir(x, y, z, FaceDir.PosZ)
-- self:ThreadWait(1)