迷你世界脚本状态接口：Buff

状态接口：Buff
 迷你世界
更新时间: 2023-04-26 20:07:54
具体函数名及描述如下:

序号    函数名    函数描述
1    addBuff(...)    给对象附加效果
2    removeBuff(...)    给对象移除指定效果
3    clearAllBuff(...)    给对象清除所有效果
4    clearAllBadBuff(...)    为对象清除所有负面效果
5    hasBuff(...)    判断对象身上是否有指定效果
6    getBuffList(...)    获取对象身上效果列表
7    getBuffNumByBuffid(...)    获取对象身上指定效果数量
8    getBuffIndex(...)
获取对象身上指定效果的索引位置(索引从1开始)
9    getBuffLeftTime(...)
获取对象身上指定效果剩余时间
10    getBuffName(...)
获取对象身上状态效果名称
11    GetBuffDefName(...)
获取状态效果名称
12    GetBuffDefDesc(...)
获取状态效果描述
 

addBuff

参数及类型：
objid:number对象ID
buffid:number效果ID
bufflv:number效果等级
customticks:number效果持续时间(-1表示默认配置，0表示无限)
返回值及类型：
code:number成功(ErrorCode.OK)ErrorCode
该方法的主要作用： 给对象附加效果
具体使用案例如下：
local code  = Buff:addBuff(objid, buffid, bufflv, customticks)
if code == ErrorCode.OK then
    print('执行成功'  )
else
    print('执行失败')
end
Lua
 

removeBuff

参数及类型：
objid:number对象ID
buffid:number效果ID
返回值及类型：
code:number成功(ErrorCode.OK)ErrorCode
该方法的主要作用： 给对象移除指定效果
具体使用案例如下：
local code  = Buff:removeBuff(objid, buffid)
if code == ErrorCode.OK then
    print('执行成功'  )
else
    print('执行失败')
end
Lua
 

clearAllBuff

参数及类型：
objid:number对象ID
返回值及类型：
code:number成功(ErrorCode.OK)ErrorCode
该方法的主要作用： 给对象清除所有效果
具体使用案例如下：
local code  = Buff:clearAllBuff(objid)
if code == ErrorCode.OK then
    print('执行成功'  )
else
    print('执行失败')
end
Lua
 

clearAllBadBuff

参数及类型：
objid:number对象ID
返回值及类型：
code:number成功(ErrorCode.OK)ErrorCode
该方法的主要作用： 为对象清除所有负面效果
具体使用案例如下：
local code  = Buff:clearAllBadBuff(objid)
if code == ErrorCode.OK then
    print('执行成功'  )
else
    print('执行失败')
end
Lua
 

hasBuff

参数及类型：
objid:number对象ID
buffid:number效果ID
bufflv:number效果等级
返回值及类型：
code:number成功(ErrorCode.OK)ErrorCode
该方法的主要作用： 判断对象身上是否有指定效果
具体使用案例如下：
local code  = Buff:hasBuff(objid, buffid, bufflv)
if code == ErrorCode.OK then
    print('执行成功'  )
else
    print('执行失败')
end
Lua
 

getBuffList

参数及类型：
objid:number对象ID
返回值及类型：
code:number成功(ErrorCode.OK)ErrorCode
num:number效果数量
arr:number效果ID数组
该方法的主要作用： 获取对象身上效果列表
具体使用案例如下：
local code ,num,arr = Buff:getBuffList(objid)
if code == ErrorCode.OK then
    print('执行成功' ,num,arr )
else
    print('执行失败')
end
Lua
 

getBuffNumByBuffid

参数及类型：
objid:number对象ID
buffid:number效果ID
返回值及类型：
code:number成功(ErrorCode.OK)ErrorCode
num:number数量
该方法的主要作用： 获取对象身上指定效果数量
具体使用案例如下：
local code ,num = Buff:getBuffNumByBuffid(objid, buffid)
if code == ErrorCode.OK then
    print('执行成功' ,num )
else
    print('执行失败')
end
Lua
 

getBuffIndex

参数及类型：
objid:number对象ID
buffid:number效果ID
返回值及类型：
code:number成功(ErrorCode.OK)ErrorCode
ix:number效果索引 从1开始
该方法的主要作用： 获取对象身上指定效果的索引位置(索引从1开始)
具体使用案例如下：
local code ,ix = Buff:getBuffIndex(objid, buffid)
if code == ErrorCode.OK then
    print('执行成功' ,ix )
else
    print('执行失败')
end
Lua
 

getBuffLeftTime

参数及类型：
objid:number对象ID
buffid:number效果ID
返回值及类型：
code:number成功(ErrorCode.OK)ErrorCode
num:number剩余时间(秒)，0表示永久
该方法的主要作用： 获取对象身上指定效果剩余时间
具体使用案例如下：
local code ,num = Buff:getBuffLeftTime(objid, buffid)
if code == ErrorCode.OK then
    print('执行成功' ,num )
else
    print('执行失败')
end
Lua
 

getBuffName

参数及类型：
objid:number对象ID
buffid:number效果ID
返回值及类型：
code:number成功(ErrorCode.OK)ErrorCode
name:string效果名称
该方法的主要作用： 获取对象身上状态效果名称
具体使用案例如下：
local code ,name = Buff:getBuffName(objid, buffid)
if code == ErrorCode.OK then
    print('执行成功' ,name )
else
    print('执行失败')
end
Lua
 

GetBuffDefName

参数及类型：
buffid:number效果ID
返回值及类型：
code:number成功(ErrorCode.OK)ErrorCode
name:string效果名称
该方法的主要作用： 获取状态效果名称
具体使用案例如下：
local code ,name = Buff:GetBuffDefName(buffid)
if code == ErrorCode.OK then
    print('执行成功' ,name )
else
    print('执行失败')
end
Lua
 

GetBuffDefDesc

参数及类型：
buffid:number效果ID
返回值及类型：
code:number成功(ErrorCode.OK)ErrorCode
desc:string效果名称
该方法的主要作用： 获取状态效果描述
具体使用案例如下：
local code ,desc = Buff:GetBuffDefDesc(buffid)
if code == ErrorCode.OK then
    print('执行成功' ,desc )
else
    print('执行失败')
end
Lua