传奇引擎游戏面板调用脚本教程 新老NPC界面兼容配置方法
摘要：本文详解传奇引擎新老NPC界面兼容配置方法，讲解OPENHYPERLINK指令参数含义，提供全套可直接使用的脚本示例与完整版面板ID对照表，包含玩家、英雄、辅助功能面板编号，解决传奇服务端面板调用异常、界面混用报错问题。…
一、NPC界面兼容核心说明
传奇服务端开发中，新NPC界面与老旧写法界面支持双向兼容适配，核心配置规则如下：单游戏界面仅可采用一种编写方式，禁止在同一界面内混用新、老NPC界面脚本写法，否则会出现面板加载异常、按钮失效、界面卡顿等问题。
启用新NPC面板写法必填配置：登录M2引擎后台，进入【客户端控制】-【页面显示】选项，勾选【启用新NPC面板写法】，配置生效后才可正常调用全新面板脚本指令。
二、OPENHYPERLINK面板调用指令详解
2.1 指令基础格式
OPENHYPERLINK 参数1 参数2
2.2 参数释义
参数1：面板ID，对应游戏内各类功能面板专属编号，是精准调用目标界面的核心标识
参数2：面板关闭逻辑控制参数，分为两种模式
参数值1：防重复关闭模式，重复点击面板按钮不会自动关闭界面，仅可通过界面内置关闭按钮手动关闭，多用于新手引导、任务流程绑定场景
参数值2：即时关闭模式，执行指令后直接关闭当前已打开的目标面板
2.3 实战脚本示例
以下为传奇996引擎可直接复制的面板调用脚本，适配所有支持新NPC面板的服务端：
[@打开界面]
#IF
#ACT
OPENHYPERLINK 1
Sendmsg 6 打开了装备栏面板
[@任务状态打开界面]
#IF
#ACT
OPENHYPERLINK 1 1
Sendmsg 6 打开了装备栏面板
[@关闭界面]
#IF
#ACT
OPENHYPERLINK 1 2
Sendmsg 6 关闭了装备栏面板
[@强制小退]
#IF
#ACT
OPENHYPERLINK 34 1
Sendmsg 6 强制小退到角色界面
三、全功能面板ID对照表（完整版）
3.1 玩家基础面板
1：角色-装备，2：角色-状态，3：角色-属性，4：角色-技能，5：角色-称号，6：角色-首饰盒
7：背包，8：摆摊，9：商城-热销，10：商城-装饰，11：商城-功能，12：商城-节日
13：行会-主界面，14：行会-成员列表，15：行会-行会列表，16：邮件，17：组队
20：设置-保护，21：设置-拾取，22：设置-战斗，23：设置-基础，24：小地图
27：拍卖行，28：好友，30：打开创建行会界面，31：打开行会(智能打开)，32：排行榜面板
33：面对面交易面板，34：强制小退，35：九九交易行系统，37：时装界面
112 1：展开小地图（无需填写参数2，执行后自动收缩），112 2：折叠小地图（无需填写参数2，执行后自动收缩）
110：任务栏
3.2 辅助功能面板ID
及时雨辅助：2301：职业，2302：NPC，2303：挂机，2304：发言，2305：英雄，2306：帮助
复古内挂：2307：按键
专属容器面板：6100：首饰盒6格，6101：英雄首饰盒6格
3.3 英雄专属面板
41：英雄-装备，42：英雄-状态，43：英雄-属性，44：英雄-技能，45：英雄-称号
46：英雄-首饰盒，47：英雄-背包，48：英雄-时装界面
四、配置常见注意事项
第一，所有面板调用脚本必须基于M2引擎新NPC面板开关开启后使用，未开启配置会导致指令无效、面板无法弹出；
第二，112小地图专属指令无需搭配参数2，额外添加参数会造成界面逻辑错乱；
第三，英雄面板ID仅对英雄功能模块生效，不可用于玩家主界面调用；
第四，任务类面板优先使用参数2=1的防关闭模式，适配新手引导流程需求。
