##一、脚本体系核心结构
###1.1基础框架三要素
传奇脚本采用事件驱动结构，由三大核心标签构成完整逻辑：
```lua
#IF--条件检测模块（类似编程中的if语句）
checkjobWarrior--检测玩家是否为战士
checkgold10000--检测金币≥1万
#ACT--执行动作模块
take金币10000--扣除金币
give屠龙1--给予屠龙刀
#SAY--对话显示模块
<$USERNAME>，你已获得绝世神兵！\--显示玩家名称
<关闭对话/@exit>
```
（图1：任务奖励发放脚本示例）
###1.2扩展控制语句
|命令|作用描述|使用场景示例|
|--------------|---------------------------|--------------------------------|
|#ELSESAY|条件不成立时显示内容|任务未达成提示|
|BREAK|强制终止当前脚本段|防止重复触发奖励|
|GOTO@标签|跳转到指定段落|复杂任务多分支跳转|
|CALL|调用子程序|通用功能模块复用|
##二、条件检测命令大全
###2.1角色属性检测
```lua
CHECKLEVELEX>50--等级＞50级
CHECKCREDITPOINT100--声望=100点
CHECKJOBTaoist--职业为道士
CHECKPKPOINT10--PK值≥10点（需M2支持）
```
###2.2物品与货币检测
```lua
CHECKITEM回城卷5--背包有5个回城卷
CHECKGOLD5000000--携带500万金币
CHECKBAGGAGE--背包剩余空间检测
CHECKUSEITEM手镯--正在佩戴手镯
```
###2.3环境状态检测
```lua
CHECKHUM盟重省100--盟重地图玩家≥100人
CHECKMONMAP祖玛寺庙--当前地图存在怪物
DAYTIME--游戏内为白天时段
```
##三、功能操作命令详解
###3.1角色管理
```lua
CHANGEEXP+500000--增加50万经验
CHANGEPK+100--增加100点PK值
KILLSLAVE--清除所有召唤物
```
###3.2地图传送
```lua
MAPMOVE0330268--传送到比奇安全区
TIMERECALL60--60秒后自动传出
GROUPMAPMOVE祖玛7--全队传送至祖玛7层
```
###3.3怪物控制
```lua
MONGEN祖玛教主1--刷新1只祖玛教主
MONGENEX325268赤月恶魔1--指定坐标刷怪
MONCLEAR石墓阵--清空该地图所有怪物
```
##四、变量系统深度解析
###4.1变量类型对照表
|变量前缀|存储范围|数据持久性|典型应用场景|
|---------|----------------|------------|---------------------|
|P0-P9|玩家私有|会话级|临时任务状态标记|
|D0-D9|全局动态|重启重置|全服活动计数|
|G0-G499|服务器永久|永久保存|全服成就记录|
|A0-A499|账号跨角色|账号绑定|账号仓库系统|
###4.2变量运算实例
```lua
#IF
LARGEG1001000--检测G100＞1000
#ACT
INCG10050--G100增加50
MULP52--P5乘以2
DIVD35--D3除以5
```
##五、进阶脚本开发技巧
###5.1复杂任务系统架构
```lua
[@主线任务]
#IF
CHECK[310]1--已完成前置任务
CHECKITEM推荐信1
#ACT
SET[311]1--激活当前任务
MOVRP1110--随机数赋值
#SAY
请根据线索<$STR(P1)>寻找...
[@分支A]
#IF
EQUALP15--随机数为5时触发
#ACT
GIVE神秘钥匙1
GOTO@密室入口
[@分支B]
#IF
SMALLP15--随机数＜5
#ACT
GIVE解毒剂3
BREAK
```
###5.2全服活动模板
```lua
[@攻城战开始]
#IF
EQUALG2010--检测活动未开启
#ACT
SETG2011--激活全服状态
SENDMSG0"[全服公告]沙巴克攻城战开始！"
MONGENEX3330268攻城指挥官1
ADDTIMER1800@结束攻城
[@结束攻城]
#ACT
SETG2010
MONCLEAR沙巴克皇宫
SENDMSG0"本次攻城战已结束"
```
##六、调试与规范建议
###6.1排错三板斧
1.**日志追踪法**：在关键节点插入`SENDMSG7"当前变量G100值：<$STR(G100)>"`
2.**断点调试法**：使用`BREAK`命令分段测试
3.**模拟验证法**：通过GM命令`@MAKE金币1000000`快速测试
###6.2开发规范建议
1.**命名规范**：采用[任务编号]_[功能]格式，如`[305_戒指任务]`
2.**注释规范**：关键逻辑需添加`;==VIP系统触发条件==`
3.**安全防护**：重要操作前添加`CHECKBAGGAGE`防止物品丢失
##七、实战开发资源
1.**引擎帮助文档**：GOM引擎帮助文档.chm（含完整API）
2.**开源项目参考**：GitHub上的"Mir2-Script-Library"项目
3.**调试工具集**：PacketViewer网络封包分析器
>本教程综合20+份官方文档与实战案例，建议配合M2引擎帮助文档()进行拓展学习。掌握300+基础命令后，可尝试开发自动挂机()、跨服竞技场()等高级系统。
###1.1基础框架三要素
传奇脚本采用事件驱动结构，由三大核心标签构成完整逻辑：
```lua
#IF--条件检测模块（类似编程中的if语句）
checkjobWarrior--检测玩家是否为战士
checkgold10000--检测金币≥1万
#ACT--执行动作模块
take金币10000--扣除金币
give屠龙1--给予屠龙刀
#SAY--对话显示模块
<$USERNAME>，你已获得绝世神兵！\--显示玩家名称
<关闭对话/@exit>
```
（图1：任务奖励发放脚本示例）
###1.2扩展控制语句
|命令|作用描述|使用场景示例|
|--------------|---------------------------|--------------------------------|
|#ELSESAY|条件不成立时显示内容|任务未达成提示|
|BREAK|强制终止当前脚本段|防止重复触发奖励|
|GOTO@标签|跳转到指定段落|复杂任务多分支跳转|
|CALL|调用子程序|通用功能模块复用|
##二、条件检测命令大全
###2.1角色属性检测
```lua
CHECKLEVELEX>50--等级＞50级
CHECKCREDITPOINT100--声望=100点
CHECKJOBTaoist--职业为道士
CHECKPKPOINT10--PK值≥10点（需M2支持）
```
###2.2物品与货币检测
```lua
CHECKITEM回城卷5--背包有5个回城卷
CHECKGOLD5000000--携带500万金币
CHECKBAGGAGE--背包剩余空间检测
CHECKUSEITEM手镯--正在佩戴手镯
```
###2.3环境状态检测
```lua
CHECKHUM盟重省100--盟重地图玩家≥100人
CHECKMONMAP祖玛寺庙--当前地图存在怪物
DAYTIME--游戏内为白天时段
```
##三、功能操作命令详解
###3.1角色管理
```lua
CHANGEEXP+500000--增加50万经验
CHANGEPK+100--增加100点PK值
KILLSLAVE--清除所有召唤物
```
###3.2地图传送
```lua
MAPMOVE0330268--传送到比奇安全区
TIMERECALL60--60秒后自动传出
GROUPMAPMOVE祖玛7--全队传送至祖玛7层
```
###3.3怪物控制
```lua
MONGEN祖玛教主1--刷新1只祖玛教主
MONGENEX325268赤月恶魔1--指定坐标刷怪
MONCLEAR石墓阵--清空该地图所有怪物
```
##四、变量系统深度解析
###4.1变量类型对照表
|变量前缀|存储范围|数据持久性|典型应用场景|
|---------|----------------|------------|---------------------|
|P0-P9|玩家私有|会话级|临时任务状态标记|
|D0-D9|全局动态|重启重置|全服活动计数|
|G0-G499|服务器永久|永久保存|全服成就记录|
|A0-A499|账号跨角色|账号绑定|账号仓库系统|
###4.2变量运算实例
```lua
#IF
LARGEG1001000--检测G100＞1000
#ACT
INCG10050--G100增加50
MULP52--P5乘以2
DIVD35--D3除以5
```
##五、进阶脚本开发技巧
###5.1复杂任务系统架构
```lua
[@主线任务]
#IF
CHECK[310]1--已完成前置任务
CHECKITEM推荐信1
#ACT
SET[311]1--激活当前任务
MOVRP1110--随机数赋值
#SAY
请根据线索<$STR(P1)>寻找...
[@分支A]
#IF
EQUALP15--随机数为5时触发
#ACT
GIVE神秘钥匙1
GOTO@密室入口
[@分支B]
#IF
SMALLP15--随机数＜5
#ACT
GIVE解毒剂3
BREAK
```
###5.2全服活动模板
```lua
[@攻城战开始]
#IF
EQUALG2010--检测活动未开启
#ACT
SETG2011--激活全服状态
SENDMSG0"[全服公告]沙巴克攻城战开始！"
MONGENEX3330268攻城指挥官1
ADDTIMER1800@结束攻城
[@结束攻城]
#ACT
SETG2010
MONCLEAR沙巴克皇宫
SENDMSG0"本次攻城战已结束"
```
##六、调试与规范建议
###6.1排错三板斧
1.**日志追踪法**：在关键节点插入`SENDMSG7"当前变量G100值：<$STR(G100)>"`
2.**断点调试法**：使用`BREAK`命令分段测试
3.**模拟验证法**：通过GM命令`@MAKE金币1000000`快速测试
###6.2开发规范建议
1.**命名规范**：采用[任务编号]_[功能]格式，如`[305_戒指任务]`
2.**注释规范**：关键逻辑需添加`;==VIP系统触发条件==`
3.**安全防护**：重要操作前添加`CHECKBAGGAGE`防止物品丢失
##七、实战开发资源
1.**引擎帮助文档**：GOM引擎帮助文档.chm（含完整API）
2.**开源项目参考**：GitHub上的"Mir2-Script-Library"项目
3.**调试工具集**：PacketViewer网络封包分析器
>本教程综合20+份官方文档与实战案例，建议配合M2引擎帮助文档()进行拓展学习。掌握300+基础命令后，可尝试开发自动挂机()、跨服竞技场()等高级系统。