CHUAN2 DEV ENGINE
996 正版授权研发中心 · 360 授权合作教学中心 · 抖音传奇直播合作授权 · 快手推广运营商授权
OFFICIAL LICENSED ACADEMY 查验官方授权证书 →
// 威海旷世互娱教学基地 · 技术文章
界面UI技能栏冷却

【界面UI】技能栏冷却倒计时:烈火剑法CD的图标遮罩与秒数显示

2026-09-23 17:01 作者:996 技术组 0 阅读 996引擎Lua教程传奇脚本

实战应用:用在哪里

战士的烈火剑法讲究卡CD爆发,技能栏里CD秒数与遮罩是否清晰,直接影响操作手感。本篇用996引擎前端控件做冷却图标:底层技能图标、上层转盘遮罩、中央倒计时数字,三层联动。

技能格与转盘遮罩

技能格用ItemBox承载图标,ProgressTimer做扇形遮罩,遮罩随剩余CD从满盘退到空盘。

lua
local box = GUI:ItemBox_Create(skillBar, "fireSkill", 12, 8, "res/skill/liehuo.png", 1)
local cdMask = GUI:ProgressTimer_Create(box, "cdMask", 0, 0, "res/public/cd_mask.png", 46, 46)
GUI:ProgressTimer_setPercentage(cdMask, 0)
GUI:addOnClickEvent(box, function()
    SL:SendNetMsg(4301, { skill = "烈火剑法" })
    GUI:ProgressTimer_setPercentage(cdMask, 100)
    GUI:ProgressTimer_progressTo(cdMask, 12, 0, nil, 1)
end)

中央秒数倒计时

倒计时文字用Text_COUNTDOWN接口,与遮罩同起点同终点,12秒技能读秒一目了然。

lua
local cdText = GUI:Text_Create(box, "cdNum", 23, 20, "18", 14, { 255, 255, 120 })
GUI:Text_COUNTDOWN(cdText, 12, function()
    GUI:ProgressTimer_setPercentage(cdMask, 0)
    GUI:setText(cdText, "")
    SL:ShowSystemTips("烈火剑法已就绪")
end)

验证与监控

真机跑三档机型各测二十次点击:遮罩与数字必须同帧归零,误差超过一帧就能被肉眼发现。低端机上ProgressTimer加倒计时文字同时跑,帧率跌破30要换成整图序列帧方案。埋点统计按钮点击与CD归零的时间差,异常偏长说明客户端时间被挂起。

踩坑记录

Text_COUNTDOWN的时间参数是秒,内部按整秒跳字,开头一秒会显示满值,视觉上像延迟,建议时间参数减0.2秒对齐。ProgressTimer的贴图必须是径向扇形图,普通方图会呈现整块淡出而不是扫盘。技能升级改CD后,前端写死的12秒要改成从服务端属性同步读取,否则数值改版忘改前端。界面销毁时Text_COUNTDOWN的回调仍会触发,回调里访问已销毁控件会报空引用,回调首行先判widget有效性。

作者履历与出处

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付,内容以官方知识库与真实项目为出处,按版本持续修订。

← 返回文章地图返回研学路径

最新技术文章 · 实战干货

LATEST ARTICLES

全站技术干货持续更新:996 引擎 / Lua 实战帖,语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →

运维发布服务降级保底预案

【运维发布】服务降级预案:核心链路的保底方案

实战应用:用在哪里 排行榜卡死拖累登录、成就推送挤占带宽,这些非核心功能出问题时最需要的是一个总闸。服务降级预案定义了核心链…

2026-09-23 22:46 996 技术组 · 0 阅读
框架设计装备共鸣套装加成

【框架设计】装备共鸣:多件套共鸣与全局加成

实战应用:用在哪里 单件装备的属性提升有限,套装共鸣让多件装备产生化学反应:穿戴同系三件以上触发共鸣属性,五件触发全局光环。…

2026-09-23 22:46 996 技术组 · 0 阅读
安全加密异常登录多设备拦截

【安全加密】异常登录防护:多设备同时在线的检测与拦截

实战应用:用在哪里 同一账号在两台设备同时在线,一台打怪一台交易,是盗号者测试密码后的标准动作。多设备在线检测在登录环节检查…

2026-09-23 22:46 996 技术组 · 0 阅读
数据存储数据迁移搬家批量

【数据存储】数据迁移:角色数据的批量搬家实践

实战应用:用在哪里 老服合并、机房迁移、数据分库改造,都涉及角色数据的批量搬家。数据迁移的核心是搬运过程中不断服、不丢数据、…

2026-09-23 22:46 996 技术组 · 0 阅读
引擎触发沙影之路暗之Boss镜像刷新

【引擎触发】沙影之路:暗之Boss的镜像刷新触发设计

实战应用:用在哪里 沙影之路的暗之Boss是行会实力的试金石:真身与三个镜像随机分布在四个祭坛,只有击杀真身才有掉落,镜像被…

2026-09-23 22:46 996 技术组 · 0 阅读
玩法策划攻城拔寨城门战术

【玩法策划】攻城拔寨:城门攻坚的战术分层设计

实战应用:用在哪里 攻城战最容易变成人海推门的无脑玩法。攻城拔寨将城门攻坚设计为三线战术:正面强攻吸引火力、侧翼工程车破城、…

2026-09-23 22:46 996 技术组 · 0 阅读