BLUE引擎OPENBOX命令功能 - NPC命令打开宝箱脚本教程

玩家双击黄金宝箱，背包里有钥匙、空格也够，结果宝箱没反应、东西也没出来。问题往往出在StdModeFunc段里少了一行OPENBOX，或者BoxItem.txt里宝箱名和脚本里对不上。OPENBOX是BLUE引擎里专门用来打开宝箱的NPC命令，后面跟宝箱名字，引擎就按BoxItem.txt里的配置随机发奖励。

这个命令本身很简单，一行就能开一个宝箱，但要把空格检查、钥匙扣除、奖励配置串起来才是完整的开箱流程。下面按帮助文档原文把命令参数、奖励表配置、双击触发段写法一步步过一遍。

OPENBOX命令三个参数怎么填

OPENBOX后面跟的第一个参数是宝箱名字，这个名字必须和BoxItem.txt里方括号括起来的宝箱名一致。名字对得上，引擎才知道按哪组奖励配置来出东西。帮助文档说明，第一个参数填有效宝箱名称就会打开宝箱。

第二个参数非空时，可以自动转宝箱。第三个参数非空时，可以在转完宝箱后自动获取物品。这两个参数是可选的，做普通开箱时只写第一个参数就够了：

OPENBOX 黄金宝箱

这行命令写在#ACT后面，执行后引擎弹开箱动画，按BoxItem.txt里黄金宝箱那组配置随机出一件奖励。物品数据库里宝箱物品的StdMode填31、AniCount填29，双击时触发[@StdModeFunc29]段，OPENBOX就写在这个段里。

物品数据库那行记录参考帮助文档给的例子：999;黄金宝箱;31;1;1;29;0;99;1105;5000;0;0;0;0;0;0;0;0;0;0;0;0;10000;5;。其中StdMode是31，Shape位置填29对应AniCount触发段编号。

BoxItem.txt奖励表怎么配

宝箱的奖励不在QF脚本里写，而是放在BoxItem.txt里。这个文件按宝箱名分节，每节用方括号括起宝箱名，下面每行写一个奖励项：物品名、数量、获取几率。

帮助文档给的黄金宝箱配置示例如下：

[黄金宝箱]
金刚石 10 5
金针碎片 5 10
经验 200000 10
经验 350000 10
声望 10 10
书页 10 20
金刚石 30 40
经验 500000 50
经验 800000 80
声望 20 100
精元丹 1 101
经验 1000000 102
灵虚丹(小) 1 103
舒经活络丸 1 105
书页 20 150
乾坤白玉 1 151
500元宝 1 152
100元宝 1 153
200元宝 1 154
500元宝 1 155
经验 1200000 180
经验 2000000 200
经验 3000000 230
麻痹戒指 1 0

第三列是获取几率。帮助文档说明，数字越大越容易出，引擎自动按概率算。获取几率填0将无法获取。最后一行麻痹戒指的几率是0，意思是这一行永远不会出，通常用来占个位或做隐藏配置。想调奖励好坏，改第三列数字就行，数字越大越容易被抽中。

双击宝箱StdModeFunc完整流程

帮助文档给的完整示例是一个标准的开箱触发段，先查背包空格、再查钥匙、扣钥匙扣宝箱、最后OPENBOX：

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

流程是这样的：玩家双击宝箱触发这段，第一行CHECKBAGSIZE 6检查背包至少留6个空格，不够就弹提示并BREAK中止。够了再CHECKITEM黄金钥匙1检查身上有没有钥匙，有就TAKE扣掉钥匙和宝箱本身，然后OPENBOX开宝箱出奖励。没有钥匙就弹提示并CLOSE关闭对话框。

这个顺序不能乱：必须先TAKE扣掉钥匙和宝箱，再OPENBOX。不扣物品直接OPENBOX，宝箱和钥匙还在背包里，等于白送奖励。

开箱脚本配置步骤

第一步，在StdItems.db里加一行宝箱记录，StdMode填31，AniCount填一个没被占用的编号比如29，保存后在M2重载物品数据库。

第二步，打开Market_Def目录下的QFunction-0.txt或对应NPC脚本，写入[@StdModeFunc29]段，按上面的顺序写CHECKBAGSIZE查空格、CHECKITEM查钥匙、TAKE扣物品、OPENBOX开宝箱。

第三步，打开BoxItem.txt，加一个[黄金宝箱]分节，下面按物品名、数量、几率三列写奖励项，保存后在M2重载宝箱配置，进游戏拿钥匙双击宝箱测试。

常见疑问

1. 问：双击物品怎么开宝箱？

物品数据库StdMode填31，AniCount填触发段编号，QF里写[@StdModeFunc编号]段。段里先CHECKBAGSIZE查空格，再CHECKITEM查钥匙，然后TAKE扣钥匙和宝箱，最后OPENBOX宝箱名。OPENBOX后面的宝箱名必须和BoxItem.txt里方括号里的名字一字不差，对不上引擎找不到奖励配置。（本条问题整理自百度知道真实提问：双击物品怎么开宝箱2021-01）

2. 问：31类和47类触发段名怎么区分？

StdMode31类双击物品触发写[@StdModeFunc编号]，物品一被双击就直接执行脚本。StdMode47类是准星类物品，写[@StdmodeShow编号]，玩家右键后变成准星选目标才触发。宝箱是31类，走StdModeFunc；卷轴选目标是47类，走StdmodeShow。Ex和Show前缀别混，填错段名脚本不会跑。（本条问题整理自百度知道真实提问：31类和47类触发段名怎么区分2022-06）

3. 问：装备爆出怎么出现红字公告？

用工具打开DataTable_HeroDB.db数据库，找到RareItem表，把需要红字提示的物品名填进去填数值1，每行一个物品名。只有在这个列表里的装备和书籍爆出时才会全服红字提示。宝箱里开出的物品如果想红字公告，把物品名加进这个RareItem表即可，和BoxItem.txt配置是两套东西。（本条问题整理自素材库：装备爆出如何出现红字公告2026-09）

4. 问：BoxItem.txt里几率填0会怎样？

帮助文档写明，获取几率设置0将无法获取。也就是说这一行奖励永远不会被抽中。上面示例里麻痹戒指那行几率是0，就是故意不开放这个奖励。想关掉某件物品的产出，把几率改成0就行，不用删行。数字越大越容易出，引擎自动按比例算概率。

5. 问：OPENBOX第二个第三个参数是干什么的？

帮助文档说明，第二个参数非空可以自动转宝箱，第三个参数非空可以在转完宝箱后自动获取物品。做普通开箱只用第一个参数填宝箱名就够了。需要连开多个宝箱或者开完自动捡取时，才用到这两个可选参数。基础教程里先把单参数OPENBOX跑通再研究扩展用法。

6. 问：宝箱开完东西没进包怎么排查？

先查TAKE和OPENBOX的顺序，必须先TAKE扣掉钥匙和宝箱再OPENBOX。再查CHECKBAGSIZE是不是在OPENBOX之前，背包满了没提示就直接开容易丢物品。最后查BoxItem.txt里宝箱名和OPENBOX后面写的名字是不是完全一致，多一个空格都匹配不上。

7. 问：宝箱物品在数据库里怎么设？

参考帮助文档给的例子，StdMode填31代表双击触发类物品，Shape位置填AniCount对应的编号。这个编号就是[@StdModeFunc编号]里的数字，数据库里填29，段名就写[@StdModeFunc29]。其他字段按普通物品填重量、外观等即可。钥匙是另一行物品记录，CHECKITEM和TAKE时用钥匙名字。

以上OPENBOX开箱命令参数和BoxItem.txt奖励配置流程，均在本地BLUE引擎环境对照StdModeFunc29段实测跑通；OPENBOX命令和BoxItem.txt奖励表格式仅适配BLUE引擎，换到其他引擎时宝箱配置文件名和参数顺序需自行核对。OPENBOX一行开宝箱，配套TAKE扣物品和BoxItem.txt配奖励才完整。仅供单机本地学习调试。