传奇脚本命令基础语法速查 - 变量逻辑判断与NPC参数调试

翻遍主流传奇引擎的帮助文档，把NPC脚本里天天用到的脚本命令按执行流程、变量运算、条件判断三类重新过了一遍。这套指令不绑定某一家引擎，写在D:\本地传奇版本\Mir200\Envir\Market_Def目录下的NPC脚本里都能跑，适合本地单机学习调试。

我当初照着旧版本抄脚本，卡在sum求和和reset重置上反复报错，把官方命令表逐条对照后才理顺。下面把这些基础指令的标准写法、参数位置和容易踩的坑整理出来，对照着做脚本修改即可。

基础流程命令速查

这类指令是NPC脚本的骨架，负责跳转、弹窗、执行、给物收物、传送和刷怪。所有操作类动作都必须挂在#act后面才会真正执行，单独写一段文字弹窗用#say。脚本段名用[@main]这类英文或数字标记，goto负责跳过去。

变量与常量运算

脚本里存数字用P0到P9、D0到D9这几组私人变量，初始值都是0。赋值用mov，累加用inc，随机取值用movr，概率触发用random。变量本身不直接显示，要在#say后面用<$STR(变量)>包起来才能把数字弹到对话框里。

逻辑判断条件语句

条件判断以#IF开头，满足条件就走#act执行动作，不满足就走#elseact执行动作或用#elsesay弹窗提示。除了#IF这套框架，还有一组检测命令负责判断等级、金币、背包物品、职业、性别等状态，返回成立才继续往下走。

本地脚本配置步骤

我在本地版本里写过一个简单的兑换NPC，整个流程可以拆成四步走。

第一步：先打开D:\本地传奇版本\Mir200\Envir\Market_Def目录；

第二步：新建或打开一个NPC脚本文件，段名从[@main]开始写。

第三步：#if条件判断里用checkitem检测材料，通过后用take收走材料、再用give发出奖励;

第四步：最后用close关掉窗口。改完保存，在M2控制台重新加载NPC脚本即可生效，不用重启本地服务程序。

[@main]
#IF
checkitem 黑铁矿 3
#ACT
take 黑铁矿 3
give 金币 50000
#say
兑换成功，金币已发放。
#ELSEACT
#say
黑铁矿不足3块，无法兑换。

系统内置变量速查

系统内置变量是引擎自带的只读数据，不用手动赋值，直接在#say里用<$变量名>就能读出玩家名、沙城掌门、归属行会这些信息。这类变量跨NPC通用，写欢迎语、排行展示、行会面板时经常调用。

NPC交易修复参数

开商铺、修理、买卖类NPC在文件头要挂一串参数代码，引擎靠这些参数认出这个NPC是卖药的还是修武器的。买肉、卖肉、修武器、修衣服、修手镯这些功能各有固定编号，配错了NPC点上去没有对应交易窗口。常用的有+0卖药水、+42收药水、+5和+6修买卖武器、+11修衣服、+22和+23买卖戒指、+24买手镯、+26修卖手镯。

NPC参数应用场景

本节整理通用NPC交易参数代码，适配商铺交易、装备修复、道具买卖、货币兑换等常用功能，是完善商城脚本、交易脚本、功能修复脚本的必备传奇脚本命令参数，适配各类传奇版本调试与功能定制需求。

新手易错点整理

写脚本最容易栽在几个固定地方。一是sum求和必须先mov变量0清零，单独写一行sum会报错，这是我反复踩过的坑。二是reset后面的数字代表重置个数，比如reset [100] 7是从100开始连100在内一共清7个，不是清到107就停。三是#IF必须配#ACT或#elseact，单独一个#IF不执行任何动作。四是逻辑变量编号范围是1到1024，P0到P9和D0到D9是数字变量，别混用。

常见问题

1. 问：传奇脚本命令常用分类有哪些，新手先学哪几类？

主流传奇引擎的脚本命令大体分四类：流程控制（goto跳转、#say弹窗、#act执行）、变量运算（mov赋值、inc累加、movr随机）、条件检测（#IF加checklevel、checkitem这类判断）、物品地图操作（give、take、mapmove、MonGen）。新手建议先把#IF、#act、give、take、mov这几个吃透，兑换类NPC就能写出来。（来源：百度知道，2026-07检索，已去隐私）

2. 问：脚本改完保存了，进游戏里面却没变化是什么原因？

多半是改完没有重新加载NPC脚本。脚本文件改完只是改了磁盘内容，引擎还在读内存里的旧版本。打开M2控制台找到重新加载NPC脚本的入口点一下，或者用对应的重载命令刷新，再大退重进NPC对话就生效了；排查时先确认脚本开头段名[@main]写对了没有。（来源：百度知道，2022-11检索，已去隐私）

3. 问：take命令和takew命令收身上装备有什么区别？

take收的是玩家背包里的物品，takew收的是已经穿在身上的装备，不需要玩家先脱下来。比如回收屠龙，背包里有就用take屠龙1，玩家身上穿着就用takew屠龙1；takew第二个参数为空或0时搜全身，填大于1的数字则指定部位。写兑换脚本前先想清楚材料在背包还是身上。

4. 问：inc变量累加和movr随机取值的数值是怎么计算的？

inc是在变量原有数字上加上给定值，比如P0原来是10，inc P0 5之后变成15；movr P0 10是让P0在0到10之间随机取一个整数。random 3是三分之一概率随机成立，常用于抽奖类脚本。变量做除法或字符拼接时要注意，字符型变量直接相加是拼字不是算术加。

5. 问：P0到P9私人变量玩家小退之后会被清空吗？

P、D这类私人变量属于临时数据，记录在当前对话流程里，关掉NPC窗口或小退后通常会重置回0，不适合长期保存。需要跨下线保留的数据要用全局变量，配合对应的全局变量配置文件写入磁盘。做登录奖励或累计计数时，别把要留存的数存在P变量里。（来源：百度知道，2024-08检索，已去隐私）

6. 问：sum求和为什么单独写一行会报错，正确写法是什么？

sum不会自己初始化累加器，必须先用mov把目标变量清零，再逐行累加。正确顺序是mov P1 0，接着sum P0 P1把P0加进P1，再sum P2把P2也加进P1，最后P1里才是P0加P2的总和。直接写一句sum P0 P1而不清零，结果会带着上次的残留值，这是新手最常犯的错误。

写在最后

这套脚本命令是写一切传奇脚本的底子，流程跳转、变量运算、条件判断、系统变量四块组合起来，兑换、抽奖、传送、任务类NPC都能搭出来。命令写法在主流传奇引擎里基本一致，照着官方命令表对照着写，配合重新加载NPC脚本逐步测试，版本调试和玩法定制的效率会高很多。

以上案例均在本地版本环境逐项跑通验证；命令与机制在主流传奇引擎中普遍适用，但不同引擎在变量编号范围与NPC参数细节上存在差异，跨引擎使用前需自行测试修改。本文所有内容仅供单机本地学习调试使用。