状态模块管理接口 Buff

具体函数名及描述如下:

序号	函数名	函数描述
1	AddBuff(...)	给对象附加效果
2	RemoveBuff(...)	给对象移除指定效果
3	ClearAllBuff(...)	给对象清除所有效果
4	ClearAllBadBuff(...)	为对象清除所有负面效果
5	ClearAllGoodBuff(...)	为对象清除所有有益效果
6	HasBuff(...)	判断对象身上是否有指定效果
7	GetBuffList(...)	获取对象身上效果列表
8	GetBuffNumByBuffid(...)	获取对象身上指定效果数量
9	GetBuffLeftTime(...)	获取对象身上指定效果剩余时间
10	GetBuffDefName(...)	获取状态效果名称
11	GetBuffDefDesc(...)	获取状态效果描述
12	ReplaceBuff(...)	替换已有状态

AddBuff

• 参数及类型：
  • objid:number对象ID
  • buffid:number,string效果ID
  • customticks:number效果持续时间(-1表示默认配置，0表示无限)
• 返回值及类型：
  • ret:bool成功(true)
• 该方法的主要作用： 给对象附加效果
• 具体使用案例如下：

    Buff:AddBuff(playerId,4001, 20)

RemoveBuff

• 参数及类型：
  • objid:number对象ID
  • buffid:number,string效果ID
• 返回值及类型：
  • ret:bool成功(true)
• 该方法的主要作用： 给对象移除指定效果
• 具体使用案例如下：

    local isRemoveSuccess = Buff:RemoveBuff(playerId, "r5_7483041204932402166_23045")

ClearAllBuff

• 参数及类型：
  • objid:number对象ID
• 返回值及类型：
  • ret:bool成功(true)
• 该方法的主要作用： 给对象清除所有效果
• 具体使用案例如下：

    local isSuccess = Buff:ClearAllBuff(playerId)

ClearAllBadBuff

• 参数及类型：
  • objid:number对象ID
• 返回值及类型：
  • ret:bool成功(true)
• 该方法的主要作用： 为对象清除所有负面效果
• 具体使用案例如下：

    local isSuccess = Buff:ClearAllBadBuff(playerId)

ClearAllGoodBuff

• 参数及类型：
  • objid:number对象ID
• 返回值及类型：
  • ret:bool成功(true)
• 该方法的主要作用： 为对象清除所有有益效果
• 具体使用案例如下：

    local isSuccess = Buff:ClearAllGoodBuff(playerId)

HasBuff

• 参数及类型：
  • objid:number对象ID
  • buffid:number,string效果ID
  • bufflv:number效果等级
• 返回值及类型：
  • ret:bool成功(true)
• 该方法的主要作用： 判断对象身上是否有指定效果
• 具体使用案例如下：

    local isHasBuff = Buff:HasBuff(playerId, 4001)

GetBuffList

• 参数及类型：
  • objid:number对象ID
• 返回值及类型：
  • num:number效果数量
  • arr:table效果ID数组
• 该方法的主要作用： 获取对象身上效果列表
• 具体使用案例如下：

    local num,arr = Buff:GetBuffList(playerId)

    print("num = ",num)

    print("arr = ",arr)

GetBuffNumByBuffid

• 参数及类型：
  • objid:number对象ID
  • buffid:number,string效果ID
• 返回值及类型：
  • ret:number数量
• 该方法的主要作用： 获取对象身上指定效果数量
• 具体使用案例如下：

    local num = Buff:GetBuffNumByBuffid(playerId,4001)

    print("num = ",num)

GetBuffLeftTime

• 参数及类型：
  • objid:number对象ID
  • buffid:number,string效果ID
• 返回值及类型：
  • ret:number剩余时间(秒
  • 0表示永久)
• 该方法的主要作用： 获取对象身上指定效果剩余时间
• 具体使用案例如下：

    local time = Buff:GetBuffLeftTime(playerId, 4001)

GetBuffDefName

• 参数及类型：
  • buffid:number,string效果ID
• 返回值及类型：
  • ret:string效果名称
• 该方法的主要作用： 获取状态效果名称
• 具体使用案例如下：

    local name = Buff:GetBuffDefName(4001)

GetBuffDefDesc

• 参数及类型：
  • buffid:number,string效果ID
• 返回值及类型：
  • ret:string状态效果描述
• 该方法的主要作用： 获取状态效果描述
• 具体使用案例如下：

    local desc = Buff:GetBuffDefDesc(4001)

ReplaceBuff

• 参数及类型：
  • objid:number对象ID
  • buffsrc:number,string源状态 ID
  • buffsrclv:number源状态等级
  • buffdst:number,string目标状态
  • buffdstlv:number目标状态等级
  • customticks:number持续时间
• 返回值及类型：
  • ret:boolean替换成功(true)或失败(false)
• 该方法的主要作用： 替换已有状态
• 具体使用案例如下：

    local isSuccess = Buff:ReplaceBuff(playerId, 4001, "r5_7483041204932402166_23045", 10)