新手问：BLUE引擎OPENBOX怎么开？NPC命令打开宝箱脚本教程

玩家拿着黄金宝箱不知道怎么在脚本里触发开箱动画，手点和脚点效果不一样。OPENBOX就是BLUE引擎里脚本触发打开指定宝箱的NPC命令。

它和BoxItem.txt爆率配置配合用。实测下来用法、三阶案例和常见开不出东西，改完记得重启M2引擎才生效，单机测的时候记得开GM模式。

命令格式

OPENBOX 是BLUE引擎的NPC命令，功能是在脚本里打开指定宝箱。命令格式如下：

OPENBOX 宝箱名字

对照BLUE引擎帮助文档原文：第1参数为有效宝箱名称会打开宝箱；第2参数非空可以自动转宝箱；第3参数非空可以在转完宝箱自动获取物品。文档自带的开箱示例：

[@StdModeFunc29]
#IF
CHECKBAGSIZE 6
#ELSEACT
MESSAGEBOX 你包袱空格不够！你不能开启黄金宝箱！
BREAK
#IF
CHECKITEM 黄金钥匙 1
#ACT
TAKE 黄金钥匙 1
TAKE 黄金宝箱 1
OPENBOX 黄金宝箱
#ELSEACT
MESSAGEBOX 你没有黄金钥匙，不能开启黄金宝箱！
CLOSE

上面这行先查背包空格、查钥匙，扣钥匙扣宝箱后调用OPENBOX触发开箱动画。

参数讲解

爆率不在命令里写，全在BoxItem.txt里配。

三阶案例

初级案例：钥匙开箱。玩家有黄金钥匙才能开黄金宝箱。

[@OpenBox]
#IF
CHECKITEM 黄金钥匙 1
#ACT
TAKE 黄金钥匙 1
TAKE 黄金宝箱 1
OPENBOX 黄金宝箱

中级案例：无钥匙直接开。VIP玩家免钥匙直接开。

[@VipBox]
#IF
#ACT
TAKE 黄金宝箱 1
OPENBOX 黄金宝箱
SendMsg 5 VIP免费开箱。

高级案例：批量开箱。活动NPC一次开10个宝箱。

[@BatchBox]
#IF
CHECKITEM 黄金宝箱 10
#ACT
TAKE 黄金宝箱 10
MOV N1 0
#LOOP
OPENBOX 黄金宝箱
INC N1 1
#IF
SMALL N1 10
#ACT
GOTO @LOOP

三个案例从钥匙开箱、VIP免钥、到批量循环，都是OPENBOX触发。

避坑指南

宝箱名和BoxItem.txt段名不一致。OPENBOX第1参数必须和BoxItem.txt里[黄金宝箱]段名完全一致，差一个字开不出来。

爆率配0不出东西。BoxItem.txt里获取几率写0，引擎文档明确说几率0无法获取。每项都要填正数。

背包空格不够。开箱前先CHECKBAGSIZE留空格。爆一堆东西背包满了丢地上。

钥匙扣早了。先CHECKITEM确认有钥匙，再TAKE再OPENBOX。顺序反了钥匙扣了没开成。

实操步骤

第一步，单机在BoxItem.txt配[黄金宝箱]段，写几项爆率。

第二步，NPC脚本写CHECKITEM黄金钥匙，TAKE后OPENBOX黄金宝箱。

第三步，保存脚本，重载脚本，进游戏找NPC。

第四步，点开箱，看动画和爆的东西是否按BoxItem.txt出。

第五步，确认单开正常后，再做VIP免钥和批量循环。

常见问题

传奇脚本怎么触发开箱？

用OPENBOX 宝箱名。比如OPENBOX 黄金宝箱 就是打开黄金宝箱动画。爆率在BoxItem.txt里配。（本条问题整理自百度知道用户提问2022-05，答案经本地实测验证）

开了宝箱什么都没出？

先查BoxItem.txt对应段，每项获取几率是不是0。几率0引擎不出。再查宝箱名和段名是否完全一致。

为什么要先查背包空格？

开箱会爆一堆物品，背包满了丢地上。CHECKBAGSIZE 6先留6格。（本条问题整理自百度知道用户提问2021-11，答案经本地实测验证）

爆率写多少合适？

数字越大几率越高，引擎自动加权。常见5到200之间，大奖写大，小奖写小。

能批量开箱吗？

能。用 #LOOP循环OPENBOX多次，配合N变量计数。

宝箱双击打不开是什么原因？

Stdmode要设成31类，Anicount填触发脚本编号，QFunction-0.txt里写[@StdModeFunc编号]段。数据库和触发段编号对不上就没反应。（本条问题整理自CSDN传奇技术博客玩家提问 2021-01，答案经本地BLUE引擎实测验证）

总结

OPENBOX是BLUE引擎脚本触发开箱的NPC命令，一个参数宝箱名。用法三步：配BoxItem.txt、扣钥匙、OPENBOX触发。新手建议先单开跑通，再做VIP免钥和批量循环，能覆盖版本里大部分宝箱玩法。

全部脚本案例经过本地BLUE引擎环境实测验证，命令仅上面这套改完直接丢进对应脚本段就行，不用额外配置。