传奇BLUE引擎全套历史NPC命令大全 脚本功能用法详解
在传奇版本搭建、脚本修改、功能开发的过程中，BLUE引擎NPC命令是开发者必备的核心工具。熟练掌握各类BLUE引擎脚本命令，能够快速实现人物属性修改、挂机功能、装备操作、怪物刷新、地图特效、状态buff设置等各类自定义功能，是传奇私服运维、版本优化、功能拓展的核心基础。本文整理汇总了最全的BLUE引…
在传奇版本搭建、脚本修改、功能开发的过程中，BLUE引擎NPC命令是开发者必备的核心工具。熟练掌握各类BLUE引擎脚本命令，能够快速实现人物属性修改、挂机功能、装备操作、怪物刷新、地图特效、状态buff设置等各类自定义功能，是传奇私服运维、版本优化、功能拓展的核心基础。本文整理汇总了最全的BLUE引擎NPC历史命令、实用脚本案例及详细用法，方便传奇技术人员直接参考使用。
一、BLUE引擎基础人物功能NPC命令
此类命令主要针对传奇人物基础状态、装备穿戴、英雄操控、经验获取、离线挂机等基础功能，是版本制作中使用频率最高的核心命令，适配绝大多数传奇单职业、合击、连击版本。
TAKEON //自动穿装备
CREATEHEROEX //申请多英雄
RECALLHERO //召唤英雄，参数不为空时回收英雄
SETAUTOGETEXP //自动在线泡经验
SETOFFLINEPLAY ON //开启下线安全区自动脱机功能
SETOFFLINEPLAY OFF //关闭下线安全区自动脱机功能
SETOFFLINEFUNC //设置人物上线自动挂机涨经验
OFFLINEPLAYEX //设置人物离线挂机打怪
KILLMONEXPRATE //设置人物杀怪经验倍数
KILLMONGETFULLEXP //高等级杀怪获取全部经验时间
REPAIRALL //特修人物所有装备
LOCKDOWN 1 //锁定人物，不可攻击、移动、释放魔法，LOCKDOWN 0为解锁状态
ENABLECHARACTER //角色名 0/1，0为禁用角色，1为启用角色
GETPOSENAME //获取对面人物名称
二、BLUE引擎延迟移动与批量操作命令
该系列命令主要用于实现脚本延迟执行、人物延时移动、批量地图跳转等功能，常用于副本传送、活动延时开启、地图随机点位跳转等传奇脚本场景。
BATCHDELAY //设置人物秒延迟，作为ADDBATCH延迟时长参数
ADDBATCH //按照前一条BATCHDELAY设置的延迟时长，执行飞地图操作
BATCHMOVE //基于延迟配置，随机跳转至预设地图点位
DELAYGOTO S LABEL //脚本延时跳转，延时指定秒数后执行对应标签内容
DELAYCALL S LABEL //脚本延时调用，延时指定秒数后调用对应标签功能
三、BLUE引擎人物属性与外观修改命令
针对传奇人物攻防属性、血量蓝量、职业倍率、外观样式、名称颜色等个性化设置，可实现属性翻倍、外观自定义、职业强化等特色版本功能。
STATUSRATE //设置人物属性翻倍，支持小数点数值（例：1.2），对应属性：0防御力、1魔御力、2攻击力、3魔法力、4道术、5HP、6MP
POWERRATE //设置人物职业核心属性倍率，包含攻击、魔法、道术倍数调整
HAIRSTYLE 0/1 //自定义人物发型样式
CHANGENAMECOLOR //修改人物名称颜色
NAMECOLOR 0/1 //开启人物名字自动变色功能，需在M2功能设置-转生系统中勾选自动变色选项
四、BLUE引擎定时器与穿透功能命令
定时器命令用于脚本定时触发功能，穿透命令可优化地图人物走位体验，广泛应用于定时活动、技能计时、地图通行优化等场景。
SETSCTIMER ID(0-20) //设置人物个人专属定时器，ID区间0-20
KILLSCTIMER ID(0-20) //停止对应ID的人物个人定时器
THROUGHHUMMS //开启人物穿人穿怪功能，优化地图拥堵走位问题
五、BLUE引擎装备绑定与解绑命令
装备绑定解绑是传奇版本防复制、道具保值的核心功能，该系列命令可实现装备绑定检测、状态执行、弹窗提示等全套道具管理功能。
QUERYBINDITEM 0 //弹出道具绑定窗口
QUERYBINDITEM 1 //弹出道具解绑窗口
RESUMEBINDITEM //允许继续执行道具绑定操作
RESUMEUNBINDITEM //允许继续执行道具解绑操作
[@ITEMBINDING] //道具绑定前专属检测脚本段
[@ITEMUNBINDING] //道具解绑前专属检测脚本段
[@ITEMBINDED] //道具绑定成功后触发脚本段
[@ITEMUNBINDED] //道具解绑成功后触发脚本段
六、BLUE引擎装备升级与外观特效命令
支持装备属性升级、神秘属性单独强化、装备光效修改、装备外观替换等功能，适配连击、合击版本的装备定制化开发需求。
REFITEMSHAPE //可设置装备光效与外观，参数2为-1时忽略更改，第三个数字参数可自定义装备光效，支持引用同类型物品外观，适配衣服、武器两类装备，仅连击合击版本支持
UpgradeItem //装备升级命令，第5参数设为99时仅升级神秘属性、忽略普通属性，支持自定义鉴定属性配置
UpgradeItemEx //进阶装备升级命令，支持批量修改装备普通属性，可精准定位属性位置与数值，升级成功率不受常规参数限制
UpgradeDlgItem //弹窗式装备升级命令，参数配置规则同UpgradeItem，支持单独强化神秘属性
七、BLUE引擎道具拾取与回收命令
涵盖道具精准回收、仓库道具回收、宠物自动拾取等功能，常用于版本回收系统、挂机拾取系统的脚本搭建。
TAKE //批量回收指定道具，支持设置是否忽略极品装备、是否回收仓库道具，可自定义多道具批量回收规则
PETPICKUPITEMRANGE //设置宠物自动拾取范围，支持英雄、自身、全体宠物差异化配置，范围0为关闭拾取功能，适配挂机系统
八、BLUE引擎文本读写与字符串处理命令
用于脚本文本数据读取、写入、删除，以及字符串长度获取、内容捕获、随机读取等数据处理功能，适配概率活动、记录存档、随机奖励等场景。
READRANDOMSTR //从指定文件随机读取一行内容至变量，支持权重概率配置，权重数值越大获取概率越高，总权重不超21亿
READRANDOMLINE //从指定文件随机读取一行内容至变量
ADDLINELIST //在ENVIR目录指定文件中写入文本行
DELLINELIST //删除ENVIR目录指定文件中的指定文本行
GETSTRLENGTH //获取指定字符串字符长度并存入对应变量
STRCAP S1 S2 //捕获字符串括号内内容并赋值新变量，拆分原始字符串内容
九、BLUE引擎假人与挂机控制命令
支持假人加载、踢出、随机技能释放，以及客户端全局挂机功能开关控制，适配服务器人气优化、假人系统、全民挂机活动。
FAKEPLAYER 0/1 //0为踢出地图假人，1为加载生成假人
RANDSERIESSKILL //随机释放连击技能，主要适配假人AI脚本
CLIENTFEATURES //客户端挂机功能控制，支持全局、单地图、单角色启停挂机
十、BLUE引擎合击与数值计算命令
专属合击版本核心命令，支持合击怒气、威力倍率调整，以及脚本数值四则运算、时间计算，适配合击版本属性定制、活动数值判定。
CALCVAL //数值四则运算与时间计算，结果自动存入指定变量，支持时间秒级增减计算
UNITYENERGY //修改人物合击怒气值，支持增减赋值操作
UNITYPOWERRATE //调整合击威力倍率，百分比计算，默认数值100，可实时调取当前倍率数值
十一、BLUE引擎人物状态BUFF命令
MAKEPOISON是传奇核心状态命令，可实现16种人物、怪物状态效果，包含毒系、控制、增益、减益等各类buff，适配技能系统、buff活动、特效状态定制。
MAKEPOISON //生物状态系统命令，支持状态添加与清除，16类状态详解：0绿毒、1红毒、2人物变色、3雷击、4冰冻、5石化、6禁锢、7重伤、8隐身、9战甲术、10幽灵盾、11魔法盾、12四级魔法盾、13神龙附身、14龙化、15滴血、16诅咒
十二、BLUE引擎地图特效与守护点命令
可实现地图光圈特效刷新、删除，自定义地图守护点位与范围，常用于地图安全区设置、活动特效、定点守护机制。
MAP $CURRENTMAP //读取当前地图随机守护点位，需搭配守护点命令使用
GUARDPOS $CURRENTX $CURRENTY 30 //设置地图守护点位与范围，X参数设为-1可取消守护
MOBFIREBURN //刷新地图光圈特效，自定义地图坐标、特效类型、持续时间、伤害数值
DELFIREBURN //删除地图已生成的光圈特效
十三、BLUE引擎其他实用拓展命令
包含验证码验证、摆摊物品检索、怪物批量生成等拓展功能，适配高端版本功能开发。
CLICKNPC //支持点击摆摊角色名称交互
SEARCHONSALEITEM //检索摆摊指定物品，按价格排序返回对应数量，自动推送提示信息
VERIFYKEYCODE //两步验证码验证命令，适配账号安全、功能权限验证场景
QUERYVALUE //适配任务系统数值查询，支持专属场景参数配置
MONGENEX //批量生成自定义怪物，支持地图、坐标、数量、内功属性、名称颜色定制
十四、BLUE引擎经典实用脚本案例
1、全局自动挂机开关脚本
该脚本可一键控制服务器所有角色挂机功能启停，仅需引擎开启挂机权限即可生效。
#IF
TRUE
#ACT
CLIENTFEATURES 1
#ELSEACT
CLIENTFEATURES 0
2、装备展示弹窗脚本
实现主流传奇神器弹窗展示功能，可自定义展示装备列表，适配装备鉴赏、排行榜系统。
[@SHOWITEMS]
#ACT
SETDLGITEM 屠龙
FORMATSTR %S <$DLGITEMSHOW>
SETDLGITEM 怒斩
FORMATSTR "%S %S" <$CALCRESULT> <$DLGITEMSHOW>
SETDLGITEM 龙牙
FORMATSTR "%S %S" <$CALCRESULT> <$DLGITEMSHOW>
SETDLGITEM 逍遥扇
FORMATSTR "%S %S" <$CALCRESULT> <$DLGITEMSHOW>
#SAY
装备：<$CALCRESULT>\ <返回 /@BACK> <关闭 /@EXIT>
3、地图点位守护脚本
锁定当前地图坐标为守护区域，设置30像素守护范围，保障定点安全。
#IF
TRUE
#ACT
GUARDPOS $CURRENTX $CURRENTY 30
4、地图光圈特效生成脚本
批量生成地图定点光圈特效，常用于活动地图、安全区特效装饰。
#IF
TRUE
#ACT
GMEXECUTE MOBFIREBURN N3 330 330 4 120 0 1
GMEXECUTE MOBFIREBURN N3 331 330 4 120 0 1
GMEXECUTE MOBFIREBURN N3 332 330 4 120 0 1
GMEXECUTE MOBFIREBURN N3 333 330 4 120 0 1
GMEXECUTE MOBFIREBURN N3 334 330 4 120 0 1
GMEXECUTE MOBFIREBURN N3 334 331 4 120 0 1
GMEXECUTE MOBFIREBURN N3 334 332 4 120 0 1
GMEXECUTE MOBFIREBURN N3 334 333 4 120 0 1
GMEXECUTE MOBFIREBURN N3 334 334 4 120 0 1
GMEXECUTE MOBFIREBURN N3 333 334 4 120 0 1
GMEXECUTE MOBFIREBURN N3 332 334 4 120 0 1
GMEXECUTE MOBFIREBURN N3 331 334 4 120 0 1
GMEXECUTE MOBFIREBURN N3 330 334 4 120 0 1
GMEXECUTE MOBFIREBURN N3 330 333 4 120 0 1
GMEXECUTE MOBFIREBURN N3 330 332 4 120 0 1
GMEXECUTE MOBFIREBURN N3 330 331 4 120 0 1
功能：DELFIREBURN 3 678 336 5 9999
;==========================================
#IF
TRUE
#ACT
GMEXECUTE MOBFIREBURN N3 330 330 4
GMEXECUTE MOBFIREBURN N3 331 330 4
GMEXECUTE MOBFIREBURN N3 332 330 4
GMEXECUTE MOBFIREBURN N3 333 330 4
GMEXECUTE MOBFIREBURN N3 334 330 4
GMEXECUTE MOBFIREBURN N3 334 331 4
GMEXECUTE MOBFIREBURN N3 334 332 4
GMEXECUTE MOBFIREBURN N3 334 333 4
GMEXECUTE MOBFIREBURN N3 334 334 4
GMEXECUTE MOBFIREBURN N3 333 334 4
GMEXECUTE MOBFIREBURN N3 332 334 4
GMEXECUTE MOBFIREBURN N3 331 334 4
GMEXECUTE MOBFIREBURN N3 330 334 4
GMEXECUTE MOBFIREBURN N3 330 333 4
GMEXECUTE MOBFIREBURN N3 330 332 4
GMEXECUTE MOBFIREBURN N3 330 331 4
