传奇脚本分为服务端脚本与客户端脚本两大体系。服务端脚本用于控制NPC对话、任务逻辑、物品交易、地图传送等游戏内功能，运行在传奇服务端引擎上，由M2Server加载解析。客户端脚本用于实现自动打怪、自动拾取、自动吃药、自动回城等挂机辅助功能，运行在玩家电脑端，通过模拟键盘鼠标操作或调用游戏接口实现自动化。
开发工具与环境准备
服务端脚本开发工具
服务端脚本不需要编译，直接使用文本编辑器即可编写。推荐使用Notepad++或VS Code，安装后新建文本文件，编写完成后将扩展名改为.txt，存放至服务端对应目录。部分引擎提供专用脚本编辑器，如996引擎配套工具支持脚本日期管理、全量替换、特征插入、变量查询、文件同步及数据库操作等功能，可大幅提升开发效率。
脚本文件存放路径为MirserverMir200Envir目录。NPC对话脚本位于EnvirMarket_def或EnvirNpc_def文件夹内，NPC配置信息（名称、地图、坐标、形象等）位于EnvirMerchant.txt或npcs.txt文件中，登录及全局管理脚本位于EnvirMapQuest_defQManage.txt。
客户端脚本开发工具
客户端脚本的开发工具选择取决于技术水平和功能需求。按键精灵适合零基础用户，通过录制鼠标键盘操作即可生成基础脚本，配合抓抓工具截取游戏界面坐标与图片，利用找图、找色命令判断游戏状态。Python配合PyAutoGUI、OpenCV库适合有一定编程基础的用户，支持更复杂的图像识别和逻辑判断。AutoHotkey和AutoIt属于轻量级自动化脚本工具，语法简洁，适合编写简单的按键循环和窗口操作。易语言适合国内用户，可配合按键精灵使用，利用其标准库与插件库编写逻辑。
使用按键精灵时，需将游戏设置为窗口模式并固定分辨率（如1024x768），关闭不必要的特效以提升流畅度和识别准确率。使用抓抓工具截取游戏界面坐标与图片，识别地图位置、血条颜色、怪物特征色等关键信息。
服务端NPC脚本语法详解
基础结构
服务端脚本以[@段名]定义段落，[@main]为主入口段，玩家点击NPC时首先执行该段。goto @段名 用于跳转到指定段落执行。脚本执行顺序从上至下，#IF为条件检测标识，#ACT为条件成立时的执行标识，#SAY用于显示对话文本，#ELSEACT为条件不成立时的执行标识，#ELSESAY为条件不成立时的显示文本。分号;用于注释，反斜杠用于对话文本换行。
一个完整的NPC脚本示例如下：
[@main]
欢迎来到热血传奇\
这里是新人福利领取处\
\
<领取福利/@lingqu>\
<兑换装备/@duihuan>\
<退出/@exit>
[@lingqu]
IF
ACT
give 木剑 1
give 金币 500
SAY
已领取木剑一把和500金币。
[@duihuan]
IF
checkitem 木剑 1
ACT
take 木剑 1
give 屠龙 1
SAY
木剑兑换成了屠龙！
ELSESAY
你的背包里没有木剑，无法兑换。
上述脚本中，[@main]段显示对话内容并提供三个选项链接，尖括号内斜杠前的文字为显示文本，斜杠后的@lingqu、@duihuan、@exit为触发跳转的标签名。点击"领取福利"后跳转到[@lingqu]段，由于#IF下方无条件检测（为空），表示直接执行#ACT下的命令，give木剑1表示给予玩家一把木剑，give金币500表示给予500金币。
点击"兑换装备"后跳转到[@duihuan]段，#IF下方写入checkitem木剑1，表示检测玩家背包中是否有至少一把木剑。条件成立则执行#ACT下的take木剑1（扣除木剑）和give屠龙1（给予屠龙），条件不成立则执行#ELSESAY下的提示文本。
条件检测命令
常用检测命令包括：CHECKITEM 物品名 数量（检测背包物品及数量）、CHECKGOLD 数量（检测金币数量）、CHECKGAMEGOLD 数量（检测元宝数量）、CHECKLEVELEX 等级（检测角色等级）、CHECKJOB 职业（检测角色职业，0为战士、1为法师、2为道士）、CHECKHUM 地图名 数值（检测地图内人数）、CHECKMONMAP 地图名 数值（检测地图内怪物数量）、CHECKBAGGAGE（检测背包是否已满）、CHECKPKPOINT PK值（检测PK值）、CHECKLUCKYPOINT 幸运值（检测幸运值）。
执行命令
常用执行命令包括：give 物品名 数量（给予物品或金币）、take 物品名 数量（收回物品或金币）、map 地图名（传送至地图随机坐标）、mapmove 地图名 X Y（传送至地图指定坐标）、monclear 地图名（清除地图怪物）、MonGen 怪物名 数量 时间（刷怪）、TIMECALL 数值（设置限时召回，单位分钟）、BreakTimeRecall（中断限时召回）、CHANGELEVEL 等级数（调整角色等级）、ADDSKILL/DELSKILL 技能名（添加/删除技能）、GAMEGOLD 控制符 数量（调整元宝，控制符为+增加、-减少、=设定）、HUMANHP 数值（恢复生命值）。
变量系统
服务端脚本支持多种变量类型。私人数字变量包括N0至N999（下线不保存、小退归零）和U0至U99（可保存至人物数据库）。私人字符变量包括S0至S999（下线不保存）和T0至T99（可保存至人物数据库）。全局数字变量G0至G999和全局字符变量A0至A999可保存至GlobalVal.ini文件，全服共享。逻辑变量[n]（n为1至1024正整数），只有0和1两个值，初始为0。
变量操作命令包括：mov 变量 数值（赋值）、inc 变量 数值（自增）、DEC 变量 数值（自减）、MUL 变量 数值（乘法）、DIV 变量 数值（整除）、sum 变量A 变量B（求和）、movr 变量 数值（随机赋值，变量值为0到指定数值之间的随机数）。比较判断使用small（小于）、large（大于）、equal（等于）。
在对话文本中显示变量值，使用<STR(变量名)>格式。例如#SAY下写入"你的金币数量为<STR(N1)>"，即可在游戏对话框中显示变量N1的当前值。
交易型NPC脚本
交易型NPC（如武器店、药店、首饰店）的脚本需要在头部定义物价倍率和交易类型，底部使用[goods]段落定义商品列表。例如：
%100
+43
[goods]
木剑 5 0
青铜刀 3 0
铁剑 2 0
%100表示商品按原价出售，若改为%200则为双倍价格。+43表示与武器相关的交易类型（修理武器等）。[goods]段落中每行格式为"物品名 数量 时间"，数量表示商店库存上限，时间表示商品刷新间隔（0为不刷新）。
脚本重载
修改NPC脚本文件后，需要在M2Server控制台中执行重载操作才能生效。可在游戏内聊天框输入@ReloadNpc重新加载NPC脚本，或在M2Server控制台点击"选项"-"重读NPC"。部分引擎支持在脚本编辑器中一键保存并自动重载。
客户端挂机脚本编写详解
按键精灵方案
按键精灵编写传奇挂机脚本的核心流程为：环境配置、坐标与图片采集、功能模块编写、调试测试。
环境配置方面，安装按键精灵及大漠插件（用于图像识别和窗口绑定），将游戏设置为窗口模式，固定分辨率为1024x768或800x600。
坐标与图片采集方面，使用按键精灵自带的抓抓工具，在游戏界面上截取关键位置的坐标和颜色值。需要采集的信息包括：怪物血条颜色值、角色血条和蓝条的坐标区域、攻击技能键位坐标、背包格子坐标、NPC坐标、地图出入口坐标等。将截取的图片保存为BMP格式，放入按键精灵附件目录。
核心功能模块编写如下。
自动吃药模块，通过GetPixelColor命令获取角色血条坐标处的颜色值，与满血时的颜色值进行比较。若颜色值偏离阈值（说明血量下降），则模拟按下吃药快捷键。示例代码：
Do
hpColor = GetPixelColor(120, 50)
If hpColor <> "00FF00" Then
KeyPress "F1", 1
Delay 500
End If
mpColor = GetPixelColor(120, 65)
If mpColor <> "0000FF" Then
KeyPress "F2", 1
Delay 500
End If
Delay 1000
Loop
自动攻击模块，使用FindColor或FindPic命令在屏幕指定范围内搜索怪物血条颜色或怪物头像图片，找到后返回坐标值，模拟鼠标移动到该坐标并左键点击，实现锁定攻击。若未找到目标，则模拟按下移动键（WASD）随机移动角色位置，继续搜索。
自动拾取模块，在攻击怪物后，模拟按下空格键（拾取快捷键）或Alt键，触发物品拾取动作。可配合延时命令设置拾取间隔，避免频繁操作。
回城补给模块，设置背包空格数检测逻辑。当背包剩余空格少于设定值时，触发回城流程：模拟使用回城卷轴或随机传送卷轴，到达安全区后依次执行卖垃圾、修理装备、购买药品等操作，完成后再次使用传送手段返回挂机地图。
防卡点巡逻模块，设置一个计时器，若超过指定时间（如30秒）未检测到攻击动作或怪物血条颜色变化，则模拟随机方向移动，防止角色卡在障碍物上。
Python方案
使用Python编写传奇挂机脚本，核心依赖库包括pyautogui（模拟键盘鼠标操作）、Pillow（图像处理）、opencv-python（高级图像识别）、pywin32（窗口操作）。
基本框架如下：
import pyautogui
import time
import cv2
import numpy as np
def find_image(template_path, region=None, confidence=0.8):
"""在屏幕指定区域搜索模板图片，返回匹配中心坐标"""
screenshot = pyautogui.screenshot(region=region)
screenshot = cv2.cvtColor(np.array(screenshot), cv2.COLOR_RGB2BGR)
template = cv2.imread(template_path)
result = cv2.matchTemplate(screenshot, template, cv2.TM_CCOEFF_NORMED)
min_val, max_val, min_loc, max_loc = cv2.minMaxLoc(result)
if max_val >= confidence:
h, w = template.shape[:2]
center_x = max_loc[0] + w // 2
center_y = max_loc[1] + h // 2
return (center_x, center_y)
return None
def auto_attack():
"""自动攻击循环"""
while True:
target = find_image("monster_hp.png", region=(0, 0, 800, 600))
if target:
pyautogui.click(target[0], target[1])
time.sleep(0.5)
else:
pyautogui.press('right')
time.sleep(0.3)
pyautogui.press('left')
time.sleep(0.3)
def check_hp():
"""检测血量并自动吃药"""
hp_pixel = pyautogui.pixel(120, 50)
if hp_pixel[1] < 100: # 绿色分量低于阈值说明血量不足
pyautogui.press('F1')
time.sleep(0.5)
上述代码中，find_image函数使用OpenCV的模板匹配功能在屏幕指定区域搜索怪物血条图片，返回匹配位置的中心坐标。auto_attack函数实现自动攻击循环，找到怪物后点击攻击，未找到则随机移动。check_hp函数通过读取血条坐标处的像素颜色值判断血量是否不足，不足时自动按下吃药快捷键。
Lua方案
部分传奇引擎支持Lua脚本语言编写客户端自动化脚本。需在传奇游戏目录创建Scripts文件夹，编写main函数，利用游戏API与游戏交互。基础语法包括变量定义（var a = 10）、循环结构（while True do ... end）、条件判断（if status == 2 then ... elseif ... else ... end）。常用API包括Player.X/Player.Y获取角色坐标、myChar:getStatus()获取角色状态、myChar:getPos()获取位置、myChar:setTarget(x, y)设置移动目标、WalkRight()/WalkUp()等移动指令。
脚本编写注意事项
服务端脚本注意事项
所有符号必须使用英文半角字符，中文标点会导致引擎解析失败。命令与参数之间必须使用空格分隔，一个空格或多个空格均可，但不能省略。每段指令结尾需按规范写结束符。变量命名不得以P、D、M、N、S、I、G、A开头（这些为系统保留前缀）。自定义变量需先声明再使用。脚本中涉及goto跳转时，务必确保目标段落存在，否则会引发引擎报错。
客户端脚本注意事项
添加适当的延时（Delay或Sleep）防止点击频率过快被游戏反外挂系统识别为异常操作。建议使用随机延时，如Delay 1000+Int(500*Rnd)，模拟真人操作的不规则间隔。将重复使用的指令提取为子程序或函数，减少代码冗余。编写异常处理逻辑，如找不到目标图片时执行重试或随机移动，避免脚本卡死。调试时先逐模块单独测试，确认每个功能正常后再组合运行。
合规提醒
使用客户端自动化脚本（外挂、辅助）在绝大多数传奇游戏中违反用户协议，可能导致账号封禁。部分行为可能涉及法律风险。建议优先学习服务端脚本开发，用于合法搭建游戏环境、设计NPC任务和游戏玩法。客户端脚本仅建议在单机测试环境或获得服务器管理员授权的场景下使用。
