一、传奇脚本代码基础：核心命令格式与逻辑
传奇脚本代码以“条件判断-执行操作”为核心逻辑，常用命令由前缀标识功能，语法简洁且针对性强，适配主流GOM、GEE、HERO等引擎。掌握#IF（条件判断）、#ACT（执行操作）两大核心前缀，是编写和修改脚本的基础。
1. 核心前缀：#IF与#ACT的基础作用
#IF为条件判断前缀，用于设定脚本执行的前提，紧跟其后的是具体检测条件，如元宝数量、角色等级、物品持有情况等，只有当条件成立时，#ACT后的执行命令才会生效。#ACT为执行操作前缀，用于定义条件满足后触发的具体行为，如发放道具、扣除资源、传送地图等。
基础格式示例：
#IF //条件判断开始
CheckGameGold > 99 //检测角色元宝数量是否大于99个
#ACT //条件成立后执行操作开始
Give Gold 10 //给予角色10个元宝
SendMsg 6 恭喜！元宝数量达标，获得额外奖励 //在游戏内发送提示信息
该示例中，只有当角色元宝数超过99时，才会触发“给予10元宝”和“发送提示”两个操作，逻辑清晰且执行高效。
2. 常用检测命令：与#IF搭配的核心条件
检测命令是#IF的核心组成，需根据需求选择对应命令，确保条件判断精准。以下为高频检测命令及用法，适配多数传奇引擎：
- 资源检测：除CheckGameGold（检测元宝）外，CheckGold（检测金币）、CheckBaoShi（检测宝石）也常用，格式均为“命令 比较符号 数值”，如CheckGold > 1000（金币大于1000）、CheckBaoShi = 5（宝石数量等于5）。
- 角色信息检测：CheckLevel（检测等级）格式为CheckLevel > 30（等级大于30级）；CheckJob（检测职业）对应战士1、法师2、道士3，如CheckJob = 1（战士职业）；CheckSex（检测性别）1为男、2为女，如CheckSex = 2（女性角色）。
- 物品检测：CheckItem（检测是否持有物品）格式为CheckItem 屠龙 1（持有至少1把屠龙）；CheckItemCount（检测物品数量）如CheckItemCount 强效红药 > 20（强效红药超过20个）。
- 状态检测：CheckSlayCount（检测杀怪数量）如CheckSlayCount 僵尸 10（已击杀10只僵尸）；CheckMap（检测当前地图）如CheckMap 蜈蚣洞（当前处于蜈蚣洞地图）。
3. 条件组合：多前提的逻辑关联方式
实际脚本中常需多条件判断，通过“&&”（与）、“||”（或）实现逻辑关联，满足复杂场景需求。“&&”代表所有条件同时成立才生效，“||”代表任意一个条件成立即可生效。
#IF //多条件“与”逻辑
CheckLevel > 40 //等级超40级
&& CheckJob = 2 //法师职业
&& CheckItem 骨玉权杖 1 //持有骨玉权杖
#ACT
Give 法神头盔 1 //发放法神头盔
SendMsg 6 法师强者专属奖励已发放 //发送职业专属提示
#IF //多条件“或”逻辑
CheckGameGold > 500 //元宝超500
|| CheckItem 金砖 3 //持有3块金砖
#ACT
MapMove 沙巴克 320 330 //传送至沙巴克指定坐标
SendMsg 6 已传送至沙巴克，准备攻城！
二、高频执行命令：#ACT后的核心操作代码
#ACT后的执行命令直接对应游戏内行为，涵盖资源变动、地图传送、物品操作等核心功能，不同引擎命令格式略有差异，以下以通用格式为主，适配多数场景。
1. 资源操作命令：元宝、金币的增减与转换
资源操作是脚本核心功能之一，命令需明确操作类型（增加/扣除）、资源类型及数量，避免出现数据异常。
- 增加资源：Give Gold 数值（增加金币）、Give GameGold 数值（增加元宝），如Give Gold 5000（增加5000金币）、Give GameGold 20（增加20元宝）。
- 扣除资源：Take Gold 数值（扣除金币）、Take GameGold 数值（扣除元宝），如Take GameGold 50（扣除50元宝），需注意扣除前需用#IF检测资源充足。
- 资源转换：Convert Gold 1000 GameGold 1（1000金币转换为1元宝），转换比例可根据脚本需求调整。
2. 物品操作命令：发放、回收与属性修改
物品操作需精准对应物品名称（与游戏内完全一致），避免因名称错误导致操作失效，部分命令支持批量操作。
- 发放物品：Give 物品名称 数量，如Give 强效红药 50（发放50个强效红药）、Give 裁决之杖 1（发放1把裁决之杖）。
- 回收物品：Take 物品名称 数量，如Take 白色装备 10（回收10件白色装备），可搭配CheckItemCount实现“有则回收”逻辑。
- 物品属性修改：ChangeItemAttr 物品名称 属性 数值，如ChangeItemAttr 屠龙 攻击 5（将屠龙攻击属性+5），仅部分引擎支持该命令。
3. 地图与角色操作：传送、等级与状态调整
这类命令直接影响角色在游戏内的位置和状态，是任务脚本、挂机脚本的核心组成部分。
- 地图传送：MapMove 地图名称 X坐标 Y坐标，如MapMove 猪洞七层 250 260（传送至猪洞七层对应坐标），坐标需通过游戏内F12地图功能查看。
- 等级调整：ChangeLevel 数值（直接设置等级）、AddLevel 数值（等级增加），如AddLevel 3（等级+3），常用于新手任务奖励。
- 状态附加：AddBuff 状态ID 持续时间，如AddBuff 1 300（附加1号状态，持续300秒），状态ID需参考引擎状态列表。
4. 信息提示命令：游戏内反馈与引导
提示命令用于向玩家传递脚本执行结果，提升操作体验，支持不同颜色和显示位置的设置。
- 普通提示：SendMsg 颜色代码 提示内容，颜色代码1-255对应不同颜色，常用6为黄色、14为红色，如SendMsg 6 任务已完成，前往NPC处领奖（黄色提示）。
- 顶部提示：SendTopMsg 提示内容 持续时间，如SendTopMsg 恭喜获得稀有装备！ 5（顶部显示提示5秒）。
- 对话框提示：OpenDialog 对话框ID，调用游戏内预设对话框，需提前在引擎中配置对话框内容。
三、实战脚本代码实例：覆盖日常与核心玩法
结合传奇核心玩法，以下实例涵盖日常任务、资源兑换、BOSS奖励等高频场景，代码可直接修改参数后使用，适配GOM、GEE引擎。
1. 日常签到脚本：等级达标领奖励
功能：等级≥30级的角色签到，可领取金币、药水奖励，每日限1次（通过检测变量实现）。
#IF //签到条件
CheckLevel >= 30 //等级达标
&& CheckVar 签到变量 0 //未签到（变量初始为0，签到后设为1）
#ACT //执行签到奖励
Give Gold 10000 //1万金币
Give 强效红药 30 //30个红药
Give 强效蓝药 20 //20个蓝药
SetVar 签到变量 1 //标记为已签到
SendMsg 6 今日签到成功，奖励已发放至背包！
#ELSEACT //条件不成立时执行
SendMsg 14 签到失败！等级不足30级或今日已签到
2. 元宝兑换装备脚本：精准扣除与发放
功能：消耗指定数量元宝兑换对应职业装备，支持战士、法师、道士三职业区分。
#IF //战士兑换条件
CheckJob = 1 //战士职业
&& CheckGameGold >= 200 //元宝≥200
#ACT
Take GameGold 200 //扣除200元宝
Give 圣战套装 1 //发放圣战套装
SendMsg 6 战士专属圣战套装兑换成功！
#ELSEIF //法师兑换条件
CheckJob = 2 //法师职业
&& CheckGameGold >= 200 //元宝≥200
#ACT
Take GameGold 200
Give 法神套装 1
SendMsg 6 法师专属法神套装兑换成功！
#ELSEIF //道士兑换条件
CheckJob = 3 //道士职业
&& CheckGameGold >= 200 //元宝≥200
#ACT
Take GameGold 200
Give 天尊套装 1
SendMsg 6 道士专属天尊套装兑换成功！
#ELSEACT //条件不成立
SendMsg 14 兑换失败！职业不符或元宝不足
3. BOSS击杀奖励脚本：触发式资源发放
功能：击杀指定BOSS（如沃玛教主）后，自动发放元宝、稀有材料奖励，支持多角色共享检测。
#IF //BOSS击杀条件
CheckSlayCount 沃玛教主 1 //已击杀1只沃玛教主
&& CheckMap 沃玛寺庙 //在沃玛寺庙地图
#ACT
Give GameGold 50 //50元宝奖励
Give 沃玛号角 1 //稀有材料
ClearSlayCount 沃玛教主 //清空杀怪计数（避免重复领奖）
SendMsg 6 成功击杀沃玛教主，获得丰厚奖励！
MapMove 土城 300 320 //自动传送回土城
#ELSEACT
SendMsg 14 未满足奖励条件，请先击杀沃玛教主
四、脚本代码编写与调试技巧：避免常见错误
传奇脚本代码对格式和逻辑要求严格，微小错误可能导致脚本失效，掌握编写规范和调试方法可大幅提升效率。
1. 编写规范：格式与细节把控
- 命令大小写统一：脚本命令不区分大小写，但建议全大写（如#IF、#ACT），避免与变量混淆，提升可读性。
- 物品名称精准：物品名称需与游戏内完全一致，包括特殊符号（如“裁决之杖”不可写为“裁决”），可通过引擎“物品列表”复制名称。
- 注释清晰：用“//”添加注释，标注条件和操作目的，如//检测等级与职业，后续修改时便于理解逻辑。
- 变量初始化：使用变量（如签到变量）前，需在引擎“变量管理”中设置初始值，避免变量未定义导致脚本报错。
2. 调试技巧：快速定位错误
- 分段测试：复杂脚本按“条件-执行”分段测试，先单独测试#IF条件是否生效（可通过SendMsg提示），再测试#ACT操作，逐步缩小错误范围。
- 引擎日志查看：在引擎“日志管理”中开启“脚本日志”，脚本执行失败时，日志会显示错误原因（如“物品名称错误”“变量未定义”）。
- 简化测试：将复杂条件简化为单一条件（如仅检测元宝数量），确认基础逻辑生效后，再添加多条件组合，避免多因素干扰。
- 坐标与地图验证：地图传送命令调试时，先在游戏内到达目标位置，记录坐标后填入脚本，避免坐标错误导致传送失败。
五、不同引擎代码差异：适配GOM、GEE、HERO核心区别
主流传奇引擎脚本核心逻辑一致，但部分命令格式存在差异，编写时需根据服务器所用引擎调整，避免功能失效。
功能需求
GOM引擎命令
GEE引擎命令
HERO引擎命令
检测元宝
CheckGameGold > 数值
CheckYB > 数值
CheckYuanBao > 数值
增加元宝
Give GameGold 数值
GiveYB 数值
GiveYuanBao 数值
地图传送
MapMove 地图名 X Y
@MapMove 地图ID X Y
MoveMap 地图名 X Y
设置变量
SetVar 变量名 数值
@SetVar 变量名 数值
VarSet 变量名 数值
引擎差异可通过官方文档查询，或在脚本平台筛选对应引擎的脚本模板，修改参数后使用，降低适配难度。
传奇脚本核心代码解析 基础命令与实战实例全教程
来源：
作者：
点击：