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

【界面UI】行会面板:成员列表与在线状态

2026-09-22 21:12 作者:996 技术组 0 阅读 界面UI

实战应用:用在哪里

行会面板是会长的管理台:成员的列表、在线的状态、职位与贡献,一眼看清行会的家底。面板的要点是成员列表的排序、在线状态的实时呈现与职位操作的入口——管理的效率在界面的信息组织里。

列表的排序

lua

---行会面板:成员的排序与渲染
GuildPanel.sortMode = "online"

function GuildPanel.render(members)
    -- 排序:在线优先,同级按贡献降序
    table.sort(members, function(a, b)
        if a.online ~= b.online then
            return a.online
        end
        return a.point > b.point
    end)
    GUI:ListView_DeleteAllItem(GuildPanel.list)
    for i, m in ipairs(members) do
        local row = GUI:Text_Create(GuildPanel.list,
            "m" .. i, 0, 0, 12,
            m.online and "#FFFFFF" or "#888888",
            string.format("%s  Lv.%d  %s",
                m.name, m.level,
                m.online and "在线" or "离线"))
        GUI:addOnClickEvent(row, function()
            GuildPanel.memberMenu(m)
        end)
    end
end

成员的排序两维:在线的排前面(管理的动作发生在在线的人身上),同在线的按贡献降序——贡献高的活跃成员置顶,会长的目光自然落在核心成员上。离线的成员灰显但不隐藏,行会的家底要完整呈现。点击成员行弹出操作的菜单:加好友、私聊、任免职位、移出行会,按点击者的职位显示可用的操作——普通成员看到的是社交操作,会长的看到的是管理操作。

在线的同步

lua

---在线状态的刷新:登录与离线的推送
SL:RegisterLuaNetMsg("GUILDONLINE", function(data)
    local d = SL:JsonDecode(data)
    if not d then return end
    for _, m in ipairs(GuildPanel.members) do
        if m.name == d.name then
            m.online = d.online
        end
    end
    GuildPanel.render(GuildPanel.members)
end)

---贡献的实时更新:捐献后刷新
SL:RegisterLuaNetMsg("GUILDPOINT", function(data)
    local d = SL:JsonDecode(data)
    if not d then return end
    for _, m in ipairs(GuildPanel.members) do
        if m.name == d.name then
            m.point = d.point
        end
    end
    GuildPanel.render(GuildPanel.members)
end)

在线与贡献的变更走两条推送通道:成员的上下线实时刷新在线标记,捐献的变化实时更新贡献的数字——面板的状态与真实的世界同频,会长的决策基于当下的数据。面板的头部的汇总条:在线人数、今日捐献、本周活跃三个数字,行会的脉搏一屏可读。大行会的分页:300 人的行会列表分页展示,搜索框按名字定位成员——规模的管理不让滚动变成体力活。

验证与监控

面板的数据与服务器状态的偏差抽样,在线标记的错位即同步缺陷;排序与渲染的耗时监控,300 人列表的渲染不超 50 毫秒。

踩坑记录

在线的推送曾经全量刷新,一人上下线整表重排,增量更新单行修复。贡献的显示曾经不更新,捐献后面板数字纹丝不动,推送的通道补齐。职位的操作入口曾经对所有成员可见,点了报权限错误,入口的可见性按职位过滤。

上线要点

面板的排序模式可切换:在线优先、贡献优先、职位优先三档。成员的备注功能给会长,管理笔记跟人走。行会的公告在面板的头部常驻,管理的信息与成员的数据同屏。

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

作者履历与出处

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

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

最新技术文章 · 实战干货

LATEST ARTICLES

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

工具链

【工具链】风格检查器:Lua 脚本命名与规范的自动审查

实战应用:用在哪里 脚本的规范靠人盯盯不过来:命名风格漂移、全局变量乱用、缩进混着来——风格检查器把这些规则的执行自动化。提…

2026-09-22 22:32 996 技术组 · 0 阅读
界面UI

【界面UI】拍卖行界面:出价流程与截拍提醒

实战应用:用在哪里 拍卖行的出价是一场与时间的博弈:出价的按钮、倒计时的紧迫、截拍瞬间的悬念——拍卖界面的要点是出价的流程、…

2026-09-22 21:12 996 技术组 · 0 阅读
框架设计

【框架设计】幸运值机制:强化失败的隐性补偿

实战应用:用在哪里 强化连败七次是什么体验?幸运值机制给失败的玩家一个隐性的承诺:每次失败累加幸运值,幸运值越高下一次的成功…

2026-09-22 21:12 996 技术组 · 0 阅读
安全加密

【安全加密】日志防篡改:哈希链与异地备份

实战应用:用在哪里 审计日志的价值在于不可抵赖:被改过的日志比没有日志更危险——纠纷的追溯、内部的追责都建立在「日志没被动过…

2026-09-22 21:12 996 技术组 · 0 阅读
性能调优

【性能调优】批量邮件:活动奖励的分批投递

实战应用:用在哪里 活动结束给 3 万玩家发奖励:一次性群发让邮件表瞬间多 3 万行、投递的队列堵塞正常的通信。批量邮件的分…

2026-09-22 21:12 996 技术组 · 0 阅读
网络通信

【网络通信】面对面交易:握手、锁定与确认的协议

实战应用:用在哪里 面对面的交易是传奇最经典的交互:两人面对面、各自放入物品与金币、双方确认后成交。交易的协议要点是会话的建…

2026-09-22 21:12 996 技术组 · 0 阅读