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

【界面UI】队伍面板:成员血条的同步展示

2026-09-21 18:44 作者:996 技术组 界面UI

实战应用:用在哪里

组队打宝时队伍面板是道士的眼睛:四个队友的血条、位置、BUFF 状态一屏尽收,群体治疗的半径判断全靠它。队伍面板的实现要点是成员列表的构建、血条的实时同步与离队成员的移除。

面板的构建

lua

---队伍面板:成员行与血条
TeamPanel.rows = {}

function TeamPanel.build(win)
    local list = GUI:ListView_Create(win, "team", 0, 0, 200, 260)
    for i = 1, 4 do
        local row = GUI:Node_Create(list, "row" .. i, 0, (i - 1) * 62)
        local name = GUI:Text_Create(row, "name" .. i, 8, 4,
            12, "#FFFFFF", "--")
        local bar = GUI:LoadingBar_Create(row, "hp" .. i, 8, 24)
        GUI:LoadingBar_setType(bar, 0)
        TeamPanel.rows[i] = { node = row, name = name, bar = bar }
    end
end

四个成员行预建复用:名字文本加载血条,行的控件一次构建,成员的进出只改数据不重建控件——面板的构建成本固定,队伍满编与单人不差毫秒。血条用进度条控件承载,百分比驱动填充,血量的变化以填充的伸缩呈现。

血条的同步

lua

---服务器推送的队伍状态:注册前端消息
SL:RegisterLuaNetMsg("TEAMSYNC", function(data)
    local team = SL:JsonDecode(data)
    if not team then return end
    for i = 1, 4 do
        local m = team.members[i]
        local row = TeamPanel.rows[i]
        if m then
            GUI:Text_setString(row.name, m.name)
            local pct = math.floor(m.hp / m.maxHp * 100)
            GUI:LoadingBar_setPercent(row.bar, pct)
            if pct < 30 then
                GUI:LoadingBar_setColor(row.bar, "#FF4444")
            else
                GUI:LoadingBar_setColor(row.bar, "#66CC66")
            end
        else
            GUI:Text_setString(row.name, "--")
            GUI:LoadingBar_setPercent(row.bar, 0)
        end
    end
end)

队伍的状态由服务器每秒聚合推送一次:名字、当前血、最大血的三元组打包进 TEAMSYNC 消息,前端注册的处理器按行填充。血量低于 30% 的成员血条变红——道士的目光被颜色引到最危险的队友,治疗的优先级有了视觉的导航。面板与施法的联动:点击成员行选中为目标,群体治疗的圆心以选中者为参考,面板不只是看板还是操作的对象。离队与掉线的成员行显示占位的横杠,队伍的空位清晰可见,招募的缺口一目了然。

验证与监控

血条百分比与服务器状态的偏差抽样,偏差超 1% 即同步缺陷;推送的频率与包体大小监控,千字节的队伍包是带宽的良性占用。

踩坑记录

成员的顺序曾经按进队时间排,中途换位让面板的行跳动,固定槽位制(进队占位)让面板稳定。血条的刷新曾经每帧拉服务器,量级失控,改为服务器的秒级聚合推送。掉线成员的血条曾经冻在旧值,误导道士的治疗判断,超时成员的置灰处理。

上线要点

面板的槽位数按队伍上限配置,六人队与四人队的皮肤自适应。血条的样式与主体的血条同源,颜色语义全界面一致。面板的位置支持拖动记忆,每个玩家的习惯布局被尊重。

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

作者履历与出处

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

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

幂尔框架 · 实战干货 · 接口调用

LATEST ARTICLES

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

玩法策划基金成长

【玩法策划】基金系统:成长基金的节点返利玩法设计

实战应用:用在哪里 付费玩家的付费点集中在商城,成长线里缺一个长期投入的钩子。成长基金让玩家在低等级时一次性买入,随等级提升…

2026-09-23 02:55 996 技术组
玩法策划联赛竞猜

【玩法策划】行会联赛竞猜:比赛竞猜与竞猜币的玩法设计

实战应用:用在哪里 行会联赛打得不热闹,观战人数不到参赛人数的一半。联赛竞猜给观战者一张入场券:用竞猜币押注胜负,赔率随投注…

2026-09-23 02:55 996 技术组
案例复盘限时活动配置

【案例复盘】活动提前结束:限时活动提前关闭的事故复盘

实战应用:用在哪里 七夕限时活动原计划七天,上线第二天下午整点活动面板突然关闭,奖励领了一半,玩家以为被砍了福利,两小时内工…

2026-09-23 02:55 996 技术组
运维发布证书续期

【运维发布】证书续期:HTTPS 证书的自动提醒与登记机制

实战应用:用在哪里 HTTPS 证书过期一次,全服登录白屏了半个多小时,值班才发现证书没人管。证书续期机制把到期日写进系统变…

2026-09-23 02:55 996 技术组
界面UI堆栈返回

【界面UI】界面堆栈管理:页面返回的正确次序

实战应用:用在哪里 从行会面板点进成员列表再点开个人名片,连按返回键直接退回了主城,中间两层界面全部跳过。界面堆栈管理用一张…

2026-09-23 02:55 996 技术组
前端接口商城倒计时

【前端接口】商城橱窗:限时商品的上架倒计时实现

实战应用:用在哪里 限时商城的稀缺商品上架即被抢,玩家错过窗口感觉被区别对待。商城橱窗把每件限时商品的下架时间做成可视化倒计…

2026-09-23 02:55 996 技术组