传奇引擎气泡引导功能完整教程 新增删除回调脚本代码详解
本文详解传奇引擎气泡引导功能，讲解Addbutshow新增、Delbutshow删除指令参数，提供可直接复制的QFunction-0.txt成品脚本，包含跳转触发、多参数回调案例，适配传奇996引擎，助力传奇版本新手引导功能开发。…
在传奇版本定制、NPC交互、玩家引导功能开发中，气泡引导功能是提升游戏交互体验、优化新手引导逻辑的核心脚本功能。该功能支持自定义气泡按钮创建、指定ID删除、跳转触发、数据回调等核心能力，广泛应用于新手任务引导、功能按钮悬浮提示、专属入口弹窗提示等场景。本文详细讲解传奇服务端气泡引导功能的语法参数、完整脚本案例及回调逻辑，可直接复制用于996传奇引擎QFunction-0.txt脚本开发。
一、传奇气泡引导功能核心语法说明
传奇气泡引导功能分为新增气泡、删除气泡两大核心指令，内置专属参数配置体系，无需额外插件，原生引擎直接支持，参数配置简单、兼容性强。
1.1 新增气泡指令语法
指令格式：Addbutshow 参数1 参数2 参数3
参数详解：
参数1：气泡唯一ID，自定义数字编号，用于区分不同气泡控件，删除气泡时需对应调用
参数2：气泡显示名称，玩家客户端可见的气泡按钮文字内容
参数3：触发指令，支持跳转QF脚本及回调功能，是实现交互逻辑的核心
1.2 删除气泡指令语法
指令格式：Delbutshow ID
功能说明：通过指定气泡唯一ID，精准删除已创建的悬浮气泡按钮，避免界面气泡重叠、冗余显示，常用于任务完成后清除引导提示。
1.3 跳转与回调规则
参数3内置@跳转QF触发机制，原生支持多参数回调能力。回调格式固定为【@回调标识,参数1,参数2,参数3】，脚本中可通过<$ParamX>调用回调数据，实现动态传值、差异化引导等高级功能。
二、基础气泡引导脚本案例 可直接复制
以下为最简可用的新增、删除气泡脚本，适配所有支持Addbutshow指令的传奇引擎，写入QFunction-0.txt即可生效。
2.1 基础新增气泡脚本
[@增加气泡]
#IF
#ACT
AddbutShow 1 测试气泡 @跳转QF
2.2 带回调参数的气泡创建脚本
[@气泡引导]
#act
AddbutShow 1 测试气泡测试气泡测试气泡 @气泡引导回调,aaa,bbb,ccccc
三、QFunction-0.txt完整功能脚本配置
将以下全套脚本写入服务端QFunction-0.txt文件，即可实现气泡创建、点击跳转、气泡删除、参数回调全流程功能，是版本制作中最常用的成品配置方案。
[@跳转QF]
#IF
#act
mapmove 3 333 333
OPENHYPERLINK 16
SENDMSG 6 你的气泡触发成功
[@删除气泡]
#IF
#ACT
DelbutShow 1
SENDMSG 6 你的气泡删除成功
[@气泡引导回调]
#act
sendmsg 6 气泡回调Param1=<$Param1>
sendmsg 6 气泡回调Param2=<$Param2>
sendmsg 6 气泡回调Param3=<$Param3>
四、功能应用场景与开发注意事项
4.1 主流应用场景
新手玩家上线引导：创建专属气泡提示新手地图、基础功能入口；活动限时提示：定时生成活动气泡，过期后调用删除指令清除；NPC交互拓展：依托回调参数，实现不同玩家点击气泡触发差异化奖励、传送逻辑。
4.2 开发避坑要点
气泡ID不可重复：同场景下重复ID会覆盖原有气泡，建议按功能模块分段编号；回调参数固定三位：最多支持三组自定义参数，调用时严格对应Param1-Param3变量；引擎兼容性：仅996引擎原生支持，小众引擎需核对指令库。
五、总结
传奇气泡引导功能凭借无插件、配置简单、支持回调的优势，成为版本开发中界面交互优化的核心工具。掌握Addbutshow和Delbutshow指令的参数配置、回调逻辑，结合本文成品脚本，可快速落地新手引导、活动提示等功能，提升传奇版本的玩家交互体验和版本精致度。
