BLUE引擎最新全套NPC命令大全 传奇脚本进阶功能教程

本文汇总整理了BLUE引擎全新新增及经典常用的全部NPC命令，涵盖客户端按键模拟、人物属性修改、脚本循环逻辑、装备进阶、假人设置、特效刷新、英雄系统等全方位传奇脚本功能。所有命令均附带详细参数解析、使用场景及实操示例，适配传奇版本搭建、脚本修改、功能开发等需求，是传奇GM、脚本开发者必备的实用参考手…

本文汇总整理了BLUE引擎全新新增及经典常用的全部NPC命令，涵盖客户端按键模拟、人物属性修改、脚本循环逻辑、装备进阶、假人设置、特效刷新、英雄系统等全方位传奇脚本功能。所有命令均附带详细参数解析、使用场景及实操示例，适配传奇版本搭建、脚本修改、功能开发等需求，是传奇GM、脚本开发者必备的实用参考手册。

一、客户端按键模拟NPC命令

本节核心命令为 ClientPressKey，主要用于客户端键盘按键模拟，支持常规按键、功能按键及组合快捷键自定义，可实现自动挂机、界面开关、聊天操作等各类客户端交互功能，适配各类传奇版本的快捷功能开发。

1.1 命令参数说明

命令格式：ClientPressKey 常规键 状态键

常规键支持：0~9、A-Z、F1~F24、符号按键、ESC、UP、DOWN、HOME、END等全品类键盘按键

状态键参数：0=无状态、1=Shift、2=Alt、4=Ctrl，复合按键可直接数值相加组合

1.2 基础按键实操示例

ClientPressKey A 6 // 组合ALT+A，触发地图自动挂机功能，适配版本挂机复选框状态切换

ClientPressKey F12 // 按下F12，快速打开游戏内挂界面，可自定义任意快捷键

ClientPressKey TAB // 按下TAB键，打开游戏地图界面

ClientPressKey ESC // 按下ESC键，切换物品显示开关状态

ClientPressKey UP // 聊天内容向上翻页

ClientPressKey DOWN // 聊天内容向下翻页

ClientPressKey HOME // 聊天内容跳转至顶部

ClientPressKey END // 聊天内容跳转至底部

1.3 游戏原生组合快捷键汇总

ALT+V // 隐藏游戏内怪物尸体，优化画面卡顿问题

ALT+Enter // 切换游戏窗口/全屏模式，修复版本适配bug

CTRL+O // 打开任务查看界面

CTRL+P // 打开组队信息查看界面

CTRL+T // 开启玩家交易功能

Ctrl+L // 查看游戏历史操作记录

Ctrl+K // 一键清理聊天栏内容

CTRL+A // 切换下属单位攻击模式

CTRL+Z // 显示/隐藏游戏角色名称

CTRL+X // 触发灵媒探索功能

CTRL+H // 切换角色自身攻击模式

CTRL+G // 打开行会管理界面

二、人物基础属性与状态修改命令

该系列命令主要用于修改传奇角色名称颜色、传送冷却、石化状态、外观显示等基础属性，参数精准可控，支持数值增减、赋值运算，广泛应用于版本特色功能、权限设置、状态特效开发。

2.1 名称颜色修改命令

命令：ChangeNameColor 0-255

功能：自定义修改玩家人物名称、英雄名称颜色，数值区间0-255，适配全色系名称特效设置。

2.2 传送间隔时间修改命令

命令：ChangeTeleportTime +/-/= 毫秒

功能：修改玩家单次传送间隔时间（非下次传送倒计时），支持加减赋值运算，可通过变量 $TELEPORTCD 查看当前可传送等待秒数，禁止高频重复调用，避免版本数据异常。

2.3 石化能力属性修改命令

命令1：ChangeAbilMakeStoneRate +/-/= 几率(1~255)

功能：修改玩家个人石化触发几率，数值越大，石化触发几率越小，支持动态调整角色控制属性。

命令2：ChangeAbilMakeStoneTime +/-/= 秒数(1~59)

功能：修改玩家石化持续时间，数值越大，石化锁定时长越长，适配PK、副本专属状态效果。

2.4 物品与外观状态命令

命令1：RetBoxItem 0~9

功能：将物品框内物品一键返还至玩家背包，解决物品卡框、显示异常问题。

命令2：CheckApprFilter 位置(0~7) 开关(隐藏0/显示1)

功能：检测并控制角色外观显示状态，位置4~7参数暂未开放，可搭配ChangeApprFilters实现外观特效自定义开关。

三、脚本逻辑与变量运算命令

BLUE引擎核心进阶脚本命令，新增循环、区间判断、多类型变量比对、位运算等功能，大幅拓展传奇脚本的逻辑开发能力，可实现复杂判定、批量操作、数据筛选等高级功能。

3.1 自定义统计命令

命令：NewStat 统计ID

功能：创建自定义数据统计条目，可用于玩家在线时长、击杀数量、任务进度等数据统计记录。

3.2 脚本循环命令

新增 #for、#~for 循环脚本支持，配套变量：<$LoopCursor>，配套中断命令：BreakLoop

功能：支持多层嵌套循环，循环内部完整兼容 #if、#act、#elseact 全套脚本流程，BreakLoop仅中断当前循环层，全局中断仍使用Break命令，适配批量数据处理、重复功能触发场景。

3.3 区间选择判断命令

新增 #case、#~case 配对区间选择命令，仅支持单层逻辑

功能：内部兼容全套脚本判定流程，可实现数值区间、固定参数的精准匹配，替代多组嵌套if判定，简化脚本代码结构。

3.4 多类型数值比对命令

命令：CompVal 变量 比对符号 数值 类型

参数说明：int=数字类型比对、str=字符串类型比对、f=浮点数比对，支持精准小数数值判定

示例：CompVal <$PropRate[3]> > 1.5 f // 浮点数比对，判定属性比率是否大于1.5

3.5 位运算批量开关命令

支持 AND、OR、XOR、NOT 逻辑运算，搭配 SETBIT、UNSETBIT、FLIPBIT、ISBITSET 位操作命令，可对0~31位整数进行单独开关控制，节省脚本变量占用。

核心参数：第二参数对应0~31位数值，可实现32组独立开关状态存储

3.6 字符串变量操作命令

命令：INS S1 位置(1~S1长度+1) 插入字符 重复次数(默认1)

功能：针对S1字符串变量进行定点字符插入，适配文本修改、昵称编辑、数据拼接等场景。

配套整数变量操作：支持P/G/D/M/I/H等整型变量自定义运算修改。

四、客户端弹窗与进度条交互命令

该系列命令用于优化客户端交互体验，支持自定义进度条、彩色弹窗提示，可用于任务进度、功能加载、状态提示等场景，需配套新版客户端支持完整效果。

4.1 客户端进度条命令

命令1：CliProgBar 6500 这是提示信息 // 显示客户端进度条，参数1为倒计时毫秒数，参数2为自定义提示文字

命令2：CliProgBar 0 // 关闭当前客户端进度条显示

4.2 彩色弹窗提示命令

命令：MESSAGEBOX

功能：支持 COLOR 颜色赋值、PIC 图片绑定，无鼠标交互事件，需更新客户端适配，支持随机颜色文字展示。

实操示例：

#ACT

SetRandomNO 5592405 16777215

MESSAGEBOX "常规文字，<COLOR=clSkyBlue 天蓝色文字，><COLOR=#<$RANDOMNO> 随机颜色文字>"

五、物品与装备进阶设置命令

涵盖物品描述修改、装备属性鉴定、装备升级、物品展示刷新等全套装备功能命令，是传奇版本装备系统、极品属性、自定义装备玩法开发的核心命令。

5.1 物品描述自定义命令

命令：SetItemDesc 物品ID 描述

功能：自定义指定物品ID的展示描述，描述留空则删除原有物品描述，仅AC客户端支持该功能，可搭配Hash命令联动操作。

5.2 鉴定属性百分比修改命令

命令：CHANGEEVALPROPADDRATE +/-/= 数值(0~65535)

功能：修改装备普通鉴定属性附加百分比，数据持久存库，需DBS数据库与客户端配套适配。

5.3 装备升级系列命令

包含UpgradeItem、UpgradeItemEx、UpgradeDlgItem三大装备升级命令，支持普通属性、神秘属性、宝石属性分离升级，可批量修改装备属性，参数99为专属神秘属性升级模式，忽略普通属性改动。

核心格式：普通鉴定属性|神秘鉴定属性|特殊属性|神技|几鉴，需完整填写参数方可生效。

5.4 物品刷新展示命令

命令：ADDSHOWITEM 物品ID

功能：添加/刷新指定物品展示效果，留空默认调用当前DLGITEMID，适配装备属性变更后实时刷新展示，搭配 $ITEM(物品ID) 实现动态物品展示。

5.5 背包物品移动命令

命令：MOVEBAGITEM 物品名/物品ID 数量

功能：玩家执行将物品转移至英雄背包，英雄执行H.MOVEBAGITEM可将物品转回玩家背包，重叠物品视为整体统一转移。

六、假人与合击系统命令

针对传奇假人系统、英雄合击玩法的专属命令，优化传统假人加载方式，新增合击预备、威力调节、怒气修改功能，适配复古、合击、微变各类版本。

6.1 假人加载优化命令

命令：LOADDUMMY 账号 角色名

功能：全新假人加载命令，支持账号、角色名单参数/双参数录入，替代传统FAKEPLAYER批量加载删除的繁琐操作，高效稳定。

配套命令：FAKEPLAYER 0/1 // 0=踢出假人、1=加载假人

6.2 合击功能专属命令

命令1：PrepareUniteHit // 预备合击技能，需英雄在线且拥有合击技能，锁定目标后立即释放

命令2：UNITYENERGY +/-/= 数值 // 自定义修改合击怒气值

命令3：UNITYPOWERRATE +/-/= 数值 // 修改合击威力倍率，默认100，支持变量 <$UNITYPOWERRATE> 实时查看数值

七、地图特效与刷怪功能命令

支持地图光圈特效刷新、删除，自定义地图守护点、随机刷怪，适配副本特效、地图警戒、专属刷怪场景开发。

7.1 地图光圈特效命令

命令1：MOBFIREBURN 地图 X Y 类型 时间 伤害值 // 刷新地图自定义光圈特效，支持持续伤害

命令2：DELFIREBURN 地图 X Y 类型 // 删除指定位置地图光圈特效

7.2 地图守护与随机点命令

命令1：MAP $CURRENTMAP // 生成当前地图随机守护点位

命令2：GUARDPOS $CURRENTX $CURRENTY 范围 // 设置地图守护点位及生效范围，X=-1时取消守护设置

7.3 自定义刷怪命令

命令：MONGENEX 地图文件 XY 怪物名 范围 数量 是否内功怪物 颜色

功能：精细化自定义刷怪参数，支持内功怪物、怪物名称颜色自定义，适配专属地图刷怪配置。

八、角色状态与倍率功能命令

全套角色属性倍率、经验倍率、状态buff、挂机功能命令，可实现角色属性翻倍、离线挂机、自动泡点、穿人穿怪等特色功能。

8.1 倍率调节命令

命令1：STATUSRATE 类型 倍率 // 角色属性翻倍，支持防御、魔御、攻击、魔法、道术、HP、MP七大属性

命令2：POWERRATE 倍率 时间 // 职业专属攻击、魔法、道术倍率加成

命令3：KILLMONEXPRATE 倍率 时间 // 自定义杀怪经验倍数，适配泡点、升级活动

8.2 挂机与离线功能命令

SETAUTOGETEXP // 开启角色在线自动泡经验功能

SETOFFLINEPLAY ON/OFF // 开启/关闭安全区下线自动脱机

SETOFFLINEFUNC // 设置角色上线自动挂机涨经验

OFFLINEPLAYEX // 开启角色离线挂机打怪功能，支持假人适配

CLIENTFEATURES 0/1 // 全局开关客户端挂机功能，支持全服/单地图/单角色控制

8.3 角色状态控制命令

THROUGHHUMMS 模式 时间 // 设置穿人穿怪状态，支持单独穿人、单独穿怪、全部穿透模式

LOCKDOWN 0/1 // 1=锁定角色（无法移动、攻击、放技能），0=解锁恢复正常状态

HAIRSTYLE 0/1 // 自定义角色发型样式

九、文本读写与数据处理命令

支持本地文本数据读写、随机读取、内容增删、字符长度统计，适配排行榜数据记录、随机福利、账号数据存档等功能。

READRANDOMSTR // 带权重随机读取文本内容，权重数值越大获取概率越高

READRANDOMLINE // 纯随机读取文本单行内容

ADDLINELIST // 向指定文本写入新内容，默认ENVIR目录

DELLINELIST // 删除指定文本内对应内容

GETSTRLENGTH // 统计字符串字符长度并赋值给变量

STRCAP // 截取指定符号内的字符串内容，实现数据精准提取

十、英雄系统专属命令

覆盖英雄创建、删除、召唤、多英雄申请全套功能，适配合击版本英雄系统开发与优化。

CREATEHERO // 常规创建单英雄，支持三职业男女体型选择

CREATEHEROEX // 进阶多英雄申请功能，支持储备英雄设置

RECALLHERO // 召唤/回收英雄，参数控制英雄状态切换

DELETEHERO // 删除当前绑定英雄

十一、其他实用辅助命令汇总

OUTPUTMESSAGE // 将自定义文字输出至引擎日志，方便脚本调试

GOTO @XXX // 跨脚本段跳转，支持多参数传递给全队玩家

DELAYGOTO、DELAYCALL // 延时脚本跳转执行，实现延迟功能触发

REPAIRALL // 一键特修角色全身装备

GETPOSENAME // 获取对面交互角色名称，赋值变量调用

QUERYBINDITEM // 弹出物品绑定/解绑窗口，支持装备绑定体系开发

CALCVAL // 自定义数值四则运算、时间运算，结果存入指定变量

MAKEPOISON // 自定义角色/怪物状态buff，支持毒术、冰冻、石化、隐身等16种状态效果