传奇脚本制作常用命令大全：功能分类+实例 新手速查速用

传奇脚本制作的核心是熟练运用各类命令实现功能逻辑，不同引擎（HeroM2、GOM等）命令略有差异，但基础功能命令通用性强。本文整理高频使用命令，按玩家、物品、怪物等维度分类，附具体实例与使用场景。

一、基础触发命令（控制脚本启动）

触发命令是脚本的“入口”，用于指定脚本在何种条件下执行，常见于NPC对话、技能释放、地图进入等场景。

命令格式

功能说明

实例

[@main]

NPC对话默认触发入口，玩家点击NPC即执行

[@main]#say 欢迎来到传奇大陆！#act SendMsg 6 0 255 0 点击领取新手礼包

[@Button1]

NPC对话按钮触发，对应玩家点击的第1个选项

[@Button1]#act GiveItem 新手剑 1 #say 新手剑已发放，请查收

#if 条件 #act 执行动作

条件判断触发，满足“条件”则执行“动作”

#if CheckLevel >=10 #act MoveMap 3 333 333 #say 等级达标，传送至土城

二、玩家状态控制命令（核心功能）

用于查询或修改玩家的等级、职业、属性、坐标等基础信息，是脚本逻辑判断的核心依据。

命令格式

功能说明

实例

CheckLevel 数值

判断玩家等级是否满足条件（支持>=<）

#if CheckLevel <20 #say 等级不足20级，无法接取此任务

CheckJob 职业ID

判断玩家职业（1战士/2法师/3道士）

#if CheckJob 1 #act GiveItem 裁决 1 #say 战士专属武器已发放

ChangeLevel 增减数值

修改玩家等级（正数提升，负数降低）

#act ChangeLevel +5 #say 完成任务，等级提升5级

MoveMap 地图ID X坐标 Y坐标

将玩家传送至指定地图的指定坐标

#act MoveMap 101 100 120 #say 传送至苍月岛

三、物品操作命令（任务与奖励核心）

涵盖物品的查询、给予、回收、检测等操作，是任务奖励、道具兑换类脚本的必备命令。

命令格式

功能说明

实例

CheckItem 物品ID 数量

检测玩家背包是否有指定数量的物品

#if CheckItem 5001 1 #act TakeItem 5001 1 #say 已消耗1个金币

GiveItem 物品ID 数量

给予玩家指定数量的物品（物品ID从DBC查询）

#act GiveItem 301 1 #say 新手铠甲已放入您的背包

TakeItem 物品ID 数量

从玩家背包回收指定数量的物品

#if CheckItem 1001 1 #act TakeItem 1001 1 GiveItem 2001 1 #say 用野猪皮兑换了疗伤药

CheckItemBind 物品ID

检测物品是否为绑定状态

#if CheckItemBind 301 #say 此装备为绑定状态，无法交易

四、怪物控制命令（刷怪与战斗相关）

用于怪物的刷新、检测、击杀判断等，是闯关地图、BOSS刷新类脚本的核心命令。

命令格式

功能说明

实例

MonGen 怪物ID 数量 X坐标 Y坐标

在指定坐标刷新指定数量的怪物

#act MonGen 201 1 150 180 #say 野猪王已刷新，请准备战斗

CheckMonsterDie 怪物ID

检测指定怪物是否被击杀

#if CheckMonsterDie 201 #act GiveItem 5001 10 #say 击杀野猪王，奖励10个金币

CheckMonsterNear 范围

检测玩家周围指定范围内是否有怪物

#if CheckMonsterNear 5 #say 5格内有怪物，请先清理

五、地图与环境命令（场景控制）

用于控制地图的人数、时间、特效等，适配闯关地图、活动地图等特殊场景需求。

命令格式

功能说明

实例

CheckMapUserCount 地图ID

检测指定地图内的玩家数量

#if CheckMapUserCount 101 >1 #say 此地图仅限1人进入，请稍候

MapTimeLimit 地图ID 分钟数

设置指定地图的停留时间限制

#act MapTimeLimit 101 30 #say 此地图停留时间限制为30分钟

MapEffect X坐标 Y坐标 特效ID

在指定坐标播放地图特效（如技能光效）

#act MapEffect <$CURRENTX> <$CURRENTY> 10 #say 释放技能特效

六、命令查询与使用技巧

1. 命令兼容性：HeroM2与GOM引擎部分命令通用，特殊命令可在引擎控制台的“帮助文档”中查询，如HeroM2的“命令手册”、GOM的“脚本命令参考”。

2. ID查询：物品、怪物、地图的ID需通过DBC数据库查询，对应文件分别为“StdItem.DB”“Monster.DB”“MapInfo.txt”。

3. 调试技巧：脚本报错时，优先检查命令格式是否正确（如空格、符号），其次确认ID是否与数据库一致，可通过引擎“脚本调试”功能定位错误行。