迷你世界脚本之容器接口：WorldContainer

容器接口：WorldContainer

彼得兔

更新时间: 2023-04-26 10:21:02

具体函数名及描述如下:

序号 函数名 函数描述

1 addFurnace(...) 新增熔炉

2 removeFurnace(...) 移除熔炉

3 checkFurnace(...) 检测是否为熔炉

4 getFurnaceHeatPercent(...) 获取熔炉热度百分比

5 getFurnaceMeltPercent(...) 获取熔炉融化百分比

6 addStorageBox(...) 新增储物箱

7 removeStorageBox(...) 移除储物箱

8 checkStorage(...) 检测是否为储物箱

9 clearStorageBox(...) 清空储物箱

10 checkStorageEmptyGrid(...) 检测储物箱空余格子，传入道具ID则同时检测已存该道具的格子

11 setStorageItem(...) 设置储物箱道具

12 getStorageItem(...) 获取储物箱道具ID

13 addStorageItem(...) 给储物箱添加道具

14 removeStorageItemByID(...) 移除储物箱内指定类型的道具

15 removeStorageItemByIndex(...) 移除储物箱内指定格子的道具

16 addItemToContainer(...) 将一定数量道具添加到储物箱中

17 removeContainerItemByID(...) 移除储物箱内一定数量道具

18 clearContainer(...) 清空指定位置的储物箱

addFurnace

参数及类型：

x:number

y:number

z:number

返回值及类型：

ErrorCode.OK

该方法的主要作用：新增熔炉

具体使用案例如下：

--在(0,0)高度7生成熔炉

--参数为要生成熔炉的位置的坐标

WorldContainer:addFurnace(0,7,0)

--在聊天框显示

Chat:sendSystemMsg("在(0,0)高度7的位置生成了一个熔炉！")

Lua

removeFurnace

参数及类型：

x:number

y:number

z:number

返回值及类型：

ErrorCode.OK

该方法的主要作用：移除熔炉

具体使用案例如下：

--移除(0,0)高度7的熔炉(或其他方块)

--参数为要移除的熔炉(或其他方块)的坐标

WorldContainer:removeFurnace(0,7,0)

--在聊天框显示

Chat:sendSystemMsg("(0,0)高度7的位置的熔炉(或其他方块)被移除！")

Lua

checkFurnace

参数及类型：

x:number

y:number

z:number

返回值及类型：

ErrorCode.OK

该方法的主要作用：检测是否为熔炉

具体使用案例如下：

--判断(0,0)高度7的位置是不是熔炉，参数为要判断的位置的坐标

local result=WorldContainer:checkFurnace(0,7,0)

if result==0 then--如果是熔炉

--在聊天框显示

Chat:sendSystemMsg("(0,0)高度7的位置是熔炉")

else--如果不是熔炉

--在聊天框显示

Chat:sendSystemMsg("(0,0)高度7的位置不是熔炉")

end

Lua

getFurnaceHeatPercent

参数及类型：

x:number

y:number

z:number

返回值及类型：

ErrorCode.OK

val:number百分比

该方法的主要作用：获取熔炉热度百分比

具体使用案例如下：

--获取(0,0)高度7的位置的熔炉燃料热量剩余百分比，参数为熔炉坐标

local result,val=WorldContainer:getFurnaceHeatPercent(0,7,0)

if result==0 then--如果获取成功

--在聊天框显示

Chat:sendSystemMsg("(0,0)高度7的位置的熔炉燃料热量剩余百分比为："..val)

else--如果获取失败

--在聊天框显示

Chat:sendSystemMsg("获取失败，可能(0,0)高度7的位置不是熔炉")

end

Lua

getFurnaceMeltPercent

参数及类型：

x:number

y:number

z:number

返回值及类型：

ErrorCode.OK

val:number百分比

该方法的主要作用：获取熔炉融化百分比

具体使用案例如下：

--获取(0,0)高度7的位置的熔炉当前已烧制的百分比，参数为熔炉坐标

local result,val=WorldContainer:getFurnaceMeltPercent(0,7,0)

if result==0 then--如果获取成功

--在聊天框显示

Chat:sendSystemMsg("(0,0)高度7的位置的熔炉当前已烧制的百分比为："..val)

else--如果获取失败

--在聊天框显示

Chat:sendSystemMsg("获取失败，可能(0,0)高度7的位置不是熔炉")

end

Lua

addStorageBox

参数及类型：

x:number

y:number

z:number

返回值及类型：

ErrorCode.OK

该方法的主要作用：新增储物箱

具体使用案例如下：

--在(0,0)高度7的位置生成一个储物箱，参数为要生成储物箱的坐标

WorldContainer:addStorageBox(0,7,0)

--在聊天框显示

Chat:sendSystemMsg("在(0,0)高度7的位置生成了一个储物箱！")

Lua

removeStorageBox

参数及类型：

x:number

y:number

z:number

返回值及类型：

ErrorCode.OK

该方法的主要作用：移除储物箱

具体使用案例如下：

--移除(0,0)高度7的箱子(或其他方块)

--参数为要移除的箱子(或其他方块)的坐标

WorldContainer:removeStorageBox(0,7,0)

--在聊天框显示

Chat:sendSystemMsg("(0,0)高度7的位置的箱子(或其他方块)被移除！")

Lua

checkStorage

参数及类型：

x:number

y:number

z:number

返回值及类型：

ErrorCode.OK

该方法的主要作用：检测是否为

储物箱

具体使用案例如下：

--判断(0,0)高度7的位置是不是箱子，参数为要判断的位置的坐标

local result=WorldContainer:checkStorage(0,7,0)

if result==0 then--如果是箱子

--在聊天框显示

Chat:sendSystemMsg("(0,0)高度7的位置是箱子")

else--如果不是箱子

--在聊天框显示

Chat:sendSystemMsg("(0,0)高度7的位置不是箱子")

end

Lua

clearStorageBox

参数及类型：

x:number

y:number

z:number

返回值及类型：

ErrorCode.OK

该方法的主要作用：清空储物箱

具体使用案例如下：

--清空指定坐标下箱子的物品，参数为要清空的箱子的坐标

WorldContainer:clearStorageBox(0,7,0)

--在聊天框显示

Chat:sendSystemMsg("清空了(0,0)高度7的箱子的物品")

Lua

checkStorageEmptyGrid

参数及类型：

x:number

y:number

z:number

itemid:number

返回值及类型：

ErrorCode.OK

该方法的主要作用：检测储物箱空余格子，传入道具ID则同时检测已存该道具的格子

具体使用案例如下：

--判断(0,0)高度7的位置的储物箱有没有空余格子或指定物品

--前三个参数为要判断的箱子的坐标

--最后一个参数为要判断的物品id，0代表空余格子

local result=checkStorageEmptyGrid(0,7,0,0)

if result==0 then--如果有

--在聊天框显示

Chat:sendSystemMsg("(0,0)高度7的位置的储物箱还有空余格子")

else--如果没有

--在聊天框显示

Chat:sendSystemMsg("(0,0)高度7的位置的储物箱没有空余格子")

end

--判断有没有基岩，id为1

result=checkStorageEmptyGrid(0,7,0,1)

if result==0 then--如果有

--在聊天框显示

Chat:sendSystemMsg("(0,0)高度7的位置的储物箱里有地心基石")

else--如果没有

--在聊天框显示

Chat:sendSystemMsg("(0,0)高度7的位置的储物箱没有地心基石")

end

Lua

setStorageItem

参数及类型：

x:number

y:number

z:number

offset:number仓库格子索引

itemid:number

num:number

返回值及类型：

ErrorCode.OK

该方法的主要作用：设置储物箱道具

具体使用案例如下：

--设置指定位置的箱子的指定格子的物品

--前三个参数为要设置的箱子的坐标

--第四个参数0为指定格子的序号，0为第一个格子

--第五个参数为要放置的物品id，101为土块

--最后一个参数为要放置的物品数量

WorldContainer:setStorageItem(0,7,0,0,101,30)

--在聊天框显示

Chat:sendSystemMsg("(0,0)高度7的位置的箱子第一格，被放置了30个土块")

Lua

getStorageItem

参数及类型：

x,y,z:number储物箱位置

offset:number仓库格子索引

返回值及类型：

ErrorCode.OK

itemid:number道具ID

itemNum:number道具数量

该方法的主要作用：获取储物箱道具ID

具体使用案例如下：

--获取指定坐标下的箱子指定格子的物品id和数量

--前三个参数为箱子坐标

--最后一个参数为格子序号，0为第一格

local result,itemid,itemNum=WorldContainer:getStorageItem(0,7,0,0)

--在聊天框显示

Chat:sendSystemMsg("(0,0)高度7的位置的箱子的第一个格子，有"..itemNum.."个id为"..itemid.."的物品")

Lua

addStorageItem

参数及类型：

x,y,z:number储物箱位置

itemid:number

num:number道具数量

返回值及类型：

ErrorCode.OK

relNum:number成功添加数量

该方法的主要作用：给储物箱添加道具

具体使用案例如下：

--在指定坐标的箱子里添加指定物品

--前三个参数为箱子坐标

--第四个参数为要添加的物品的id，101为土块

--最后一个参数为要添加的数量

local result,relNum=WorldContainer:addStorageItem(0,7,0,101,99)

--在聊天框显示

Chat:sendSystemMsg("尝试在(0,0)高度7位置的箱子里添加99个土块，实际添加了"..relNum.."个")

Lua

removeStorageItemByID

参数及类型：

x,y,z:number储物箱位置

itemid:number道具类型ID

num:number道具数量

返回值及类型：

ErrorCode.OK

该方法的主要作用：移除储物箱内指定类型的道具

具体使用案例如下：

--移除指定坐标下箱子的指定物品

--前三个参数为箱子坐标

--第四个参数为要移除的物品id，101是土块

--最后一个参数为要移除的数量

WorldContainer:removeStorageItemByID(0,7,0,101,10)

--在聊天框显示

Chat:sendSystemMsg("移除了(0,0)高度7位置的箱子里的10个土块")

Lua

removeStorageItemByIndex

参数及类型：

x,y,z:number储物箱位置

offset:number储物箱格子索引，从0开始

num:number道具数量

返回值及类型：

ErrorCode.OK

该方法的主要作用：移除储物箱内指定格子的道具

具体使用案例如下：

--移除指定坐标下箱子的指定格子的物品

--前三个参数为箱子坐标

--第四个参数为要移除的格子序号，0是第一格

--最后一个参数为要移除的数量

WorldContainer:removeStorageItemByIndex(0,7,0,0,5)

--在聊天框显示

Chat:sendSystemMsg("把(0,0)高度7的位置的箱子里第一格的物品移除了5个")

Lua

addItemToContainer

参数及类型：

x,y,z:number储物箱位置

itemid:number

num:number道具数量

返回值及类型：

ErrorCode.OK

relNum:number成功添加数量

该方法的主要作用：将一定数量道具添加到储物箱中

具体使用案例如下：

--在指定坐标的箱子里添加指定物品

--前三个参数为箱子坐标

--第四个参数为要添加的物品的id，101为土块

--最后一个参数为要添加的数量

local result,relNum=WorldContainer:addItemToContainer(0,7,0,101,99)

--在聊天框显示

Chat:sendSystemMsg("尝试在(0,0)高度7位置的箱子里添加99个土块，实际添加了"..relNum.."个")

Lua

removeContainerItemByID

参数及类型：

x,y,z:number储物箱位置

itemid:number道具类型ID

num:number道具数量

返回值及类型：

ErrorCode.OK

该方法的主要作用：移除储物箱内一定数量道具

具体使用案例如下：

--移除指定坐标下箱子的指定物品

--前三个参数为箱子坐标

--第四个参数为要移除的物品id，101是土块

--最后一个参数为要移除的数量

WorldContainer:removeContainerItemByID(0,7,0,101,10)

--在聊天框显示

Chat:sendSystemMsg("移除了(0,0)高度7位置的箱子里的10个土块")

Lua

clearContainer

参数及类型：

x:number

y:number

z:number

返回值及类型：

ErrorCode.OK

该方法的主要作用：清空指定位置的储物箱

具体使用案例如下：

--清空指定坐标下箱子的物品，参数为要清空的箱子的坐标

WorldContainer:clearContainer(0,7,0)

--在聊天框显示

Chat:sendSystemMsg("清空了(0,0)高度7的箱子的物品")