传奇脚本命令大全详解｜新手零基础入门全套脚本变量逻辑语句案例

对于传奇私服开发者、GM管理员以及传奇脚本爱好者来说，熟练掌握传奇脚本命令是修改游戏功能、定制NPC脚本、设置地图规则、刷新怪物以及调整游戏参数的核心基础。传奇服务端脚本系统功能丰富，涵盖跳转指令、物品操作、地图管理、变量运算、逻辑判断、职业检测等全方位功能，很多新手玩家和GM在搭建私服、修改脚本时，常会遇到命令不懂、变量不会用、逻辑语句报错、脚本执行失效等问题。本文将全方位详解传奇常用脚本命令、变量常量用法、逻辑判断语句规则，搭配可直接套用的实操脚本案例，帮助零基础玩家快速上手，轻松搞定各类传奇脚本编写与修改问题。

一、传奇基础脚本跳转与交互命令详解（附实操案例）

传奇基础脚本是所有自定义功能的基石，主要包含段落跳转、对话框输出、功能执行、物品增减、地图跳转、怪物刷新、界面控制等核心指令，适配NPC对话、地图权限、怪物刷新、道具发放等各类基础场景，命令语法简单、实用性极强，是GM日常修改脚本最常用的指令合集。

1.1 脚本段落跳转指令

**[@段]**：脚本段落标记，段标识可使用英文字母或数字组合，用于划分独立的脚本功能模块，是脚本分段执行、跳转调用的核心标识，所有跳转指令均依托段落标记生效。

goto @段：脚本跳转命令，作用是终止当前段落代码执行，直接跳转到指定标记段落继续运行，功能类似于编程中的跳转语句，常用于循环执行、条件跳转、多分支脚本切换场景。

可直接套用案例：实现点击NPC跳转奖励领取段落

#say 欢迎领取新手礼包！
#act
goto @getnewgift

[@getnewgift]
#say 成功进入礼包领取界面！

1.2 脚本对话与执行指令

#say 语句：游戏对话框文字输出命令，用于向玩家展示提示文字、剧情内容、功能说明，语句内容为纯字符形式，无需添加引号、括号等定界符，支持换行展示多段文字。

#act 执行命令：功能执行触发指令，所有游戏系统操作命令都需搭配#act使用，只有添加该指令，后续的物品发放、地图跳转、怪物刷新等操作才能生效，是脚本功能执行的必备前缀。

1.3 物品与货币操作指令

give 物品 数量：道具与货币发放命令，可向玩家发放游戏内所有数据库存在的道具、装备，同时支持金币、元宝等货币发放，数量可自定义设置。

take 物品 数量：物品回收扣除命令，与give指令功能相反，用于扣除玩家背包内的指定道具、装备或金币，常用于兑换系统、回收系统、任务扣费场景。

实操案例：新手上线自动发放基础道具

#act
give 金条 2
give 疗伤药 10
give 金币 100000

1.4 地图与怪物管理指令

map 地图名：随机地图跳转命令，输入对应地图数字编码或地图名称，可将玩家传送到指定地图的随机坐标，常用于回城、随机传送、场景切换功能。

mapmove 地图名 坐标A 坐标B：定点地图传送命令，精准控制玩家传送后的地图坐标，避免随机传送导致的位置偏差，常用于活动地图、专属地图定点入场。

monclear 地图名：地图怪物清空命令，一键清除指定地图内所有已刷新的怪物，适用于地图重置、活动结束清怪、副本刷新场景。

MonGen 怪物名称 数量 时间：自定义怪物刷新命令，可手动设置刷新怪物名称、单次刷新数量、刷新间隔时间，适配专属BOSS刷新、小怪批量刷新、活动怪物刷新等场景，和服务端刷怪脚本逻辑完全互通。

1.5 时间与外观自定义指令

TimeRecall 数值：地图进入时间限制命令，数值单位为分钟，用于设置玩家进入指定地图的有效时长，时长结束后自动弹出地图，常用于限时副本、专属限时地图。

BreakTimeRecall：时间限制中断命令，可提前终止TimeRecall设置的地图限时规则，手动解除玩家的地图停留限制。

hairstyle 数值：玩家发型修改命令，通过自定义数值切换游戏内人物发型，适配外观自定义NPC功能。

haircolor 红值 绿值 蓝值：发色自定义命令，三原色数值区间为0-255，可自由搭配调整人物发色，打造个性化游戏外观。

1.6 界面控制指令

close：对话框关闭命令，执行后自动关闭当前打开的NPC对话框，常用于操作完成后自动关闭界面，优化玩家操作体验。

二、传奇脚本变量与常量大全（赋值/运算/随机变量用法）

变量是传奇脚本实现动态运算、随机触发、数据记录的核心，传奇脚本专属变量分为固定变量P0-P9、D0-D9，仅支持字母组合命名，可自由赋值数字、数据，适配任务计数、概率触发、数值叠加、数据判断等复杂场景，新手GM常因变量运算规则不熟悉导致脚本报错，本节详解所有变量用法及组合运算逻辑。

2.1 基础变量赋值指令

mov 变量 数值：变量基础赋值命令，核心作用是为指定变量赋予固定数值，是所有变量运算的前置操作，常用于初始化数据、固定参数设置。

inc 变量 数值：变量自增命令，实现变量数值自动累加指定数值，等同于数学运算中的x=x+n，常用于任务次数累计、积分叠加、击杀计数等场景。

2.2 多变量求和运算指令

sum 变量A 变量B：双变量求和命令，传奇脚本中sum指令无法单独生效，必须搭配变量清零初始化操作使用，支持多变量连续累加，实现多数据汇总计算。

标准求和语法案例（可直接复制）：

#act
mov X 0  //初始化变量X为0
sum X P0  //X=0+P0数值
sum X P1  //X=X+P1数值，最终实现X=P0+P1
sum X D0  //继续累加，X=P0+P1+D0

2.3 随机变量指令

movr 变量 数值：随机变量赋值命令，可自动生成0至自定义数值之间的随机正数并赋值给指定变量，适配随机奖励、随机传送、随机触发活动场景。

random 数值：概率判断变量，当随机生成数值与设定数值匹配时返回1，不匹配则返回0，常搭配逻辑判断语句实现概率触发效果，比如30%概率触发双倍奖励。

2.4 变量显示与系统常量

**<$STR(变量)>**：变量可视化输出指令，搭配#say语句使用，可将变量实时数值展示在玩家对话框中，让玩家直观看到积分、次数、概率等动态数据。

传奇常用系统常量汇总：无需手动赋值，直接调用即可获取游戏实时数据，是定制个性化脚本的核心素材，包含账号、行会、武器、价格等各类系统参数。

常用常量：<$USERNAME>（当前玩家用户名）、<$GUILDWARFEE>（行会战金币数额）、<$LORD>（沙巴克行会会长）、<$OWNERGUILD>（沙巴克行会名称）、<$UPGRADEWEAPONFEE>（武器升级费用）、<$USERWEAPON>（当前对话框选中武器名称）

三、传奇脚本逻辑判断语句全解（条件判断/变量检测/重置规则）

逻辑判断语句是传奇脚本实现智能触发、权限检测、条件限制的关键，可实现等级检测、职业区分、金币校验、物品判定、PK值检测、人数监测等功能，所有复杂的NPC功能、任务系统、权限设置都依托逻辑语句实现，本节详解全套判断指令及报错规避方法。

3.1 基础逻辑判断框架

[n]逻辑变量：n为1-1024正整数，系统默认初始值为0（关闭状态），赋值1后为开启状态，用于记录任务完成状态、功能触发状态、权限激活状态。

#IF条件判断框架：传奇脚本核心判断结构，满足#IF设定条件则执行对应操作，不满足则执行#elsesay（文字提示）或#elseact（功能执行），适配所有分支脚本场景。

基础逻辑判断案例：等级达标领取奖励

#IF
checklevel 50
#act
give 元宝 500
#elsesay 你的等级不足50级，无法领取奖励！

3.2 逻辑变量设置与重置指令

SET [n] 1：逻辑变量激活命令，将指定编号的逻辑变量设置为真，标记任务已完成、功能已触发，避免重复领取、重复操作。

reset [XXX] 7：批量变量重置命令，核心作用是将指定编号起始的7个连续逻辑变量统一重置为初始值0，无需逐个设置变量清零，大幅简化脚本代码。

指令详解案例：reset [100] 7 可一次性重置[100]-[106]共7个变量，等同于连续执行set [100] 0至set [106] 0七条指令，高效精简脚本。

Check [n] 1：逻辑变量检测命令，用于判断指定变量是否为激活状态，常用来检测玩家是否完成前置任务、是否拥有对应权限。

3.3 变量数值对比判断指令

small 变量 数值：小于判断，当变量数值小于设定数值时判定成立，返回1，常用于检测剩余次数、最低数值限制。

large 变量 数值：大于判断，当变量数值大于设定数值时判定成立，返回1，常用于检测超额数值、最高上限突破。

equal 变量 数值：等于判断，变量数值与设定数值完全一致时判定成立，精准匹配固定数值场景。

3.4 玩家属性与状态检测指令

checkjob 职业：职业检测命令，支持Warr（战士）、Wizard（法师）、Taos（道士）三大职业判定，可实现职业专属奖励、职业专属功能区分。

checkgold 数值：金币检测命令，玩家当前金币大于等于设定数值时判定成立，用于兑换扣费、道具购买、权限开通校验。

checklevel 数值：等级检测命令，校验玩家等级是否达标，是等级副本、等级奖励、等级权限的核心检测指令。

genderman：性别检测命令，判定玩家是否为男性角色，成立返回1，可实现性别专属道具、专属任务功能。

checkbaggage：背包状态检测命令，检测玩家背包是否已满，背包满时返回1，常用于发放道具前的弹窗提示，避免道具发放失败。

3.5 游戏数据与场景检测指令

checkitem 物品 数值：背包物品数量检测，校验玩家背包内指定道具的持有数量，用于道具兑换、任务物品提交、道具消耗校验。

checkitemw 物品：身上装备检测命令，精准检测玩家当前穿戴的装备道具，区别于背包物品检测，适配装备专属权限、装备激活功能。

takew 物品 数量 部位：指定部位装备回收命令，支持全身搜索（部位为空/0）和指定部位回收（数值大于1），精准回收玩家穿戴装备，常用案例：takew 力量戒指 1 7，精准回收玩家7号部位的力量戒指。

checkmagic 技能名称：技能修炼检测命令，校验玩家是否已修炼指定技能，用于技能进阶、专属功能解锁判定。

checkpkpoint 数值：PK值检测命令，玩家PK值大于设定数值时判定成立，可设置红名限制、PK值清零等功能。

checkluckypoint 数值：幸运值检测命令，检测玩家武器幸运值，适配幸运加持、高幸运专属buff功能。

checkduraeva 物品名 数值：物品品质检测命令，针对带品质属性的道具、矿物、装备进行品质校验，用于高品质道具兑换、锻造功能。

checkhum 地图名 数值：地图人数检测，统计指定地图在线玩家数量，可实现地图人数限制、爆满提示、分流传送功能。

checkmonmap 地图名 数值：地图怪物数量检测，校验指定地图剩余怪物数量，适配副本清怪通关、怪物刷新触发场景。

四、传奇商用NPC脚本编码规则（完整对照表+实操用法）

传奇商用NPC自带专属编码参数，不同数字编码对应不同交易、修复、购买功能，是搭建商城、装备修复、道具交易、材料兑换NPC的核心规则，熟练掌握编码可快速搭建商用游戏功能，适配私服商业化运营需求。

4.1 NPC功能编码完整对照表

%100：控制商品原价/双倍价格切换；+40：肉类购买功能；+1：肉类售卖功能；+43：武器修复相关功能；+15：头盔购买与修复；+10：衣服购买功能；+11：衣服修复功能；+26：手镯类修复与售卖；+0：各类药水购买功能；+42：各类药水售卖功能；+30：蜡烛等消耗品交易；+25：特殊药水专属交易；+3：卷轴、技能书购买；+4：卷轴、技能书售卖；+19、+20、+21：项链交易功能；+22：戒指购买功能；+23：戒指售卖功能；+24：手镯购买功能；+5：武器修炼、武器购买；+6：武器修炼、武器售卖

五、传奇高频组合脚本案例（可直接复制套用）

为方便新手GM快速落地使用，整理3组传奇最常用、可直接套用的完整脚本案例，涵盖新手福利、随机奖励、地图权限限制三大高频场景，代码无报错、适配所有主流传奇服务端。

5.1 新手等级福利脚本

[@main]
#say 【新手等级福利】n达到对应等级即可领取专属奖励！n
#IF
checklevel 30
Check [1] 0
#act
give 祖玛套装 1
give 金币 200000
SET [1] 1
#elsesay 等级未达标或已领取过奖励！

5.2 随机概率奖励脚本

[@randomgift]
#IF
random 5
#act
give 高级元宝卡 1
#elsesay 本次未触发高级奖励，再接再厉！

5.3 限时地图进入权限脚本

[@enterlimitmap]
#IF
checkgold 50000
#act
take gold 50000
mapmove 3 200 200
TimeRecall 30
#elsesay 金币不足5万，无法进入限时副本！

六、传奇脚本新手常见报错问题汇总

1. sum指令无效果：未执行变量清零操作，必须先通过mov 变量 0初始化数值，再进行累加运算，否则代码失效。

2. 随机脚本不触发：random数值设置不合理，需匹配#IF分支数量，多分支场景需对应调整随机数值区间。

3. 物品发放失败：物品名称与服务端数据库名称不一致，大小写、文字符号需完全匹配，否则无法识别道具。

4. 变量重置不全：reset指令仅重置连续变量，非连续变量需单独使用SET指令清零。