## 一、脚本体系核心结构
### 1.1 基础框架三要素
传奇脚本采用事件驱动结构，由三大核心标签构成完整逻辑：
```lua
#IF -- 条件检测模块（类似编程中的if语句）
checkjob Warrior -- 检测玩家是否为战士
checkgold 10000 -- 检测金币≥1万
#ACT -- 执行动作模块
take 金币 10000 -- 扣除金币
give 屠龙 1 -- 给予屠龙刀
#SAY -- 对话显示模块
<$USERNAME>，你已获得绝世神兵！\ -- 显示玩家名称
<关闭对话/@exit>
```
（图1：任务奖励发放脚本示例 ）
### 1.2 扩展控制语句
| 命令 | 作用描述 | 使用场景示例 |
|--------------|---------------------------|--------------------------------|
| #ELSESAY | 条件不成立时显示内容 | 任务未达成提示 |
| BREAK | 强制终止当前脚本段 | 防止重复触发奖励 |
| GOTO @标签 | 跳转到指定段落 | 复杂任务多分支跳转 |
| CALL | 调用子程序 | 通用功能模块复用 |
## 二、条件检测命令大全
### 2.1 角色属性检测
```lua
CHECKLEVELEX > 50 -- 等级＞50级
CHECKCREDITPOINT 100 -- 声望=100点
CHECKJOB Taoist -- 职业为道士
CHECKPKPOINT 10 -- PK值≥10点（需M2支持）
```
### 2.2 物品与货币检测
```lua
CHECKITEM 回城卷 5 -- 背包有5个回城卷
CHECKGOLD 5000000 -- 携带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
MAPMOVE 0 330 268 -- 传送到比奇安全区
TIMERECALL 60 -- 60秒后自动传出
GROUPMAPMOVE 祖玛7 -- 全队传送至祖玛7层
```
### 3.3 怪物控制
```lua
MONGEN 祖玛教主 1 -- 刷新1只祖玛教主
MONGENEX 325 268 赤月恶魔 1 -- 指定坐标刷怪
MONCLEAR 石墓阵 -- 清空该地图所有怪物
```
## 四、变量系统深度解析
### 4.1 变量类型对照表
| 变量前缀 | 存储范围 | 数据持久性 | 典型应用场景 |
|---------|----------------|------------|---------------------|
| P0-P9 | 玩家私有 | 会话级 | 临时任务状态标记 |
| D0-D9 | 全局动态 | 重启重置 | 全服活动计数 |
| G0-G499 | 服务器永久 | 永久保存 | 全服成就记录 |
| A0-A499 | 账号跨角色 | 账号绑定 | 账号仓库系统 |
### 4.2 变量运算实例
```lua
#IF
LARGE G100 1000 -- 检测G100＞1000
#ACT
INC G100 50 -- G100增加50
MUL P5 2 -- P5乘以2
DIV D3 5 -- D3除以5
```
## 五、进阶脚本开发技巧
### 5.1 复杂任务系统架构
```lua
[@主线任务]
#IF
CHECK [310] 1 -- 已完成前置任务
CHECKITEM 推荐信 1
#ACT
SET [311] 1 -- 激活当前任务
MOVR P1 1 10 -- 随机数赋值
#SAY
请根据线索<$STR(P1)>寻找...
[@分支A]
#IF
EQUAL P1 5 -- 随机数为5时触发
#ACT
GIVE 神秘钥匙 1
GOTO @密室入口
[@分支B]
#IF
SMALL P1 5 -- 随机数＜5
#ACT
GIVE 解毒剂 3
BREAK
```
### 5.2 全服活动模板
```lua
[@攻城战开始]
#IF
EQUAL G201 0 -- 检测活动未开启
#ACT
SET G201 1 -- 激活全服状态
SENDMSG 0 "[全服公告] 沙巴克攻城战开始！"
MONGENEX 3 330 268 攻城指挥官 1
ADDTIMER 1800 @结束攻城
[@结束攻城]
#ACT
SET G201 0
MONCLEAR 沙巴克皇宫
SENDMSG 0 "本次攻城战已结束"
```
## 六、调试与规范建议
### 6.1 排错三板斧
1. **日志追踪法**：在关键节点插入`SENDMSG 7 "当前变量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语句）
checkjob Warrior -- 检测玩家是否为战士
checkgold 10000 -- 检测金币≥1万
#ACT -- 执行动作模块
take 金币 10000 -- 扣除金币
give 屠龙 1 -- 给予屠龙刀
#SAY -- 对话显示模块
<$USERNAME>，你已获得绝世神兵！\ -- 显示玩家名称
<关闭对话/@exit>
```
（图1：任务奖励发放脚本示例 ）
### 1.2 扩展控制语句
| 命令 | 作用描述 | 使用场景示例 |
|--------------|---------------------------|--------------------------------|
| #ELSESAY | 条件不成立时显示内容 | 任务未达成提示 |
| BREAK | 强制终止当前脚本段 | 防止重复触发奖励 |
| GOTO @标签 | 跳转到指定段落 | 复杂任务多分支跳转 |
| CALL | 调用子程序 | 通用功能模块复用 |
## 二、条件检测命令大全
### 2.1 角色属性检测
```lua
CHECKLEVELEX > 50 -- 等级＞50级
CHECKCREDITPOINT 100 -- 声望=100点
CHECKJOB Taoist -- 职业为道士
CHECKPKPOINT 10 -- PK值≥10点（需M2支持）
```
### 2.2 物品与货币检测
```lua
CHECKITEM 回城卷 5 -- 背包有5个回城卷
CHECKGOLD 5000000 -- 携带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
MAPMOVE 0 330 268 -- 传送到比奇安全区
TIMERECALL 60 -- 60秒后自动传出
GROUPMAPMOVE 祖玛7 -- 全队传送至祖玛7层
```
### 3.3 怪物控制
```lua
MONGEN 祖玛教主 1 -- 刷新1只祖玛教主
MONGENEX 325 268 赤月恶魔 1 -- 指定坐标刷怪
MONCLEAR 石墓阵 -- 清空该地图所有怪物
```
## 四、变量系统深度解析
### 4.1 变量类型对照表
| 变量前缀 | 存储范围 | 数据持久性 | 典型应用场景 |
|---------|----------------|------------|---------------------|
| P0-P9 | 玩家私有 | 会话级 | 临时任务状态标记 |
| D0-D9 | 全局动态 | 重启重置 | 全服活动计数 |
| G0-G499 | 服务器永久 | 永久保存 | 全服成就记录 |
| A0-A499 | 账号跨角色 | 账号绑定 | 账号仓库系统 |
### 4.2 变量运算实例
```lua
#IF
LARGE G100 1000 -- 检测G100＞1000
#ACT
INC G100 50 -- G100增加50
MUL P5 2 -- P5乘以2
DIV D3 5 -- D3除以5
```
## 五、进阶脚本开发技巧
### 5.1 复杂任务系统架构
```lua
[@主线任务]
#IF
CHECK [310] 1 -- 已完成前置任务
CHECKITEM 推荐信 1
#ACT
SET [311] 1 -- 激活当前任务
MOVR P1 1 10 -- 随机数赋值
#SAY
请根据线索<$STR(P1)>寻找...
[@分支A]
#IF
EQUAL P1 5 -- 随机数为5时触发
#ACT
GIVE 神秘钥匙 1
GOTO @密室入口
[@分支B]
#IF
SMALL P1 5 -- 随机数＜5
#ACT
GIVE 解毒剂 3
BREAK
```
### 5.2 全服活动模板
```lua
[@攻城战开始]
#IF
EQUAL G201 0 -- 检测活动未开启
#ACT
SET G201 1 -- 激活全服状态
SENDMSG 0 "[全服公告] 沙巴克攻城战开始！"
MONGENEX 3 330 268 攻城指挥官 1
ADDTIMER 1800 @结束攻城
[@结束攻城]
#ACT
SET G201 0
MONCLEAR 沙巴克皇宫
SENDMSG 0 "本次攻城战已结束"
```
## 六、调试与规范建议
### 6.1 排错三板斧
1. **日志追踪法**：在关键节点插入`SENDMSG 7 "当前变量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+基础命令后，可尝试开发自动挂机()、跨服竞技场()等高级系统。