传奇宝箱脚本核心用于实现单机架设中宝箱的开启、奖励发放、钥匙匹配等功能，适配所有单机常规版本，编写无需复杂语法，按固定格式填写参数即可生效。本文详细讲解宝箱脚本的核心准备、三种常用模式完整脚本、参数修改、数据库设置及调试方法，所有脚本可直接复制修改使用，覆盖钥匙开启、NPC开启、自动刷新宝箱三种高频场景，直奔主题讲解编写全流程。
一、宝箱脚本核心基础准备（单机架设通用）
编写宝箱脚本前，需完成基础准备工作，确保脚本与单机架设环境匹配、相关设置正确，避免出现宝箱无法显示、开启失效、奖励异常等问题，核心准备事项如下。
1. 确认脚本与数据库路径：单机传奇中，宝箱NPC脚本文件放在“MirServer\Mir200\Envir\NPC”文件夹内，后缀为“.txt”，文件名可自定义（如“宝箱脚本.txt”），避免中文特殊符号；宝箱相关配置文件需放在“MirServer\Mir200\Envir\Boxs”文件夹，若该文件夹不存在，可运行M2服务器后自动生成，或手动创建。
2. 确定宝箱与钥匙数据库参数：打开单机传奇怪物与物品数据库（通常为“Monster.DB”“Item.DB”），设置宝箱和钥匙的核心参数。宝箱参数需设置StdMode=31，Shape值为15-19（15=檀木宝箱，16=紫铜宝箱，17=白银宝箱，18=赤金宝箱，19=黄金宝箱），Source值与Boxs文件夹内配置文件对应；钥匙参数需设置StdMode=40，Shape值与对应宝箱的Shape值一致，确保钥匙可匹配开启对应宝箱。
3. 准备奖励物品编号：查询物品数据库，记录宝箱需发放的奖励物品编号（如金币、矿石、装备、经验等），脚本中需填写物品编号，不可填写中文名称，避免奖励发放失败；同时确认奖励物品的类型，区分可获得、不可获得、中间一格物品、永不可得四种类型，便于脚本设置。
4. 测试基础环境：编写脚本前，重启单机服务器，确认M2服务器正常运行，地图内可正常放置NPC，物品数据库无异常，避免因环境问题导致脚本编写完成后无法生效。
二、模式一：钥匙开启宝箱脚本（最常用，适配所有单机版本）
该模式为传奇宝箱最常规用法，玩家需持有对应钥匙，双击宝箱或通过NPC触发，消耗钥匙后开启宝箱，随机获得预设奖励，支持设置奖励概率、多等级宝箱区分，适合单机常规玩法，可直接复制代码修改使用。
（一）脚本核心逻辑
玩家持有对应钥匙 → 点击NPC触发开启指令（或双击宝箱） → 脚本检测玩家是否持有对应钥匙 → 检测通过，消耗钥匙，随机发放预设奖励 → 检测失败，提示玩家缺少钥匙；支持设置多种宝箱，每种宝箱对应专属钥匙和专属奖励。
（二）完整脚本代码（可直接复制修改）
;钥匙开启宝箱脚本（单机专用，多宝箱适配）
(@Main) #say 宝箱开启NPC\n可使用对应钥匙开启各类宝箱，获得丰厚奖励！\n<开启檀木宝箱/@OpenWoodBox> <开启紫铜宝箱/@OpenCopperBox> <开启白银宝箱/@OpenSilverBox> <离开/@Exit>
;檀木宝箱（Shape=15，对应木箱钥匙Shape=15）
(@OpenWoodBox) #IF checkitem 木箱钥匙 1 ;检测玩家是否持有1把木箱钥匙
#act take 木箱钥匙 1 ;消耗1把木箱钥匙
;设置檀木宝箱奖励，随机发放1种，概率可调整
random 100 ;设置随机概率基数（1-100）
#IF equal 1-30 give 金币 1000 ;30%概率获得1000金币
#IF equal 31-60 give 矿石 5 ;30%概率获得5个矿石
#IF equal 61-85 give 新手头盔 1 ;25%概率获得新手头盔（物品编号可替换）
#IF equal 86-100 give 经验(1000) 1 ;15%概率获得1000经验
sendmsg 6 恭喜！成功开启檀木宝箱，获得对应奖励！
goto @Main ;返回NPC主菜单
#ELSESAY 您没有木箱钥匙，无法开启檀木宝箱！<返回/@Main>
;紫铜宝箱（Shape=16，对应紫铜钥匙Shape=16）
(@OpenCopperBox) #IF checkitem 紫铜钥匙 1 ;检测玩家是否持有1把紫铜钥匙
#act take 紫铜钥匙 1 ;消耗1把紫铜钥匙
random 100
#IF equal 1-25 give 金币 2000 ;25%概率获得2000金币
#IF equal 26-50 give 高级矿石 3 ;25%概率获得3个高级矿石
#IF equal 51-75 give 新手手镯 1 ;25%概率获得新手手镯（物品编号可替换）
#IF equal 76-95 give 经验(2000) 1 ;20%概率获得2000经验
#IF equal 96-100 give 沃玛戒指 1 ;5%概率获得沃玛戒指（物品编号可替换）
sendmsg 6 恭喜！成功开启紫铜宝箱，获得对应奖励！
goto @Main
#ELSESAY 您没有紫铜钥匙，无法开启紫铜宝箱！<返回/@Main>
;白银宝箱（Shape=17，对应白银钥匙Shape=17）
(@OpenSilverBox) #IF checkitem 白银钥匙 1 ;检测玩家是否持有1把白银钥匙
#act take 白银钥匙 1 ;消耗1把白银钥匙
random 100
#IF equal 1-20 give 金币 5000 ;20%概率获得5000金币
#IF equal 21-40 give 强化石 2 ;20%概率获得2个强化石
#IF equal 41-65 give 沃玛手镯 1 ;25%概率获得沃玛手镯（物品编号可替换）
#IF equal 66-85 give 经验(5000) 1 ;20%概率获得5000经验
#IF equal 86-100 give 祖玛项链 1 ;15%概率获得祖玛项链（物品编号可替换）
sendmsg 6 恭喜！成功开启白银宝箱，获得对应奖励！
goto @Main
#ELSESAY 您没有白银钥匙，无法开启白银宝箱！<返回/@Main>
(@Exit) #act close ;关闭NPC对话框
（三）脚本参数修改说明（关键必看）
1. 钥匙与宝箱匹配修改：“checkitem 木箱钥匙 1”中的“木箱钥匙”需改为实际钥匙名称，与物品数据库中钥匙名称一致；钥匙数量“1”可修改，如设置为2，即需消耗2把钥匙开启宝箱；同时确保钥匙的Shape值与对应宝箱的Shape值一致，否则无法匹配开启。
2. 奖励参数修改：“give 金币 1000”中，“金币”为物品名称（可替换为其他物品，如“矿石”“装备”），“1000”为物品数量，可根据需求调整；经验奖励需填写“经验(数值)”格式，如“经验(3000)”，不可遗漏括号。
3. 奖励概率修改：“random 100”为概率基数，无需修改；“equal 1-30”代表30%概率，可调整数值范围，如“1-40”代表40%概率，所有概率范围总和需为100，避免出现概率重叠或空缺。
4. 多宝箱拓展：可按照上述格式，添加赤金宝箱、黄金宝箱脚本，只需修改钥匙名称、奖励物品及概率，同时在数据库中设置对应宝箱和钥匙的Shape值、Source值。
（四）实操注意事项
1. 数据库参数必设：宝箱和钥匙的StdMode值不可修改（宝箱31、钥匙40），Shape值需对应匹配，否则钥匙无法开启宝箱；Source值需与Boxs文件夹内配置文件的数值对应，确保宝箱正常显示。
2. 物品名称一致性：脚本中钥匙、奖励物品的名称，需与物品数据库中完全一致，不可出现错别字、空格，否则脚本无法检测物品、发放奖励。
3. 概率设置合理：避免将高阶装备（如祖玛、沃玛装备）的概率设置过高，贴合单机游戏平衡，同时确保所有奖励概率总和为100，避免出现无奖励的情况。
二、模式二：NPC直接开启宝箱脚本（无需钥匙，消耗金币/元宝）
该模式无需钥匙，玩家通过点击NPC，消耗指定数量的金币或元宝即可开启宝箱，适合单机休闲玩法，可设置单次开启、多次开启，支持累增消费和奖励升级，操作简单，新手可快速上手。
（一）脚本核心逻辑
玩家点击NPC → 选择开启宝箱次数 → 脚本检测玩家金币/元宝数量 → 检测通过，消耗对应金币/元宝，开启宝箱并发放奖励 → 检测失败，提示玩家金币/元宝不足；支持多次开启，消费金额可累增，消费达到一定数额可解锁高阶奖励。
（二）完整脚本代码（可直接复制修改）
;NPC直接开启宝箱脚本（单机专用，无钥匙，消耗金币/元宝）
(@Main) #say 无钥匙宝箱NPC\n消耗金币即可开启宝箱，开启次数越多，奖励越丰厚！\n<开启1次(消耗1000金币)/@Open1> <开启3次(消耗2800金币)/@Open3> <开启5次(消耗4500金币)/@Open5> <离开/@Exit>
;开启1次宝箱（基础消费）
(@Open1) #IF checkgold 1000 ;检测玩家是否有1000金币
#act take 金币 1000 ;消耗1000金币
;基础奖励设置，随机发放1种
random 100
#IF equal 1-40 give 金币 500 ;40%概率获得500金币
#IF equal 41-70 give 矿石 4 ;30%概率获得4个矿石
#IF equal 71-90 give 新手装备 1 ;20%概率获得新手装备（物品编号可替换）
#IF equal 91-100 give 经验(1500) 1 ;10%概率获得1500经验
sendmsg 6 恭喜！消耗1000金币开启宝箱，获得对应奖励！
goto @Main
#ELSESAY 您的金币不足1000，无法开启宝箱！<返回/@Main>
;开启3次宝箱（优惠消费，累增奖励）
(@Open3) #IF checkgold 2800 ;检测玩家是否有2800金币（单次1000，3次优惠200）
#act take 金币 2800 ;消耗2800金币
sendmsg 6 恭喜！消耗2800金币开启3次宝箱，奖励已发放！
;3次奖励，每次随机发放，可叠加获得
random 100
#IF equal 1-35 give 金币 800 ;35%概率获得800金币
#IF equal 36-65 give 高级矿石 2 ;30%概率获得2个高级矿石
#IF equal 66-85 give 沃玛首饰 1 ;20%概率获得沃玛首饰（物品编号可替换）
#IF equal 86-100 give 经验(3000) 1 ;15%概率获得3000经验
random 100
#IF equal 1-35 give 金币 800
#IF equal 36-65 give 高级矿石 2
#IF equal 66-85 give 沃玛首饰 1
#IF equal 86-100 give 经验(3000) 1
random 100
#IF equal 1-35 give 金币 800
#IF equal 36-65 give 高级矿石 2
#IF equal 66-85 give 沃玛首饰 1
#IF equal 86-100 give 经验(3000) 1
goto @Main
#ELSESAY 您的金币不足2800，无法开启3次宝箱！<返回/@Main>
;开启5次宝箱（最优消费，解锁高阶奖励）
(@Open5) #IF checkgold 4500 ;检测玩家是否有4500金币（单次1000，5次优惠500）
#act take 金币 4500 ;消耗4500金币
sendmsg 6 恭喜！消耗4500金币开启5次宝箱，解锁高阶奖励！
;5次奖励，包含高阶装备，每次随机发放
;循环5次发放奖励，简化脚本写法
mov D0 5 ;设置循环次数为5次（D0为变量，不可修改）
(@LoopOpen) #IF big D0 0
#act random 100
#IF equal 1-30 give 金币 1000 ;30%概率获得1000金币
#IF equal 31-55 give 强化石 1 ;25%概率获得1个强化石
#IF equal 56-75 give 沃玛装备 1 ;20%概率获得沃玛装备（物品编号可替换）
#IF equal 76-95 give 经验(5000) 1 ;20%概率获得5000经验
#IF equal 96-100 give 祖玛装备 1 ;5%概率获得祖玛装备（物品编号可替换）
sub D0 1 ;循环次数减1
goto @LoopOpen ;继续循环，直至5次完成
#ELSEACT goto @Main ;循环完成，返回主菜单
#ELSESAY 您的金币不足4500，无法开启5次宝箱！<返回/@Main>
(@Exit) #act close
（三）脚本参数修改说明（关键必看）
1. 消费金额修改：“checkgold 1000”中的“1000”为开启1次的金币消耗，可修改为元宝（需将“checkgold”改为“checkyuanbao”，“take 金币”改为“take 元宝”），如“checkyuanbao 5”即消耗5元宝开启1次。
2. 开启次数与优惠设置：可修改开启次数（如1次、3次、5次），同时调整对应消费金额，优惠力度可自定义，如开启3次原本需3000金币，可设置为2800金币，提升玩家开启意愿。
3. 循环奖励修改：“mov D0 5”中的“5”为循环次数，对应开启5次，可修改为其他次数（如2次、10次）；循环内的奖励可调整，开启次数越多，可适当提高高阶奖励的概率。
4. 高阶奖励解锁：可在多次开启脚本中，添加“消费达标解锁奖励”，如开启5次后，额外发放1个稀有材料，命令为“#act give 稀有材料 1”，添加在循环完成后即可。
（四）实操注意事项
1. 消费类型区分：脚本中“checkgold”对应金币，“checkyuanbao”对应元宝，不可混淆，否则无法检测玩家消费道具；同时确保玩家背包中有足够的消费道具，避免出现检测异常。
2. 循环变量不可改：脚本中的D0为循环变量，用于控制开启次数，不可随意修改变量名称（如改为D1、D2），否则循环无法正常执行，奖励发放异常。
3. 避免奖励叠加异常：多次开启时，循环奖励需确保每次随机独立，不可出现多次奖励叠加为1次的情况，可通过检查循环命令的语法，确保循环正常执行。
三、模式三：地图自动刷新宝箱脚本（单机专属，自动生成）
该模式无需玩家触发，脚本自动在指定地图、指定坐标范围刷新宝箱，玩家靠近后可点击开启（支持钥匙开启或无钥匙开启），刷新间隔可自定义，适合单机地图挂机、探索玩法，增加游戏趣味性。
（一）脚本核心逻辑
脚本启动 → 自动在指定地图、指定坐标范围刷新宝箱 → 玩家开启宝箱后，脚本检测宝箱是否被开启 → 宝箱被开启后，间隔指定时间自动刷新新的宝箱 → 循环执行，可设置刷新数量、刷新间隔，支持多地图同时刷新。
（二）完整脚本代码（可直接复制修改）
;地图自动刷新宝箱脚本（单机专用，钥匙开启型）
(@Main) #say 自动刷新宝箱地图\n地图内将每10分钟自动刷新宝箱，需持有对应钥匙开启！\n<进入刷新地图/@EnterMap> <离开/@Exit>
(@EnterMap) #act mapmove 宝箱刷新地图 320 330 ;传送玩家至指定刷新地图（坐标可修改）
sendmsg 6 已进入宝箱刷新地图，每10分钟自动刷新3只檀木宝箱！
Delaygoto (Grobal) 5 @RefreshChest ;延迟5秒，触发首次刷新
(@RefreshChest) #act ;刷新3只檀木宝箱，坐标范围300,300至350,350（可修改）
MonGen 宝箱 3 0 300 300 350 350 ;宝箱编号需与数据库一致，3为数量，0为不重复刷新
sendmsg 6 宝箱已刷新！请前往拾取开启（需持有木箱钥匙）！
Delaygoto (Grobal) 600 @CheckChest ;延迟10分钟（600秒），检测宝箱是否被开启
(@CheckChest) #IF checkmonmap 宝箱刷新地图 0 ;检测地图内宝箱数量是否为0（全部被开启）
#act sendmsg 6 所有宝箱已被开启，10分钟后将再次刷新！
Delaygoto (Grobal) 600 @RefreshChest ;延迟10分钟，刷新下一批宝箱
#ELSEACT Delaygoto (Grobal) 60 @CheckChest ;宝箱未全部开启，每1分钟检测一次
;宝箱开启子脚本（与模式一钥匙开启逻辑一致）
(@OpenChest) #IF checkitem 木箱钥匙 1
#act take 木箱钥匙 1
random 100
#IF equal 1-30 give 金币 1500
#IF equal 31-60 give 矿石 6
#IF equal 61-85 give 新手装备 1
#IF equal 86-100 give 经验(2000) 1
sendmsg 6 恭喜！成功开启自动刷新宝箱，获得对应奖励！
goto @Main
#ELSESAY 您没有木箱钥匙，无法开启宝箱！<返回/@Main>
(@Exit) #act mapmove 比奇城 320 330 ;传送玩家返回主城（可修改）
close
（三）脚本参数修改说明（关键必看）
1. 刷新地图与坐标修改：“宝箱刷新地图”改为实际单机地图名称，“320 330”为玩家传送坐标，“300,300至350,350”为宝箱刷新坐标范围，可修改为其他坐标，确保坐标在地图可站立区域，避免刷新在障碍物上。
2. 刷新参数修改：“MonGen 宝箱 3 0 ...”中，“宝箱”为宝箱名称（与数据库一致），“3”为每次刷新数量，可修改为1、5等；“600”为刷新间隔（单位：秒），600秒=10分钟，可修改为300秒（5分钟）、900秒（15分钟）。
3. 宝箱类型修改：可将“檀木宝箱”替换为紫铜、白银等其他宝箱，同时修改对应的钥匙检测命令，确保玩家需持有对应钥匙才能开启，也可修改为无钥匙开启，删除钥匙检测相关命令即可。
4. 多地图刷新：可添加多个刷新地图，复制“(@RefreshChest)”“(@CheckChest)”脚本，修改地图名称、坐标范围和刷新参数，实现多地图同时自动刷新宝箱。
（四）实操注意事项
1. 宝箱编号与数据库一致：脚本中“MonGen 宝箱 3 0 ...”中的“宝箱”需与数据库中宝箱名称完全一致，或填写宝箱编号，否则无法刷新出宝箱。
2. 刷新间隔合理：避免将刷新间隔设置过短（如30秒），导致地图内宝箱堆积，影响游戏体验；也不可设置过长，导致玩家等待时间过久，建议设置5-15分钟。
3. 检测间隔调整：“Delaygoto (Grobal) 60 @CheckChest”中的60秒（1分钟）为宝箱检测间隔，可修改为30秒、120秒，数值越小，检测越频繁，宝箱刷新衔接越流畅。
四、宝箱脚本通用数据库设置（必做步骤）
无论哪种模式的宝箱脚本，都需完成数据库设置，否则宝箱无法正常显示、开启，核心设置步骤如下，适配所有单机常规版本。
1. 宝箱数据库设置：打开物品数据库（Item.DB），新增宝箱物品，核心参数设置如下（以檀木宝箱为例）：name=檀木宝箱，StdMode=31，Shape=15，Source=0（与Boxs文件夹内0.txt对应），其他参数按默认设置，确保宝箱可正常在游戏内显示。
2. 钥匙数据库设置：新增钥匙物品，核心参数设置如下（以木箱钥匙为例）：name=木箱钥匙，StdMode=40，Shape=15（与檀木宝箱Shape值一致），其他参数按默认设置，确保钥匙可匹配开启对应宝箱。
3. Boxs文件夹配置：在“MirServer\Mir200\Envir\Boxs”文件夹内，创建BoxsList.txt文件，填写连续数值（如0、1、2），每个数值对应一个宝箱配置文件；再创建对应数值的txt文件（如0.txt），填写宝箱奖励配置，第一行为宝箱基础设置（是否多次开启、消费参数等），第二行开始为奖励物品设置。
4. 数据库保存与生效：修改完成后，保存数据库文件，重启单机服务器，确保数据库设置生效，否则宝箱和钥匙无法正常生成、使用。
五、宝箱脚本调试与异常排查方法
脚本编写完成后，需按以下方法调试，排查异常问题，确保宝箱脚本正常运行，避免出现开启失效、奖励异常、刷新失败等问题。
1. 脚本格式检查：打开脚本文件，检查所有命令格式是否正确，如“#say”“#act”“#IF”后是否有空格，“random”“checkitem”“MonGen”等命令是否拼写正确，标点符号是否使用英文标点（中文标点会导致脚本失效）。
2. 基础功能调试：重启单机服务器，进入游戏，找到宝箱NPC，点击NPC查看是否有正常菜单；触发开启指令，检查钥匙消耗、金币/元宝消耗是否正常，奖励是否能正常发放；自动刷新模式需检查宝箱是否能按时刷新。
3. 异常问题排查：
（1）宝箱无法显示：检查数据库中宝箱的StdMode、Shape、Source参数是否正确，Boxs文件夹内配置文件是否齐全，脚本中宝箱名称与数据库是否一致。
（2）无法开启宝箱：检查钥匙与宝箱的Shape值是否匹配，脚本中钥匙检测命令是否正确，玩家是否持有对应钥匙或足够的金币/元宝。
（3）奖励发放异常：检查脚本中奖励物品名称、编号是否与数据库一致，奖励概率设置是否合理，循环奖励的变量是否正确。
（4）自动刷新失败：检查脚本中地图名称、坐标范围是否正确，刷新间隔、检测间隔参数是否有误，M2服务器是否正常运行。
4. 个性化调整：根据自身单机架设版本，调整宝箱奖励、开启条件、刷新间隔，可添加多等级宝箱、高阶奖励，也可设置开启宝箱的等级限制（如“#IF checklevel 20 #act goto @OpenWoodBox #ELSESAY 等级不足20级，无法开启宝箱！”）。
六、宝箱脚本拓展技巧（单机专属）
1. 增加奖励分级：按宝箱等级区分奖励，檀木宝箱发放基础奖励，黄金宝箱发放高阶奖励，同时提高高阶宝箱的开启难度（如消耗多把钥匙、更多金币），提升游戏可玩性。
2. 添加宝箱特效：在脚本中添加开启特效命令，如“#act effect 20 1”（20为特效编号），开启宝箱时显示对应特效，增强游戏视觉体验。
3. 设置宝箱限时开启：添加时间检测命令，如“#IF time 12:00-14:00 #act goto @OpenWoodBox #ELSESAY 宝箱开启时间为12:00-14:00，请按时开启！”，限制宝箱开启时间。
4. 区分角色职业奖励：根据玩家职业发放对应奖励，如战士获得攻击类装备，法师获得魔法类装备，命令为“#IF checkjob 战士 #act give 战士装备 1 #ELSEIF checkjob 法师 #act give 法师装备 1”。
以上三种传奇宝箱脚本，覆盖钥匙开启、NPC无钥匙开启、地图自动刷新三种高频场景，适配所有单机常规版本，脚本编写简洁，无多余语法，新手也可快速上手。所有脚本可直接复制修改，结合数据库设置和调试方法，即可实现稳定运行，满足单机游戏中宝箱玩法的各类需求，丰富游戏内容，提升玩家体验。编写过程中只需注意参数一致性、命令格式正确，即可避免大部分异常问题，无需复杂操作。
