洱海月 花榜活动开启教程与 GM 测试教程

适用对象：正式服管理员、测试服 GM、活动联调人员。

适用版本：当前 0.08.0501 新客户端与当前服务端花榜适配版本。

本文把花榜分成两套活动说明，并严格区分“正式服运营流程”和“测试服验证流程”。正式服请只按正式服章节执行，不要照搬测试服短时开榜、立即结算、模拟送花等命令。

一、先理解：现在有两套花榜界面

当前客户端里花榜不是一个界面，而是两套 UI / 两套客户端请求逻辑：

活动	客户端显示	服务端标记	推荐开启命令	主要花道具	客户端脚本	榜单回包
情人节花榜	普通花榜 / 情人节花榜	uiflag=1	!!openqingrenhuabang	乐章玫瑰	892974	1021
七夕花榜	星河花序榜 / 七夕花榜	uiflag=2	!!openqixihuabang	蓝色妖姬	891396	974

虽然客户端是两套界面，但服务端底层共用一套花榜排行状态机。也就是说，同一个区服同一时间只建议开启一套花榜活动。

重要结论：

• uiflag=1 打开情人节花榜。
• uiflag=2 打开七夕 / 星河花序榜。
• 同一区服不要同时开情人节花榜和七夕花榜。
• 正式服不要用 minutes=、seconds=、finishhuabang、addhuabangflower 这类测试命令。
• 开榜、关榜、结算都会影响当前区服正在进行的花榜。

二、正式服运营流程

正式服目标是稳定开活动、正常展示图标、玩家真实送花上榜、活动结束后正常领奖。

1. 正式服开情人节花榜

开榜前先查询当前状态：

!!huabanginfo

如果提示当前已有花榜进行中，不要直接再开。先确认是否需要等待结束，或由负责人决定是否关闭旧活动。

按指定日期和时间开启情人节花榜：

!!openqingrenhuabang date=20260520 hour=23 minute=0

含义：

• date=20260520 表示活动结束日期为 2026 年 5 月 20 日。
• hour=23 minute=0 表示活动结束时间为当天 23:00。
• 不写 date 时默认当天。
• 不写 hour minute 时默认 23:00。

开启后检查状态：

!!huabanginfo

查看当前榜单：

!!huabangtop

手动刷新在线玩家活动图标：

!!refreshhuabangicon

2. 正式服开七夕 / 星河花序榜

开榜前先查询当前状态：

!!huabanginfo

按指定日期和时间开启七夕花榜：

!!openqixihuabang date=20260819 hour=23 minute=0

开启后检查：

!!huabanginfo
!!huabangtop
!!refreshhuabangicon

玩家打开小地图活动图标后，应进入“星河花序榜 / 七夕花榜”界面。

3. 正式服开启指定榜期按钮

花榜有 3 个榜期 / 页面按钮，服务端使用 migration=1/2/3 标识。

常用快捷命令：

!!openlindonghuabang date=20260520 hour=23 minute=0
!!openxinxuehuabang date=20260520 hour=23 minute=0
!!openhanyehuabang date=20260520 hour=23 minute=0

如果要明确开启七夕花榜的指定榜期，需要带 uiflag=2：

!!openlindonghuabang uiflag=2 date=20260819 hour=23 minute=0
!!openxinxuehuabang uiflag=2 date=20260819 hour=23 minute=0
!!openhanyehuabang uiflag=2 date=20260819 hour=23 minute=0

更通用的写法：

!!openhuabangphase phase=凛冬 uiflag=1 date=20260520 hour=23 minute=0
!!openhuabangphase phase=新雪 uiflag=1 date=20260520 hour=23 minute=0
!!openhuabangphase phase=寒夜 uiflag=1 date=20260520 hour=23 minute=0

七夕则把 uiflag=1 改成 uiflag=2。

正式服建议优先使用明确活动类型的命令：

• 情人节主入口：!!openqingrenhuabang
• 七夕主入口：!!openqixihuabang
• 指定榜期时必须手动确认 uiflag

4. 正式服查看可上榜花道具

查看情人节花榜花道具：

!!huabangflowers uiflag=1

情人节花榜使用乐章玫瑰：

道具 ID	名称	花数	代币
38002467	1 朵乐章玫瑰	1	1
38002468	10 朵乐章玫瑰	10	10
38002469	15 朵乐章玫瑰	15	12
38002470	999 朵乐章玫瑰	999	400
38008176	9999 朵乐章玫瑰	9999	400

查看七夕花榜花道具：

!!huabangflowers uiflag=2

七夕花榜使用蓝色妖姬：

道具 ID	名称	花数	代币
38002280	1 朵蓝色妖姬	1	1
38002281	10 朵蓝色妖姬	10	10
38002282	15 朵蓝色妖姬	15	12
38002283	999 朵蓝色妖姬	999	400
38008175	9999 朵蓝色妖姬	9999	400

七夕花榜的代币为“诉情蝶”，实际道具 ID 为 38002284。玩家成功向他人赠送蓝色妖姬后，会获得对应数量的诉情蝶道具，同时服务端也会更新花榜个人代币数据。

正式服玩家必须通过真实使用对应花道具进入榜单。不要用模拟送花命令给正式服刷榜。

5. 正式服正常结束与领奖

正式服推荐让活动自然到达结束时间。

结束后管理员检查：

!!huabanginfo
!!huabangtop

玩家领取奖励时，如果提示“活动正在进行中”，通常说明当前服务器认为结束时间还没到。请先确认：

• !!huabanginfo 显示的 date 和 end 是否确实已经过期。
• 服务器时间是否正确。
• 是否误开了新的花榜，覆盖了当前状态。

正式服不建议用：

!!finishhuabang

除非已经明确是运营事故修复，并且负责人确认需要立即结算。

6. 正式服关闭活动

关闭命令：

!!closehuabang

注意：关闭不是正常结算。

!!closehuabang 会关闭当前花榜，并且可能导致本期不可领取奖励。正式服只有在误开、活动异常、需要强制下架时才使用。

关闭后刷新图标：

!!refreshhuabangicon

然后再次确认：

!!huabanginfo

三、测试服 GM 测试流程

测试服目标是快速验证：图标是否出现、界面能否打开、送花是否上榜、排行是否刷新、结束后是否可领奖。

以下命令只建议测试服使用。

1. 测试情人节花榜完整流程

开启一个 2 分钟测试活动：

!!openqingrenhuabang minutes=2

确认状态：

!!huabanginfo

刷新图标：

!!refreshhuabangicon

查看可用花道具：

!!huabangflowers uiflag=1

准备两个在线角色，并让两个角色在同一个场景。查询双方 ObjID：

!!guid

模拟送花：

!!addhuabangflower from=送花方ObjID to=收花方ObjID item=38002470

查看排行：

!!huabangtop limit=20

如果要立即进入可领奖状态：

!!finishhuabang

然后打开花榜界面测试领奖。

2. 测试七夕 / 星河花序榜完整流程

开启一个 2 分钟测试活动：

!!openqixihuabang minutes=2

确认状态：

!!huabanginfo

刷新图标：

!!refreshhuabangicon

查看七夕花道具：

!!huabangflowers uiflag=2

模拟送花：

!!addhuabangflower from=送花方ObjID to=收花方ObjID item=38002283

查看排行：

!!huabangtop limit=20

立即结算：

!!finishhuabang

然后点击小地图活动图标，确认“星河花序榜 / 七夕花榜”可以打开并显示数据。

3. 测试三个榜期 / 左侧按钮

测试服可以分别开三个榜期，每次测试前建议先确认当前状态：

!!huabanginfo

测试情人节三个榜期：

!!openlindonghuabang uiflag=1 minutes=2
!!openxinxuehuabang uiflag=1 minutes=2
!!openhanyehuabang uiflag=1 minutes=2

测试七夕三个榜期：

!!openlindonghuabang uiflag=2 minutes=2
!!openxinxuehuabang uiflag=2 minutes=2
!!openhanyehuabang uiflag=2 minutes=2

如果只需要调整某个已开启榜期的剩余时间：

!!sethuabangphasetime phase=新雪 minutes=1
!!sethuabangphasetime phase=寒夜 seconds=60

注意：sethuabangphasetime 只调整已存在的榜期，不负责新开榜期。没有开启过的榜期会提示未开启。

4. 测试服常用快速命令

目的	命令
查看状态	!!huabanginfo
查看排行	!!huabangtop limit=20
查看花道具	!!huabangflowers uiflag=1 / !!huabangflowers uiflag=2
开情人节测试榜	!!openqingrenhuabang minutes=2
开七夕测试榜	!!openqixihuabang minutes=2
修改当前榜剩余时间	!!sethuabangtime minutes=1
立即结算当前榜	!!finishhuabang
模拟送花	!!addhuabangflower from=送花方ObjID to=收花方ObjID item=花道具ID
刷新活动图标	!!refreshhuabangicon
强制关闭当前榜	!!closehuabang

四、正式服严禁照搬的测试命令

以下命令在测试服很方便，但正式服容易造成异常结果。

1. 不要在正式服短时开榜

测试服命令：

!!openqingrenhuabang minutes=2
!!openqixihuabang minutes=2
!!openhuabang seconds=60

风险：

• 活动会很快结束，玩家可能来不及参与。
• 可能导致奖励提前结算。
• 如果误点图标，玩家会看到异常短的活动时间。

正式服应使用：

!!openqingrenhuabang date=20260520 hour=23 minute=0
!!openqixihuabang date=20260819 hour=23 minute=0

2. 不要在正式服模拟送花

测试服命令：

!!addhuabangflower from=送花方ObjID to=收花方ObjID item=38002283

风险：

• 不消耗玩家真实道具。
• 会直接写入排行榜和个人送收花数据。
• 会影响正式榜单公平性。

正式服只能让玩家真实使用花道具。

3. 不要在正式服随意立即结算

测试服命令：

!!finishhuabang

风险：

• 当前花榜会立即进入结束 / 可领奖流程。
• 如果玩家还在正常送花，会被提前截止。
• 可能造成运营时间与公告不一致。

正式服只有在活动事故修复时才允许使用，并且必须先截图保存：

!!huabanginfo
!!huabangtop limit=20

4. 不要把关闭当作正常结算

命令：

!!closehuabang

风险：

• 关闭是不结算式下架。
• 当前榜期可能不可领取奖励。

正式服正常活动结束不需要执行 closehuabang。

五、推荐正式服 SOP

开活动前

1. 确认本次活动类型：情人节花榜还是七夕花榜。
2. 确认结束日期和结束时间。
3. 执行 !!huabanginfo，确认没有其他花榜正在进行。
4. 执行对应开启命令。
5. 执行 !!refreshhuabangicon。
6. 用普通玩家号确认活动图标和界面能打开。

活动进行中

1. 定期执行 !!huabanginfo 查看活动状态。
2. 定期执行 !!huabangtop limit=20 查看排行是否有数据。
3. 如果玩家反馈送花不上榜，先确认送的花是否属于当前活动类型。
4. 情人节花榜用乐章玫瑰，七夕花榜用蓝色妖姬，不能混用。

活动结束后

1. 等待活动自然结束。
2. 执行 !!huabanginfo 和 !!huabangtop limit=20 保存状态。
3. 用玩家号打开花榜界面测试领奖。
4. 如果仍提示活动进行中，先检查服务器时间和 huabanginfo 的结束时间，不要第一时间关闭活动。

六、常见问题

1. 图标出现了，但是点击没反应

优先检查活动类型和客户端回包是否匹配。

• 情人节花榜应走 uiflag=1、脚本 892974、回包 1021。
• 七夕花榜应走 uiflag=2、脚本 891396、回包 974。

当前版本已经适配七夕花榜专用回包。如果再次出现点击没反应，优先看服务端是否部署了最新 packet.lua、QiXiTop.lua、script_base.lua。

2. 送花后没有进入榜单

检查顺序：

1. !!huabanginfo 确认花榜正在进行。
2. !!huabangflowers uiflag=1/2 确认花道具属于当前活动。
3. 情人节花榜只能用乐章玫瑰。
4. 七夕花榜只能用蓝色妖姬。
5. 送花方和收花方不能是同一个角色。

3. 领取奖励提示活动还在进行中

说明服务端判断当前榜期还没到结束时间。

处理方式：

1. 执行 !!huabanginfo 查看 date 和 end。
2. 检查服务器时间是否正确。
3. 确认是否误开了新的花榜。
4. 测试服可以用 !!finishhuabang 快速结算。
5. 正式服不要直接 finishhuabang，必须先确认运营负责人同意。

4. 七夕花榜和情人节花榜能不能同时开

不建议，也不按同时开启设计。

当前服务端同一区服共用一套花榜状态，uiflag 只是区分当前这期花榜属于哪种界面。强行同时开两套，后开的活动可能覆盖当前活动状态。

5. openhuabang 和专用命令怎么选

正式服推荐：

!!openqingrenhuabang date=YYYYMMDD hour=23 minute=0
!!openqixihuabang date=YYYYMMDD hour=23 minute=0

不推荐正式服直接使用：

!!openhuabang uiflag=1
!!openhuabang uiflag=2

原因是通用命令更容易漏写或写错 uiflag。