传奇主界面自定义按钮配置教程 完整功能设置详解
一、主界面自定义按钮基础功能介绍传奇游戏客户端支持主界面自定义按钮搭建，单界面最多可设置40个自定义按钮，整体配置可依托游戏登录流程自动更新，无需手动反复刷新，适配各类传奇版本自定义界面改造需求。所有按钮功能依托客户端data目录下的MainWidgetCfg.ini配置文件实现，是改造主界面UI、…
一、主界面自定义按钮基础功能介绍
传奇游戏客户端支持主界面自定义按钮搭建，单界面最多可设置40个自定义按钮，整体配置可依托游戏登录流程自动更新，无需手动反复刷新，适配各类传奇版本自定义界面改造需求。所有按钮功能依托客户端data目录下的MainWidgetCfg.ini配置文件实现，是改造主界面UI、拓展游戏功能入口的核心配置文件。
该配置文件支持图片素材调用、按钮显示隐藏、闪烁特效、位置调整、字体颜色自定义等多项功能，同时可联动游戏脚本实现各类自定义交互效果，适配传奇私服界面优化、功能拓展、个性化UI定制等场景。
二、MainWidgetCfg.ini核心基础配置规则
2.1 图片素材调用规则
配置文件中设置wmlib=Lui时，系统将自动调用Lui.pkg素材包内的图片资源，直接读取Lui.pkg内部文件名称即可生效；若为非Lui库素材，需保证图片索引数值大于0，素材方可正常加载展示。
2.2 子按钮显示控制配置
通过LoginShowChildButton字段控制登录展示效果，参数设置规则如下：
LoginShowChildButton=0：游戏登录后隐藏所有子按钮；
LoginShowChildButton=1：游戏登录后展示所有子按钮。
2.3 字体颜色自定义配置
新版MainWidgetCfg.ini新增按钮字体颜色定义参数，可自定义三种状态字体色彩，全面适配界面视觉设计需求：
NormalColor：按钮常态状态字体颜色；
HoverColor：鼠标悬浮按钮时字体颜色；
PressColor：鼠标点击按压按钮时字体颜色。
颜色支持三种格式：clXXXXX格式、#nnnnn十六进制格式、0~255区间256位颜色表格式，适配各类配色需求。
2.4 按钮基础尺寸与挂载位置配置
可固定设置按钮长宽尺寸，也可自适应素材图片大小，核心参数如下：
Width1=36：定义按钮基础宽度，长宽参数均为0时，按钮尺寸跟随素材图片大小；
Height1=32：定义按钮基础高度，长宽参数均为0时，按钮尺寸跟随素材图片大小；
Parent1=1：默认挂载位置，对应人物装备展示界面；
Parent0=9：支持将自定义按钮固定在游戏聊天栏上方区域，适配多场景界面布局。
2.5 基础功能对应界面入口
自定义按钮可绑定游戏原生核心界面，一键跳转对应功能面板，对应规则如下：
1：绑定人物背包展示界面；
2：绑定人物装备面板展示，包含七大细分面板：装备面板、时装面板、状态面板、属性面板、称号面板、技能面板、其他面板；
3：绑定游戏商城展示界面；
4-8：支持怪物血条联动展示装备属性，提升游戏实战查看便捷性。
三、按钮脚本触发与NPC控制指令
3.1 按钮点击脚本触发规则
主界面自定义按钮按照序号排序，点击对应按钮后，将自动执行客户端QChatMission-0.txt脚本中对应的触发字段，序号对应规则为：[@MainBtnFunc_0]至[@MainBtnFunc_40]，其中[@MainBtnFunc_40]为按钮显示开关专属触发字段。
3.2 NPC通用控制脚本命令
可通过脚本指令远程控制自定义按钮状态、位置、特效，核心指令如下：
MAIN_FUNC_BTN_SHOW 序号 0/1：控制对应序号按钮显示或隐藏，0为隐藏、1为显示；
MAIN_FUNC_BTN_FLASH 序号 0/1：控制对应序号按钮闪烁特效，0为关闭、1为开启；
MAIN_FUNC_BTN_POS 序号 X Y：调整对应序号按钮的屏幕坐标位置；
!Setup.txt OpenMainFuncBtns= 0/1：全局开关，控制主界面自定义按钮功能整体开启或关闭，默认状态为关闭。
四、完整MainWidgetCfg.ini配置示例模板
以下为可直接复制使用的完整配置模板，包含开关按钮、多组功能按钮参数配置，适配多数传奇版本：
[button]
; 开关按钮
;-----------------------------------------
; 登陆是否显示子按钮
LoginShowChildButton=0
; 素材文件名
wmlib=Prguse2
; 标题
caption=开关
; Tips提示
tips=点击显示/隐藏功能按钮
; 坐标X
x=5
; 坐标Y
y=45
; 普通状态图片
NormalImg=223
; 高亮图片（鼠标滑过，设置0会自动高亮普通状态的图片）
LightImg=0
; 按下状态图片
PushedImg=224
; 功能按钮个数
;-----------------------------------------
count=3
; 功能按钮0设置
;-----------------------------------------
Visible0=1
wmlib0=lui
caption0=按钮0
tips0=Tips0
x0=40
y0=55
NormalImg0=DscStart0.bmp
LightImg0=
PushedImg0=DscStart1.bmp
OpenLevel0=1
; 功能按钮1设置
;-----------------------------------------
Visible1=1
wmlib1=Prguse2
caption1=按钮1
tips1=Tips1
x1=120
y1=55
NormalImg1=170
LightImg1=0
PushedImg1=171
OpenLevel1=1
; 功能按钮2设置
;-----------------------------------------
Visible2=1
wmlib2=Prguse2
caption2=按钮2
tips2=Tips2
x2=200
y2=55
NormalImg2=217
LightImg2=0
PushedImg2=218
OpenLevel2=1
五、AC专用按钮坐标对齐规则
通过MAIN_FUNC_BTN_POS指令调整按钮位置时，不同XY数值区间对应不同屏幕对齐方式，适配大分辨率屏幕布局调整，核心规则如下，所有超10000的数值需减去偏移值10000获取真实坐标：
5.1 左上对齐
X/Y数值小于5000时，以屏幕左上角为原点对齐，偏移量为原始数值本身。示例：MAIN_FUNC_BTN_POS 1 10 100，1号按钮左上角原点偏移，X右移10像素、Y下移100像素。
5.2 居中对齐
X数值5000-15000、Y数值0-3840时，以屏幕中心为原点对齐，X偏移量=X-10000。示例：MAIN_FUNC_BTN_POS 1 10050 100，1号按钮中心原点偏移，X右移50像素、Y下移100像素。
5.3 右上对齐
X数值15000-20000、Y数值0-3840时，以屏幕右上角为原点对齐，X偏移量=X-20000。示例：MAIN_FUNC_BTN_POS 1 19950 100，1号按钮右上角原点偏移，X左移50像素、Y下移100像素。
5.4 左下对齐
X数值0-3840、Y数值15000-20000时，以屏幕左下角为原点对齐，Y偏移量=Y-20000。示例：MAIN_FUNC_BTN_POS 1 100 19950，1号按钮左下角原点偏移，X右移100像素、Y上移50像素。
5.5 右下对齐
X/Y数值均15000-20000时，以屏幕右下角为原点对齐，XY偏移量均需减去20000。示例：MAIN_FUNC_BTN_POS 1 19900 19900，1号按钮右下角原点偏移，X左移100像素、Y上移100像素。
六、自定义按钮装备与图片展示配置
传奇主界面自定义按钮支持自定义图片展示、角色装备及属性可视化展示，可实现武器、时装、首饰等装备预览效果，配置规则如下：
6.1 展示参数格式
按钮标题支持换行设置，完整参数格式：标题/支持换行|图库|起始图片|数量|延时|X|Y|looks|物品ID|包观/内观:0/1
参数释义：包观对应首饰类物品展示，内观对应武器、衣服、头盔、斗笠类装备展示，0为关闭、1为开启。
6.2 装备属性展示专属配置
若需实现按钮展示装备及对应属性，除标题参数外，图库、起始图片、数量、延时、XY坐标全部设置为0，同时需固定MainWidgetCfg.ini基础参数：
Width1=36、Height1=32、Parent1=1，锁定装备展示尺寸与挂载位置，保证展示效果规整。
6.3 专属脚本指令
通过以下指令可自定义按钮标题与装备展示样式，可直接套用：
SetDlgItem 屠龙
Mov S11 <$DLGITEMSHOW>
Strtok S11 S12 &
Strtok S11 S13 =
StringReplace S11 >
StringReplace S11 <
StringReplace S11 /
Strtok S12 S14 =
LOOKS=<$Str(S12)>
物品ID=<$Str(S11)>
核心控制指令：MAIN_FUNC_BTN_CAPTION 0 标题/支持换行|图库|起始图片|数量|延时|X|Y|looks|物品ID|包观/内观:0/1
包观/内观:0/1 （包观指:首饰等物品.....内观指:武器，衣服，头盔，斗笠）
如果需要展示装备以及属性。
那么除标题外。 图库、起始图片、数量、延时、X、Y、必须全部为0
同时需要注意配置以下几个参数
MainWidgetCfg.ini配置
Width1=36
; 按钮宽(当都为0时，按钮大小随图片大小)
Height1=32
; 按钮高(当都为0时，按钮大小随图片大小)
Parent1=1
; 按钮显示人物装备位置
七、自定义按钮位置对齐速查说明
传奇主界面自定义按钮支持多方位屏幕对齐模式，依托MAIN_FUNC_BTN_POS指令搭配不同XY数值区间，可精准适配普通屏幕、高分辨率大屏界面布局，五种对齐方式适配所有排版场景，方便开发者快速调整按钮位置：
MAIN_FUNC_BTN_POS 序号 X Y // 调整按钮位置(1左上，2中心，3右上，4左下，5右下)
1、左上对齐：X/Y数值小于5000，以屏幕左上角为原点，数值即为真实偏移像素；
2、居中对齐：X数值5000-15000、Y常规数值，以屏幕中心为原点，真实X坐标=设置值-10000；
3、右上对齐：X数值15000-20000、Y常规数值，以屏幕右上角为原点，真实X坐标=设置值-20000；
4、左下对齐：X常规数值、Y数值15000-20000，以屏幕左下角为原点，真实Y坐标=设置值-20000；
5、右下对齐：X/Y数值均15000-20000，以屏幕右下角为原点，真实XY坐标=设置值-20000。
所有数值大于10000的坐标参数，均需扣除10000偏移值后，才是按钮在屏幕上的真实展示坐标，是传奇高分辨率界面微调按钮位置的核心技巧。
八、整体配置注意事项汇总
1、全局开关优先级最高，需先在!Setup.txt中开启OpenMainFuncBtns=1，自定义按钮功能才可正常生效，默认关闭状态下所有配置不生效。
2、按钮最大数量为40个，脚本触发字段、配置序号均不可超过40，超出序号配置无效。
3、Lui素材库与普通素材库不可混用，wmlib设置为Lui时仅识别Lui.pkg内部文件名，非Lui素材必须保证索引大于0。
4、装备属性展示模式下，必须清空图库、延时、数量等多余参数，全部置0，否则会出现装备预览失效、界面错位问题。
5、字体颜色三种格式可自由切换，适配不同传奇版本客户端渲染规则，避免出现字体不显示、颜色错乱情况。
6、子按钮显示状态可独立控制，支持登录默认隐藏、点击触发展示，适合做折叠式多功能按钮组。
