传奇游戏脚本命令的用法以及变量的详细解释

39传奇素材网

传奇游戏脚本（如 HERO、GEE、GOM 等引擎）是控制游戏逻辑的核心，通过命令和变量实现 NPC 对话、任务系统、怪物行为、物品交互等功能。以下是常用脚本命令用法及变量详细解释，以主流引擎通用语法为例：
一、基础脚本命令（按功能分类）
1. 对话与交互命令
用于 NPC 与玩家的文字交互，是脚本最基础的功能。

命令        语法格式        功能说明        示例
@Say        @Say 文字内容        NPC 发送对话文字（支持换行符\n）        @Say 欢迎来到比奇城！\n需要帮助吗？
@Option        @Option 选项文字 [跳转标签]        显示可点击的选项，点击后跳转到指定标签        @Option 我要接任务 @Task
@Close        @Close        关闭对话窗口        @Close
@SendMsg        @SendMsg 颜色代码 文字        向玩家发送系统提示（颜色代码：1 - 白，2 - 绿等）        @SendMsg 2 你获得了100金币！
2. 物品与道具操作
控制物品的给予、删除、检查等。

命令        语法格式        功能说明        示例
@Give        @Give 物品名称 / ID 数量        给玩家物品（支持物品名称或数据库 ID）        @Give 金币 1000 或 @Give 1 10（1 为金币 ID）
@Take        @Take 物品名称 / ID 数量        从玩家背包删除物品        @Take 疗伤药 5
@CheckItem        @CheckItem 物品名称 / ID 数量        检查玩家是否有指定物品（返回布尔值）        #IF CheckItem 裁决之杖 1（条件判断中使用）
@GemUp        @GemUp 装备位置 宝石数量        装备强化（位置：0 - 武器，1 - 头盔等）        @GemUp 0 3（用 3 颗宝石强化武器）
3. 任务系统命令
实现任务接取、进度更新、完成奖励等逻辑。

命令        语法格式        功能说明        示例
@AcceptTask        @AcceptTask 任务 ID        玩家接取指定 ID 的任务        @AcceptTask 101（接取 ID 为 101 的任务）
@FinishTask        @FinishTask 任务 ID        玩家完成指定任务（需先接取）        @FinishTask 101
@SetTaskVar        @SetTaskVar 任务 ID 变量名 值        设置任务变量（记录进度，如杀怪数量）        @SetTaskVar 101 KillCount 5（任务 101 的杀怪数设为 5）
@GetTaskVar        @GetTaskVar 任务 ID 变量名        获取任务变量值（用于条件判断）        #IF GetTaskVar 101 KillCount >= 10
4. 传送与地图命令
控制玩家移动、地图切换。

命令        语法格式        功能说明        示例
@MapMove        @MapMove 地图编号 X 坐标 Y 坐标        传送玩家到指定地图的坐标        @MapMove 0 330 340（传送到比奇城 330,340）
@RandomMove        @RandomMove 地图编号 范围 X 范围 Y        在指定地图随机传送（范围内）        @RandomMove 1 100 200（在盟重 100-200 坐标间随机传）
@BackMap        @BackMap        传送玩家回上次地图        @BackMap
5. 战斗与状态命令
控制玩家属性、怪物行为、战斗状态。

命令        语法格式        功能说明        示例
@ChangeLevel        @ChangeLevel 等级变化值        增加 / 减少玩家等级（正数加，负数减）        @ChangeLevel 5（升 5 级）
@ChangeExp        @ChangeExp 经验值        增加玩家经验        @ChangeExp 10000
@Monster        @Monster 怪物名称 数量 X Y 地图        在指定位置刷出怪物        @Monster 沃玛卫士 3 320 330 0（在比奇刷 3 只沃玛卫士）
@KillMonster        @KillMonster 怪物名称 数量        检查玩家是否杀死指定数量的怪物        #IF KillMonster 骷髅精灵 5
二、变量系统详解（按作用域分类）
变量用于存储临时数据（如任务进度、玩家状态、全局计数等），不同变量的作用域（有效范围）不同。
1. 玩家变量（仅对单个玩家有效）
存储玩家个人数据，如等级、背包物品、任务进度等，引擎内置了大量玩家变量，也支持自定义。

变量类型        格式 / 示例        说明
内置玩家变量        <USERNAME>        玩家角色名
<USERLEVEL>        玩家当前等级
<USERGOLD>        玩家当前金币数量
<USERPKPOINT>        玩家 PK 值
自定义玩家变量        <USER 变量名>        需用@SetVar设置，仅当前玩家可见
示例：@SetVar USER TaskProgress 3（设置玩家的任务进度为 3）       
2. 全局变量（对全服所有玩家有效）
存储全服共享的数据，如活动开启状态、全服杀怪总数等，所有玩家和 NPC 都能访问。

变量类型        格式 / 示例        说明
内置全局变量        <SERVERNAME>        服务器名称
<ONLINECOUNT>        当前在线人数
自定义全局变量        <GLOBAL 变量名>        需用@SetVar设置，全服可见
示例：@SetVar GLOBAL EventOpen 1（设置活动开启状态为 1，1 = 开启，0 = 关闭）       
3. 任务变量（绑定任务 ID，仅对任务有效）
用于记录单个任务的进度（如杀怪数量、物品收集状态），作用域为 “玩家 + 任务 ID”。

格式示例        说明
<TASK 任务ID 变量名>        需用@SetTaskVar设置，仅对应任务有效
示例：<TASK 101 KillCount>        任务 101 的 “杀怪数量” 变量
4. 临时变量（仅在当前脚本段有效）
用于脚本内部临时计算，脚本执行完毕后失效，无需提前定义。

格式示例        说明
<TEMP 变量名>        仅在当前 NPC 脚本或命令块中有效
示例：@SetVar TEMP TempNum 10        临时存储数字 10，用于后续计算
5. 怪物 / 物品变量（绑定实体）
用于记录特定怪物或物品的状态（如怪物血量、物品是否被拾取）。

格式示例        说明
<MONSTER 怪物ID HP>        怪物当前血量（ID 为刷怪时的唯一标识）
<ITEM 物品ID 数量>        物品剩余数量（ID 为物品生成时的标识）
三、脚本逻辑控制（条件与循环）
脚本通过#IF（条件）和#ACT（执行）实现逻辑判断，结合变量使用。
基础语法结构：
text
#IF
条件1 （如：CheckItem 疗伤药 1）
条件2 （如：USERLEVEL >= 30）
#ACT
执行命令1 （如：@Take 疗伤药 1）
执行命令2 （如：@Give 金币 500）
#ELSE
执行命令3 （条件不满足时执行）
示例：简单任务脚本
text
// NPC：比奇老兵（对话脚本）
@Say 你能帮我清除5只骷髅怪吗？\n完成后我会奖励你1000金币！
@Option 接受任务 @Accept
@Option 拒绝 @Close

[@Accept]
#IF
CheckTask 101 == 0 （检查是否未接任务101）
#ACT
@AcceptTask 101 （接取任务）
@SetTaskVar 101 KillCount 0 （初始化杀怪数为0）
@SendMsg 2 任务已接取！去杀死5只骷髅怪吧！
#ELSE
@SendMsg 1 你已经接取过这个任务了！

[@Finish]
#IF
GetTaskVar 101 KillCount >=5 （检查杀怪数是否达标）
#ACT
@FinishTask 101 （完成任务）
@Give 金币 1000
@SendMsg 2 任务完成！获得1000金币奖励！
#ELSE
@SendMsg 1 还需要杀死更多骷髅怪才能完成任务！



四、注意事项
引擎差异：不同引擎（如 HERO vs GEE）的命令和变量格式可能略有差异，例如 GEE 支持<PLAYERVAR>替代<USER>，需参考对应引擎的官方文档。
变量命名：自定义变量名建议用英文 / 数字，避免特殊字符，且区分大小写（部分引擎）。
性能优化：全局变量频繁读写可能影响服务器性能，建议减少不必要的全局变量使用。
调试技巧：通过@SendMsg输出变量值（如@SendMsg 2 当前杀怪数：<TASK 101 KillCount>），快速定位脚本错误。

通过灵活组合命令和变量，可实现复杂的游戏逻辑，如剧情任务、活动副本、装备强化等核心玩法。