设置主界面按钮

主题说明

这一组 MAIN_FUNC_BTN_* 命令，建议合并理解为“主界面按钮”能力，而不是拆成彼此独立、毫无关系的 4 条命令。

它们和 MainWidgetCfg.ini 是同一套功能的两侧：

• MainWidgetCfg.ini 负责定义主界面按钮的基础结构、默认图片、挂载区域和初始坐标。
• MAIN_FUNC_BTN_* 命令负责在运行时动态改按钮的显示、闪烁、位置和展示参数。

适用场景

• 首页或主界面功能入口
• 活动按钮、商城按钮、限时入口按钮
• 需要在脚本运行中动态显示、强调或换位的主界面按钮

覆盖命令

• MAIN_FUNC_BTN_SHOW
• MAIN_FUNC_BTN_FLASH
• MAIN_FUNC_BTN_POS
• MAIN_FUNC_BTN_CAPTION

与 MainWidgetCfg.ini 的分工

如果按钮根本没有在配置文件里准备好，脚本命令通常也无法凭空补出完整按钮能力。

命令分工

各命令怎么配合

MAIN_FUNC_BTN_SHOW

用于控制某个主界面按钮当前是否显示。

MAIN_FUNC_BTN_SHOW <序号> <显示状态>

• 序号：按钮编号（范围 0~78），要和 MainWidgetCfg.ini 里的按钮编号一致。
• 显示状态：0=显示，1=隐藏。
• 适合做功能开放、活动结束后隐藏入口、登录后按条件显示按钮。

MAIN_FUNC_BTN_FLASH

用于控制某个按钮是否闪烁。

MAIN_FUNC_BTN_FLASH <序号> <闪烁状态>

• 序号：按钮编号。
• 闪烁状态：0=不闪烁，1=闪烁。
• 适合做活动提醒、限时入口提示、需要玩家优先注意的按钮强调。

MAIN_FUNC_BTN_POS

用于在运行时动态改按钮位置。

MAIN_FUNC_BTN_POS <序号> <X坐标> <Y坐标>

• 序号：按钮编号。
• X坐标、Y坐标：除了普通坐标，还带有中线、右对齐、下对齐、右下对齐这些特殊规则。
• X=10000、Y=10000 时，可直接居中。
• 适合做大分辨率适配、节日布局切换、不同界面模式下的按钮重排。

MAIN_FUNC_BTN_CAPTION

用于动态设置按钮标题和展示参数。

MAIN_FUNC_BTN_CAPTION <序号> <参数串>

• 序号：按钮编号。
• 参数串 格式：标题/支持换行|图库|起始图片|数量|延时|X|Y|looks|物品ID|包观/内观:0/1
• 适合做按钮文案替换、图标切换，以及按钮上挂物品展示或外观展示。

推荐搭配方式

一个主界面按钮通常不是只用一条命令，而是按下面的顺序配合：

1. 先在 MainWidgetCfg.ini 里准备好按钮编号、默认图片和挂载点。
2. 用 MAIN_FUNC_BTN_SHOW 决定这个按钮当前显不显示。
3. 需要提醒时，再用 MAIN_FUNC_BTN_FLASH 做闪烁提示。
4. 需要换布局时，用 MAIN_FUNC_BTN_POS 调位置。
5. 需要动态改文案、图标或展示内容时，再用 MAIN_FUNC_BTN_CAPTION。

推荐理解顺序

1. 先看 MainWidgetCfg.ini，理解按钮编号、挂载点和基础图片资源。
2. 再看 SHOW、FLASH、POS、CAPTION 四条命令分别负责哪一层动态控制。
3. 最后再回到具体业务脚本里看某个按钮是怎样被动态驱动的。

注意事项

• 这一组命令依赖客户端支持，使用前应先确认对应按钮系统已经接入当前客户端版本。
• MainWidgetCfg.ini 负责“初始形态”，脚本命令负责“运行时变化”，两边最好按同一套按钮编号维护。
• 如果项目里主界面按钮很多，建议先整理“按钮编号表”和“挂载区域表”，再写脚本联动。

相关命令

• 开启或关闭客户端挂机
• 客户端模拟键盘
• MainWidgetCfg.ini