Skill

技能系统

 角色技能相关操作

---

函数列表

ClearSkillCD

• 描述: 重置技能冷却CD为0

• 范围: 服务端

参数列表:

参数	类型	说明
PlayerId	number	玩家角色id
SkillId	number	要重置冷却CD的技能id，技能id-新增技能时的技能序号：1,2,3…

local playerIds = Character:GetAllPlayerIds()
local skillId = 1
for _, playerId in ipairs(playerIds) do
    Skill:ClearSkillCD(playerId, skillId)
end

---

SwitchSkill

• 描述: 切换技能

• 范围: 客户端

参数列表:

参数	类型	说明
SkillIdList	number[]	要切换的技能id数组，技能id-新增技能时的技能序号：1,2,3…
CanReplaceOldSkill	boolean	是否替换旧技能

local skillIdList = {1}
Skill:SwitchSkill(skillIdList, true)

---

OpenRechargedAbilityUI

• 描述: 通知玩家打开充能大招选中界面

• 范围: 服务端

• 警告: 需要在【地图设置】-【玩法设置】中开启充能大招

• 警告: 游戏初始化时使用无效，需在游戏开始后使用才生效

参数列表:

参数	类型	说明
PlayerId	number	玩家角色id
Time	number	充能大招选中界面倒计时长，单位秒

local playerIds = Character:GetAllPlayerIds()
for _, playerId in ipairs(playerIds) do
    Skill:OpenRechargedAbilityUI(playerId, 3)
end

---

SetRechargedAbility

• 描述: 设置玩家当前充能大招

• 范围: 服务端

• 警告: 需要在【地图设置】-【玩法设置】中开启充能大招

• 警告: 游戏初始化时使用无效，需在游戏开始后使用才生效

参数列表:

参数	类型	说明
PlayerId	number	玩家角色id
AbilityId	number	充能大招

local playerIds = Character:GetAllPlayerIds()
for _, playerId in ipairs(playerIds) do
    Skill:SetRechargedAbility(playerId, 91002)
end

---

GetRechargedAbility

• 描述: 获取玩家当前充能大招

• 范围: 服务端、客户端

• 警告: 需要在【地图设置】-【玩法设置】中开启充能大招

• 警告: 游戏初始化时使用无效，需在游戏开始后使用才生效

参数列表:

参数	类型	说明
PlayerId	number	玩家角色id

返回字段:

返回字段	字段类型	说明
abilityId	number	充能大招id

local localPlayerId = Character:GetLocalPlayerId()
local abilityId = Skill:GetRechargedAbility(localPlayerId)

---

SetRechargedAbilityEnergy

• 描述: 设置玩家当前充能大招充能点数

• 范围: 服务端

• 警告: 需要在【地图设置】-【玩法设置】中开启充能大招

• 警告: 游戏初始化时使用无效，需在游戏开始后使用才生效

参数列表:

参数	类型	说明
PlayerId	number	玩家角色id
Energy	number	充能点数

local playerIds = Character:GetAllPlayerIds()
for _, playerId in ipairs(playerIds) do
    Skill:SetRechargedAbilityEnergy(playerId, 10)
end

---

GetRechargedAbilityEnergy

• 描述: 获取玩家当前充能大招充能点数

• 范围: 服务端、客户端

• 警告: 需要在【地图设置】-【玩法设置】中开启充能大招

• 警告: 游戏初始化时使用无效，需在游戏开始后使用才生效

参数列表:

参数	类型	说明
PlayerId	number	玩家角色id

返回字段:

返回字段	字段类型	说明
energy	number	充能点数

local localPlayerId = Character:GetLocalPlayerId()
local energy = Skill:GetRechargedAbilityEnergy(localPlayerId)

---

SetRechargedAbilityCostEnergy

• 描述: 设置玩家当前充能大招所需充能点数

• 范围: 服务端

• 警告: 需要在【地图设置】-【玩法设置】中开启充能大招

• 警告: 游戏初始化时使用无效，需在游戏开始后使用才生效

参数列表:

参数	类型	说明
PlayerId	number	玩家角色id
CostEnergy	number	所需充能点数

local playerIds = Character:GetAllPlayerIds()
for _, playerId in ipairs(playerIds) do
    Skill:SetRechargedAbilityCostEnergy(playerId, 1000)
end

---

GetRechargedAbilityCostEnergy

• 描述: 获取玩家当前充能大招所需充能点数

• 范围: 服务端、客户端

• 警告: 需要在【地图设置】-【玩法设置】中开启充能大招

• 警告: 游戏初始化时使用无效，需在游戏开始后使用才生效

参数列表:

参数	类型	说明
PlayerId	number	玩家角色id

返回字段:

返回字段	字段类型	说明
costEnergy	number	所需充能点数

local localPlayerId = Character:GetLocalPlayerId()
local costEnergy = Skill:GetRechargedAbilityCostEnergy(localPlayerId)

---

SetRechargedAbilityAddPreEnergy

• 描述: 设置玩家当前充能大招每秒增加多少充能点数

• 范围: 服务端

• 警告: 需要在【地图设置】-【玩法设置】中开启充能大招

• 警告: 游戏初始化时使用无效，需在游戏开始后使用才生效

参数列表:

参数	类型	说明
PlayerId	number	玩家角色id
PreEnergy	number	每秒增加的充能点数

local playerIds = Character:GetAllPlayerIds()
for _, playerId in ipairs(playerIds) do
    Skill:SetRechargedAbilityAddPreEnergy(playerId, 10)
end

---

GetRechargedAbilityAddPreEnergy

• 描述: 获取玩家当前充能大招每秒增加多少充能点数

• 范围: 服务端、客户端

• 警告: 需要在【地图设置】-【玩法设置】中开启充能大招

• 警告: 游戏初始化时使用无效，需在游戏开始后使用才生效

参数列表:

参数	类型	说明
PlayerId	number	玩家角色id

返回字段:

返回字段	字段类型	说明
preEnergy	number	每秒增加的充能点数

local localPlayerId = Character:GetLocalPlayerId()
local preEnergy = Skill:GetRechargedAbilityAddPreEnergy(localPlayerId)

---

SetRechargedAbilityEnabled

• 描述: 设置玩家充能大招能否使用

• 范围: 服务端

• 警告: 需要在【地图设置】-【玩法设置】中开启充能大招

• 警告: 游戏初始化时使用无效，需在游戏开始后使用才生效

参数列表:

参数	类型	说明
PlayerId	number	玩家角色id
Enable	boolean	能否使用充能大招

local playerIds = Character:GetAllPlayerIds()
for _, playerId in ipairs(playerIds) do
    Skill:SetRechargedAbilityEnabled(playerId, false)
end

---

UseRechargedAbility

• 描述: 玩家朝某方向释放充能大招

• 范围: 服务端、客户端

• 警告: 需要在【地图设置】-【玩法设置】中开启充能大招

• 警告: 游戏初始化时使用无效，需在游戏开始后使用才生效

参数列表:

参数	类型	说明
PlayerId	number	玩家角色id
Dir	Engine.Vector	释放朝向，默认为角色前方

返回字段:

返回字段	字段类型	说明
bUsed	boolean	是否成功释放充能大招
failedReason	string	释放充能大招失败说明，可用于给玩家提示

local localPlayerId = Character:GetLocalPlayerId()
Skill:UseRechargedAbility(localPlayerId)

---

ClearRechargedAbility

• 描述: 清除玩家充能大招

• 范围: 服务端

• 警告: 需要在【地图设置】-【玩法设置】中开启充能大招

• 警告: 游戏初始化时使用无效，需在游戏开始后使用才生效

参数列表:

参数	类型	说明
PlayerId	number	玩家角色id

local playerIds = Character:GetAllPlayerIds()
for _, playerId in ipairs(playerIds) do
    Skill:ClearRechargedAbility(playerId)
end

---

GetName

• 描述: 获取技能名称

• 范围: 服务端、客户端

参数列表:

参数	类型	说明
skillId	number	技能id

返回字段:

返回字段	字段类型	说明
name	string	技能名称

local skillName = Skill:GetName(1)

---

GetIcon

• 描述: 获取技能图标

• 范围: 服务端、客户端

参数列表:

参数	类型	说明
skillId	number	技能id

返回字段:

返回字段	字段类型	说明
icon	number	技能图标
isCustom	boolean	是否是自定义图片

local skillIcon,isCustom = Skill:GetIcon(1)

---

GetCD

• 描述: 获取技能冷却

• 范围: 服务端、客户端

参数列表:

参数	类型	说明
skillId	number	技能id

返回字段:

返回字段	字段类型	说明
cd	number	技能冷却

local skillCD = Skill:GetCD(1)

---

GetCurrentCD

• 描述: 获取技能当前冷却

• 范围: 服务端、客户端

参数列表:

参数	类型	说明
playerId	number	角色id
skillId	number	技能id

返回字段:

返回字段	字段类型	说明
currentCD	number	技能当前冷却

local currentCD = Skill:GetCurrentCD(playerId, 1)

---