传奇脚本编写主要分为服务端脚本与客户端自动化脚本两大类。服务端脚本用于搭建游戏功能、NPC交互、怪物刷新、任务系统等，运行在服务器端；客户端自动化脚本用于实现挂机、自动打怪、拾取、跑图等辅助功能，运行在玩家本地。以下从语法基础、核心指令、开发工具、实战案例、调试技巧五个维度系统拆解。
一、服务端NPC脚本语法基础
服务端NPC脚本是传奇脚本编写的核心，基于特定引擎语法开发，不同引擎（GOM、GEE、996、翎风、V8等）语法基本通用，核心结构由#IF（条件检测）和#ACT（执行命令）组成，检测命令只能放在#IF下，执行命令放在#ACT或#ELSEACT下。
脚本段落以[@段名]开头，段标识使用英文或数字，用于划分功能模块。goto@段名用于跳转到指定段落执行。#say用于输出对话框文字，无需定界符。#call用于调用子程序，一般调用QuestDiary目录下的子程序。;为注释符号，加在行首该行不编译不显示。为换行符，防止长文本超出对话框。<>为交谈选项，显示为黄色可点选文字，含goto含义。/为分隔符，用于分隔显示语言与脚本语言。
条件判断框架为#IF后接检测命令，满足条件执行#act，不满足执行#elsesay或#elseact。常用检测命令包括checklevel检测等级、checkgold检测金币、checkitem检测背包物品、checkjob检测职业（Warr战士/Wizard法师/Taos道士）、genderman检测性别是否为男、checkpkpoint检测PK值、checkmagic检测是否修炼指定技能、checkhum检测地图人数、checkmonmap检测地图怪物数量等。
执行命令包括give发放道具或金币、take回收道具或金币、map传送至指定地图随机坐标、monclear清除指定地图所有怪物、MonGen自定义刷新怪物、ADDSKILL添加技能、DELSKILL删除技能、CHANGEJOB调整职业、CHANGEGENDER调整性别等。
变量系统限于P0-P9、D0-D9，逻辑变量为[n]（n为正整数）。mov变量数值用于变量赋值，inc变量数值用于变量自增，DEC变量数值用于变量自减，MUL变量数值用于变量乘法，DIV变量数值用于变量除法，movr变量数值用于定义随机变量（范围0至数值不含数值），random数值用于概率判断（如random2为50%概率）。
二、客户端自动化脚本语法基础
客户端自动化脚本常用Lua或Python语言编写，通过调用游戏API实现自动挂机、移动、拾取等功能。基础语法包含变量定义、循环（while/for）及条件判断（if-then-else）。
以Lua语言为例，编写挂机脚本需在传奇游戏目录创建Scripts文件夹，导入必要库并编写main函数。以下是一个简单的自动挂机脚本示例：
whileTruedo
localstatus=myChar:getStatus()
ifstatus==2then
localxy=myChar:getPos()
ifmath.random(1100)>50then
myChar:setTarget(x-5y)
else
myChar:setTarget(x+5y)
end
elseifstatus==4orstatus==8then
localxy=myChar:getPos()
ifmath.random(1100)>50then
myChar:setTarget(xy-5)
else
myChar:setTarget(xy+5)
end
end
end
该脚本通过循环检测玩家状态，根据随机数决定移动方向，实现自动挂机功能。编写流程包括了解游戏机制、选择编辑器、设计功能模块、编写代码及调试测试。
三、开发工具链推荐
服务端脚本开发工具方面，MirScriptEd是专业传奇脚本编辑器，内置AI智能助手，支持自然语言描述需求、自动分析脚本逻辑、智能代码补全、语法高亮、数据库编辑（Access/SQLite）、变量占用查询、脚本跳转、文件同步、大纲视图及脚本热重载功能。传奇脚本编辑器AI智能版（V4.0）支持所有传奇引擎通用，功能包括脚本注册登录、命令翻译、NPC管理、变量检测与修改、数据库操作、AI脚本生成、可视化刷怪与怪物设计。MirEdit是VSCode插件，支持GEE、GOM、996、V8等多引擎切换，具备文本着色、自动补全、大纲折叠、变量占用查询、一键重载及文档对齐功能。BOOUI编辑器是面向传奇GM的VSCode扩展，提供脚本智能提示、UI可视化编辑、PAK/JPK读取、数据库与地图查看及M2重载功能。
客户端自动化脚本工具方面，按键精灵通过图像识别获取游戏界面状态，编写判断逻辑和循环结构实现自动打怪、自动捡物、自动回血等功能。AutoHotkey和AutoIt是自动化脚本编写工具，可指定角色位置和怪物位置，编写循环语句让玩家持续施放技能，实现技能冷却控制。雷电模拟器内置操作录制功能，可记录并回放游戏操作流程，支持导入外部.lua或.txt脚本文件。
四、实战案例：NPC对话与触发型脚本
以下是一个新人福利领取NPC脚本示例：
[@main]
IF
ACT
SAY
欢迎来到热血传奇\
这是新人福利领取处\
\
现在我们将为新人发放福利，是否领取？\
\
<领取/@lingqu>\
<退出/@exit>
[@lingqu]
IF
checklevel1
ACT
give木剑1
givegold500
SAY
福利已发放，祝你游戏愉快！
[@exit]
ACT
close
该脚本首先通过[@main]段落显示欢迎信息，玩家点击领取后跳转到[@lingqu]段落，检测等级是否达到1级，满足条件后发放木剑和500金币，最后显示提示信息。
触发型脚本（QF脚本）是传奇脚本的重要部分，用于实现升级触发、打怪触发、死亡触发、双击触发、穿戴触发等功能。以下是一个打怪触发绿毒效果的示例：
[@Attack]
IF
ACT
ifMONGENEX地图文件XY怪物名范围数量是否内功怪物颜色
IF
EQUALHUM1
ACT
CHANGEATTRIBUTE目标绿毒300
该脚本在玩家攻击怪物时触发，检测目标是否为怪物（非人物），满足条件后给目标施加持续30秒的绿毒效果。
五、调试技巧与注意事项
调试脚本时建议先验证按钮触发与消息输出是否正常，再逐步完善逻辑。使用SENDMSG6命令输出调试信息，例如SENDMSG6当前元宝为<GAMEGOLD>，可实时查看变量值。保存脚本后需重载NPC或QF功能脚本方可生效，部分编辑器支持一键重载功能。
变量使用时需注意避免冲突，可使用变量占用查询功能快速查看已占用变量。脚本编写过程中需注意避免违规操作，制作与使用外挂或第三方辅助程序存在法律风险，可能导致账号封禁、游戏运行不稳定、个人信息泄露及破坏游戏公平性，需遵守相关法律法规及游戏规则。
一、服务端NPC脚本语法基础
服务端NPC脚本是传奇脚本编写的核心，基于特定引擎语法开发，不同引擎（GOM、GEE、996、翎风、V8等）语法基本通用，核心结构由#IF（条件检测）和#ACT（执行命令）组成，检测命令只能放在#IF下，执行命令放在#ACT或#ELSEACT下。
脚本段落以[@段名]开头，段标识使用英文或数字，用于划分功能模块。goto@段名用于跳转到指定段落执行。#say用于输出对话框文字，无需定界符。#call用于调用子程序，一般调用QuestDiary目录下的子程序。;为注释符号，加在行首该行不编译不显示。为换行符，防止长文本超出对话框。<>为交谈选项，显示为黄色可点选文字，含goto含义。/为分隔符，用于分隔显示语言与脚本语言。
条件判断框架为#IF后接检测命令，满足条件执行#act，不满足执行#elsesay或#elseact。常用检测命令包括checklevel检测等级、checkgold检测金币、checkitem检测背包物品、checkjob检测职业（Warr战士/Wizard法师/Taos道士）、genderman检测性别是否为男、checkpkpoint检测PK值、checkmagic检测是否修炼指定技能、checkhum检测地图人数、checkmonmap检测地图怪物数量等。
执行命令包括give发放道具或金币、take回收道具或金币、map传送至指定地图随机坐标、monclear清除指定地图所有怪物、MonGen自定义刷新怪物、ADDSKILL添加技能、DELSKILL删除技能、CHANGEJOB调整职业、CHANGEGENDER调整性别等。
变量系统限于P0-P9、D0-D9，逻辑变量为[n]（n为正整数）。mov变量数值用于变量赋值，inc变量数值用于变量自增，DEC变量数值用于变量自减，MUL变量数值用于变量乘法，DIV变量数值用于变量除法，movr变量数值用于定义随机变量（范围0至数值不含数值），random数值用于概率判断（如random2为50%概率）。
二、客户端自动化脚本语法基础
客户端自动化脚本常用Lua或Python语言编写，通过调用游戏API实现自动挂机、移动、拾取等功能。基础语法包含变量定义、循环（while/for）及条件判断（if-then-else）。
以Lua语言为例，编写挂机脚本需在传奇游戏目录创建Scripts文件夹，导入必要库并编写main函数。以下是一个简单的自动挂机脚本示例：
whileTruedo
localstatus=myChar:getStatus()
ifstatus==2then
localxy=myChar:getPos()
ifmath.random(1100)>50then
myChar:setTarget(x-5y)
else
myChar:setTarget(x+5y)
end
elseifstatus==4orstatus==8then
localxy=myChar:getPos()
ifmath.random(1100)>50then
myChar:setTarget(xy-5)
else
myChar:setTarget(xy+5)
end
end
end
该脚本通过循环检测玩家状态，根据随机数决定移动方向，实现自动挂机功能。编写流程包括了解游戏机制、选择编辑器、设计功能模块、编写代码及调试测试。
三、开发工具链推荐
服务端脚本开发工具方面，MirScriptEd是专业传奇脚本编辑器，内置AI智能助手，支持自然语言描述需求、自动分析脚本逻辑、智能代码补全、语法高亮、数据库编辑（Access/SQLite）、变量占用查询、脚本跳转、文件同步、大纲视图及脚本热重载功能。传奇脚本编辑器AI智能版（V4.0）支持所有传奇引擎通用，功能包括脚本注册登录、命令翻译、NPC管理、变量检测与修改、数据库操作、AI脚本生成、可视化刷怪与怪物设计。MirEdit是VSCode插件，支持GEE、GOM、996、V8等多引擎切换，具备文本着色、自动补全、大纲折叠、变量占用查询、一键重载及文档对齐功能。BOOUI编辑器是面向传奇GM的VSCode扩展，提供脚本智能提示、UI可视化编辑、PAK/JPK读取、数据库与地图查看及M2重载功能。
客户端自动化脚本工具方面，按键精灵通过图像识别获取游戏界面状态，编写判断逻辑和循环结构实现自动打怪、自动捡物、自动回血等功能。AutoHotkey和AutoIt是自动化脚本编写工具，可指定角色位置和怪物位置，编写循环语句让玩家持续施放技能，实现技能冷却控制。雷电模拟器内置操作录制功能，可记录并回放游戏操作流程，支持导入外部.lua或.txt脚本文件。
四、实战案例：NPC对话与触发型脚本
以下是一个新人福利领取NPC脚本示例：
[@main]
IF
ACT
SAY
欢迎来到热血传奇\
这是新人福利领取处\
\
现在我们将为新人发放福利，是否领取？\
\
<领取/@lingqu>\
<退出/@exit>
[@lingqu]
IF
checklevel1
ACT
give木剑1
givegold500
SAY
福利已发放，祝你游戏愉快！
[@exit]
ACT
close
该脚本首先通过[@main]段落显示欢迎信息，玩家点击领取后跳转到[@lingqu]段落，检测等级是否达到1级，满足条件后发放木剑和500金币，最后显示提示信息。
触发型脚本（QF脚本）是传奇脚本的重要部分，用于实现升级触发、打怪触发、死亡触发、双击触发、穿戴触发等功能。以下是一个打怪触发绿毒效果的示例：
[@Attack]
IF
ACT
ifMONGENEX地图文件XY怪物名范围数量是否内功怪物颜色
IF
EQUALHUM1
ACT
CHANGEATTRIBUTE目标绿毒300
该脚本在玩家攻击怪物时触发，检测目标是否为怪物（非人物），满足条件后给目标施加持续30秒的绿毒效果。
五、调试技巧与注意事项
调试脚本时建议先验证按钮触发与消息输出是否正常，再逐步完善逻辑。使用SENDMSG6命令输出调试信息，例如SENDMSG6当前元宝为<GAMEGOLD>，可实时查看变量值。保存脚本后需重载NPC或QF功能脚本方可生效，部分编辑器支持一键重载功能。
变量使用时需注意避免冲突，可使用变量占用查询功能快速查看已占用变量。脚本编写过程中需注意避免违规操作，制作与使用外挂或第三方辅助程序存在法律风险，可能导致账号封禁、游戏运行不稳定、个人信息泄露及破坏游戏公平性，需遵守相关法律法规及游戏规则。