迷你世界脚本变量组接口：ValueGroup

于 2025-03-04 08:38:54 发布
阅读量761 收藏 19
点赞数 26
分类专栏： 笔记 文章标签： 游戏 lua 数据结构
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_15117535/article/details/146004719
版权

变量组接口：ValueGroup
 彼得兔
更新时间: 2023-04-26 10:20:36
（此类接口针对变量库中已创建的变量进行改动、调用）

具体函数名及描述如下:

序号    函数名    函数描述
1    getAllGroupItem(...)    获取组中所有值
2    insertInGroupByName(...)    添加任意值到任意组
3    removeValueIndexByName(...)    从任意组移除指定编号的值
4    removeValueByName(...)    从任意组移除任意值
5    clearGroupByName(...)    清空任意组
6    getGrouplengthByName(...)    获取数组长度
7    getValueNoByName(...)    获取组中索引值
8    setValueNoByName(...)    设置组中索引值
9    getRandomValueByName(...)    获得数组里面的随机值
10    insertValueByName(...)    在任意组插入任意值
11    deleteNoByName(...)    从任意组删除指定编号的值
12    deleteValueByName(...)    从任意组删除指定编号的值
13    clearNoValueByName(...)    从任意组删除指定编号的值
14    addGroupByName(...)    在任意组中添加一组值
15    removeGroupByName(...)    在任意组中将一组值设为空值
16    deleteGroupByName(...)    在任意组中删除一组值
17    insertGroupByName(...)    在任意组插入一组值
18    replaceValueByName(...)    替换任意组中的任意值
19    sortGroupByName(...)    对任意组的值排序
20    hasValueByName(...)    任意组是否有任意值
21    hasNoByName(...)    任意组位置上是否有值
22    getValueCountByName(...)    获取任意组种任意值的数量
23    getGroupNoByValue(...)    获取任意组种任意值的编号
24    getSpcialValueByName(...)    获取最大最小值
getAllGroupItem
参数及类型：

vartype: VARTYPE枚举组类型
libname:string组名
playerid私有组的玩家ID，全局组为0
返回值及类型：

ErrorCode.OK
ret:table所有元素
该方法的主要作用：获取变量组中所有值

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    --获取类型为vartype的变量组中所有变量的值
    local result,ret=Valuegroup:getAllGroupItem(vartype, libname, playerid)
    print(ret)--在日志输出
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
insertInGroupByName
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
value需:要添加的值
playerid:私有组的玩家ID，全局组为0
返回值及类型：

ErrorCode.OK
该方法的主要作用：添加任意值到任意组，加在组的最后一位

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local value=10--值
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    --添加value到vartype类型的变量组的最后一位
    Valuegroup:insertInGroupByName(vartype, libname, value, playerid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
removeValueIndexByName
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
indx:number组中的编号索引
playerid私有组的玩家ID，全局组为0
返回值及类型：

ErrorCode.OK
该方法的主要作用：从任意组移除指定编号的值，变为nil，编号不会移除

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local index=1--序号
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    --删除类型为vartype的变量组中序号为index的值，删除后值为nil
    Valuegroup:removeValueIndexByName(vartype, libname, index, playerid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
removeValueByName
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
value需要删除的值
playerid私有组的玩家ID，全局组为0
返回值及类型：

ErrorCode.OK
该方法的主要作用：从任意组移除任意值为nil

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local value=10--值
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    --删除类型为vartype的变量组中值为value的值，删除后值为nil
    Valuegroup:removeValueByName(vartype, libname, value, playerid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
clearGroupByName
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
playerid私有组的玩家ID，全局组为0
返回值及类型：

ErrorCode.OK
该方法的主要作用：清空任意组，编号和内容全部清空

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    --清空类型为vartype名为libname的变量组
    Valuegroup:clearGroupByName(vartype, libname, playerid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
getGrouplengthByName
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
playerid私有组的玩家ID，全局组为0
返回值及类型：

ErrorCode.OK
number:number数组长度
该方法的主要作用：获取数组长度

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    --获取变量组长度
    local result,length=Valuegroup:getGrouplengthByName(vartype, libname, playerid)
    print(length)--在日志输出
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
getValueNoByName
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
indx:number组中的编号索引
playerid私有组的玩家ID，全局组为0
返回值及类型：

ErrorCode.OK
libvarid:number编号的值
该方法的主要作用：获取组中指定编号的值

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local index=1--序号
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    --获取变量组指定序号的值
    local result,value=Valuegroup:getValueNoByName(vartype, libname, index, playerid)
    print(value)--在日志输出
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
setValueNoByName
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
indx:number组中的编号索引
value设置的值
playerid私有组的玩家ID，全局组为0
返回值及类型：

ErrorCode.OK
该方法的主要作用：设置组中编号索引的值

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local index=1--序号
    local value=10--要设置的值
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    --设置变量组指定序号的值为value
    Valuegroup:setValueNoByName(vartype, libname, index, value, playerid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
getRandomValueByName
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
返回值及类型：

ErrorCode.OK
value获取到的值
该方法的主要作用：随机获得数组里面的值

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    --随机获取变量组中的一个值
    local result,value=Valuegroup:getRandomValueByName(vartype, libname, playerid)
    print(value)--在日志输出
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
insertValueByName
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
no插入的编号位置
value设置的值
playerid私有组的玩家ID，全局组为0
返回值及类型：

ErrorCode.OK
该方法的主要作用：在任意组任意编号位置插入任意值

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local no=1--要插入的位置
    local val=10--要插入的值
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    --在变量组中no的位置插入值val
    Valuegroup:insertValueByName(vartype, libname, no, val, playerid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
deleteNoByName
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
no清空的编号位置
playerid私有组的玩家ID，全局组为0
返回值及类型：

ErrorCode.OK
该方法的主要作用：从任意组清空指定编号的值

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local no=1--要清空的编号位置
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    --清空变量组中编号为no的值
    Valuegroup:deleteNoByName(vartype, libname, no, playerid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
deleteValueByName
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
val清空的值
playerid私有组的玩家ID，全局组为0
返回值及类型：

ErrorCode.OK
该方法的主要作用：从任意组清空指定值

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local val=10--要清空的值
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    --清空变量组中值为val的值
    Valuegroup:deleteValueByName(vartype, libname, val, playerid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
addGroupByName
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
libvarid2:string组名
playerid1:私有组的玩家ID，全局组为0
playerid2:私有组的玩家ID，全局组为0
返回值及类型：

ErrorCode.OK
该方法的主要作用：在组1的末尾添加组2的值

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local libname="数值组02"--组名
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    local playerid2=0--私有变量组所属玩家id，0代表全局变量组
    --在libname组的末尾添加libname2组的值
    Valuegroup:addGroupByName(vartype, libname, libname2, playerid, playerid2)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
removeGroupByName
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
libvarid2:string组名
playerid1:私有组的玩家ID，全局组为0
playerid2:私有组的玩家ID，全局组为0
返回值及类型：

ErrorCode.OK
该方法的主要作用：比较组1和组2，若组1中有与组2种相同的值则设为nil

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local libname2="数值组02"--组名
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    local playerid2=0--私有变量组所属玩家id，0代表全局变量组
    --将libname组中和libname2组中重复的值设为nil
    Valuegroup:removeGroupByName(vartype, libname, libname2, playerid, playerid2)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
deleteGroupByName
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
libvarid2:string组名
playerid1:私有组的玩家ID，全局组为0
playerid2:私有组的玩家ID，全局组为0
返回值及类型：

ErrorCode.OK
该方法的主要作用：比较组1和组2，若组1中有与组2种相同的值则清除

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local libname2="数值组02"--组名
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    local playerid2=0--私有变量组所属玩家id，0代表全局变量组
    --将libname组中和libname2组中重复的值清除
    Valuegroup:deleteGroupByName(vartype, libname, libname2, playerid, playerid2)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
insertGroupByName
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
no:number插入的位置
libvarid2:string组名
playerid1:私有组的玩家ID，全局组为0
playerid2:私有组的玩家ID，全局组为0
返回值及类型：

ErrorCode.OK
该方法的主要作用：在组1指定编号位置插入组2的值

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local no=1--要插入的位置
    local libname2="数值组02"--组名
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    local playerid2=0--私有变量组所属玩家id，0代表全局变量组
    --把libname2组的值插入到libname组编号为no的位置
    Valuegroup:insertGroupByName(vartype, libname, no, libname2, playerid, playerid2)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
replaceValueByName
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
oldval旧值
newval新值
playerid私有组的玩家ID，全局组为0
返回值及类型：

ErrorCode.OK
该方法的主要作用：替换任意组中的任意值为新的值

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local oldval=10--要替换掉的值
    local newval=20--替换为的值
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    --把组中值为oldval的值替换为newval
    Valuegroup:replaceValueByName(vartype, libname, oldval, newval, playerid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
sortGroupByName
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
sortType排序类型排序类型升序：0，降序：1
playerid1私有组的玩家ID，全局组为0
返回值及类型：

ErrorCode.OK
该方法的主要作用：对任意组的值排序

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local sortType=1--排序方式：0升序 1降序
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    --对组中的值排序
    Valuegroup:sortGroupByName(vartype, libname, sortType, playerid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
hasValueByName
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
val查询的值
playerid私有组的玩家ID
返回值及类型：

ErrorCode.OK
该方法的主要作用：任意组是否有任意值，如果有result返回0

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local val=10--要检测的值
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    --检测组中是否包含val
    local result=Valuegroup:hasValueByName(vartype, libname, val, playerid)
    if result==0 then
        Chat:sendSystemMsg("包含")
    else
        Chat:sendSystemMsg("不包含")
    end
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
hasNoByName
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
no:number索引值
playerid私有组的玩家ID
返回值及类型：

ErrorCode.OK
该方法的主要作用：任意组位置上是否有值，有则result返回0

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local no=1--要检测的编号
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    --检测组中no的位置是否有值
    local result=Valuegroup:hasNoByName(vartype, libname, no, playerid)
    if result==0 then
        Chat:sendSystemMsg("有值")
    else
        Chat:sendSystemMsg("没有值")
    end
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
getValueCountByName
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
val查询的值
playerid私有组的玩家ID
返回值及类型：

ErrorCode.OK
libvarid:number值数量
该方法的主要作用：获取任意组种任意值的数量

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local val=10--要计数的值
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    --获取组中值为val的数量
    local result,num=Valuegroup:getValueCountByName(vartype, libname, val, playerid)
    print(num)--在日志输出
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
getGroupNoByValue
参数及类型：

vartype: VARTYPE枚举组类型
libvarid:string组名
val查询的值
playerid私有组的玩家ID
返回值及类型：

ErrorCode.OK
该方法的主要作用：获取任意组种任意值的编号，如果多个相同值，只返回第一个

具体使用案例如下：

local function ClickBlock(event)
    local vartype=17--变量组类型，17是数值组
    local libname="数值组01"--组名
    local val=10--要获取编号的值
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    --获取组中值为val的编号
    local result,no=Valuegroup:getGroupNoByValue(vartype, libname, val, playerid)
    print(result,no)--在日志输出
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块
Lua
getSpcialValueByName
参数及类型：

libvarid:string组名
type取最小值参数为0，最大值参数为1
返回值及类型：

ErrorCode.OK
该方法的主要作用：获取组内最大最小值

具体使用案例如下：

local function ClickBlock(event)
    local libname="数值组01"--组名
    local itype=1--获取类型：0最小值 1最大值
    local playerid=0--私有变量组所属玩家id，0代表全局变量组
    --获取组中最值
    local result,m=Valuegroup:getSpcialValueByName(libname, itype, playerid)
    print(result,m)--在日志输出
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值