迷你世界脚本之容器接口：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的箱子的物品")