传奇脚本是控制游戏内NPC对话、任务流程、怪物刷新、道具兑换等功能的核心指令集合。编写脚本不依赖复杂编程知识，核心在于掌握“条件-执行-反馈”的逻辑闭环。脚本通过特定语法让游戏引擎执行预设操作，例如新手引导员对话、副本怪物刷新、装备回收等。
脚本编写核心三要素
触发条件、执行逻辑、反馈机制构成脚本三大要素。触发条件是脚本启动的开关，常见形式包括玩家点击NPC（使用[@main]标识）、拾取指定物品（CHECKCURRENTITEM命令）、进入特定地图（MAPENTER触发）。执行逻辑是满足条件后脚本执行的具体操作，例如扣除道具（TAKE命令）、发放奖励（GIVE命令）、传送地图（MAPMOVE命令）。反馈机制是给玩家的结果提示，通过SENDMSG命令发送文字提示，或用MessageBox弹出对话窗口。
开发环境与工具准备
编写脚本前需搭建测试环境。本地搭建单机传奇服务端（HERO或GOM引擎），制作完脚本直接在本地测试。文本编辑工具推荐使用记事本++，支持语法高亮和ANSI编码，避免中文乱码。服务端文件查看器可使用TotalCommander或资源管理器，快速定位脚本、物品、怪物配置文件。专业编辑器如“传奇F1智能助手”提供语法高亮、代码错误检查、智能提示、命令补全等功能。
必查参数获取方法
脚本中需要的物品ID、怪物ID、地图编号等参数需从服务端配置文件中获取。物品ID在“Mir200\Envir\Item.txt”中查找，每行开头数字即为ID。怪物ID在“Mir200\Envir\Monster.txt”中查找。地图编号在“Mir200\MapInfo.txt”中，“编号 地图名 路径”格式的数字就是地图编号。NPC脚本文件存放在“Mir200\Envir\market_def”文件夹，NPC位置配置在“Mir200\Envir\MerChant.txt”中。
核心语法结构与命令分类
所有传奇脚本遵循“标识-条件-执行”的基础结构。完整脚本功能必须包含检测类型和执行类型两种命令。检测类型命令只能写在#IF下面，执行类型命令只能写在#ACT或#ELSEACT下面。
基础脚本结构示例：
[@main]
#IF
CHECKITEM 金条 1
#ACT
TAKE 金条 1
MAPMOVE B101
#ELSESAY
你没有金条无法进入副本！
<取消/@exit>
其中#IF是检测语句开头，#ACT是满足条件后执行的操作开头，#ELSESAY是条件不成立时的提示文本。
高频命令分为五类：
1. 物品操作命令：CHECKITEM（检测物品）、TAKE（扣除物品）、GIVE（发放物品）
2. 元宝与货币命令：CHECKGAMEGOLD（检测元宝）、GAMEGOLD+/-（增减元宝）
3. NPC对话与提示命令：#SAY（对话内容）、SENDMSG（屏幕提示）、MessageBox（弹出窗口）
4. 地图与坐标命令：MAPMOVE（传送地图）、GETMAPID（获取地图编号）
5. 变量与随机命令：VARDEFINE（定义变量）、<$RANDOM(起始结束)>（生成随机数）
变量系统与逻辑判断
变量是脚本中存储数据的容器，按作用范围分为私人变量和全局变量。私人变量如P0-P99仅在当前NPC对话中有效，关闭对话框后自动重置。U0-U49永久保存在人物数据库，用于记录任务进度。全局变量G0-G499全服通用且永久保存，适合记录攻城战倒计时等全服事件。I0-I99全服通用但下线后重置，适合临时活动计数。
逻辑判断命令包括CHECKLEVELEX（检测等级）、CHECKJOB（检测职业）、CHECKGOLD（检测金币）、CHECKBAGGAGE（检测背包空格）等。多条件组合时，默认是“且”关系，用OR表示“或”关系。条件判断需遵循“核心条件在前”原则，如先检测职业再检测等级。
NPC对话脚本制作实例
以“收集鹿肉换金币”新手任务为例，完整脚本结构如下：
在Market_Def目录创建“新手向导-0.txt”，写入基础框架：
(@main)
SAY 欢迎来到传奇世界！需要我教你生存技巧吗？
<接受任务/@start><拒绝/@exit>
(@start)
IF CHECKITEM 鹿肉 0
SAY 请帮我收集5块鹿肉，我会奖励你金币。
更复杂的新手福利NPC脚本示例：
[@main]
#IF
EQUAL <$HUMAN(FirstGet)> 0
#SAY
欢迎新手玩家！首次对话可免费领1把新手武器，重复领取需1元宝。
<免费领取新手武器/@FirstReward><了解武器属性/@WeaponIntro>
#ELSE
#SAY
你已领取过首次福利，重复领取需消耗1个元宝。
当前元宝数量：<$ITEMCOUNT(1)>
<消耗1元宝领取/@AgainReward><返回/@main>
#ENDIF
[@FirstReward]
#ACT
SETHUMAN FirstGet 1
VARDEFINE WeaponRand <$RANDOM(1 3)>
#IF
EQUAL WeaponRand 1
#ACT
GIVE 10021 1
SET S$WeaponName 铁剑
#ELSEIF
EQUAL WeaponRand 2
#ACT
GIVE 10031 1
SET S$WeaponName 木剑
#ELSE
#ACT
GIVE 10041 1
SET S$WeaponName 青铜剑
#ENDIF
SENDMSG 6 首次福利领取成功！获得【<$S$WeaponName>】1把。
MessageBox 领取成功！【<$S$WeaponName>】
怪物刷新脚本编写
怪物刷新脚本控制游戏中怪物的刷新地点、数量和刷新时间。这些脚本通常位于MirServer\Mir200\Envir\MonGen.txt文件中。格式为：地图名称 刷新地点X坐标 刷新地点Y坐标 怪物代码 刷新数量 刷新时间(秒) 范围(格子) 阵营 备注。
示例：在盟重土城安全区自动出现红包：
#IF
Random 100
#ACT
ThrowItem 3 330 330 10 红包 5
任务脚本设计要点
任务脚本是游戏核心内容，用于驱动玩家进行游戏并奖励经验、金币和装备。任务脚本通常位于MirServer\Mir200\Envir\QuestDiary目录下。设计时需使用IF、ACT和SAY命令，编写清晰的任务步骤和对话内容。关键要设置“防重复”标记，用CheckFlag/SetFlag指令控制每日领取、任务奖励等功能，避免无限触发。资源扣除需在前，#ACT中先执行Reduce（扣除）指令，再执行Give（发放）指令，防止玩家利用漏洞获取奖励。
不同引擎的语法差异
脚本语法与引擎强相关，不同引擎部分命令有差异。HERO引擎语法简洁，兼容性强，是单机和小型服务端的首选。GOM引擎功能更丰富，支持复杂特效，但部分命令与HERO不同。例如扣减元宝，HERO用GAMEGOLD-数量，GOM用DELGAMEGOLD数量。GEE引擎元宝检测需用CheckGold（部分版本），物品需用ID而非名称。编写前需查阅所用引擎的语法手册，优先使用引擎自带的脚本模板修改。
脚本调试与测试方法
编写完成后需在测试服务器验证功能。通过服务端提供的日志查看器实时监控脚本执行过程，检查变量值、错误信息。常见调试步骤：首先检查语法错误，确保所有命令格式正确；其次验证参数准确性，确认物品ID、怪物ID、地图编号与配置文件一致；然后测试逻辑流程，模拟玩家操作验证条件判断与执行顺序；最后检查反馈机制，确保提示信息清晰准确。
常见错误与解决方法
脚本执行无反应时，首先检查NPC脚本文件是否放置在正确目录（Mir200\Envir\market_def）。确认MerChant.txt中NPC坐标配置正确。检查命令语法，确保#IF、#ACT、#SAY等关键字使用正确。验证物品名称是否与Item.txt中完全一致，避免错别字。多条件顺序需按“核心条件在前”排列。每个脚本分支末尾需加BREAK，避免逻辑溢出。
脚本优化与性能考虑
编写高效脚本需注意服务器性能负担。避免在脚本中使用过多循环和延迟命令。复杂功能可拆分为多个简单脚本分段执行。使用变量存储中间结果，减少重复计算。定期清理无用变量和标记。备份脚本文件，防止数据丢失。对于频繁触发的脚本（如登录触发、攻击触发），代码应尽量简洁，减少资源占用。
进阶功能实现
通过组合基础命令可实现复杂功能。例如自动拾取功能需结合地图物品检测、坐标移动、物品拾取命令。自动战斗功能需检测最近怪物、计算攻击距离、使用技能序列。定时活动脚本需使用TimeRecall（时间限制）和Delaygoto（延迟跳转）命令。全服公告可使用Speak或LineMsg命令。称号系统需配置FengHaos.DB数据库，使用GIVEFENGHAO命令发放称号。
脚本编写核心设计思路
传奇脚本编写的核心是“精准判断条件+明确执行动作+完善容错逻辑”。#IF与#ACT的组合是基础，需根据场景灵活搭配货币、物品、属性等检测指令。实战中要注重玩家体验，通过细分提示让玩家清晰感知触发结果。同时规避语法错误与逻辑漏洞，确保功能稳定运行。新手可从简单场景（如元宝兑换）入手，熟练后再尝试多条件组合（如装备合成、职业福利），逐步积累开发经验。
