传奇技术脚本学习的核心的是掌握各类常用命令，熟悉命令格式、用法及适用场景，所有脚本命令均需依托传奇服务端脚本文件（RobotManage.txt、NPC脚本等）编写，遵循“标识→条件→执行”的核心逻辑，无需复杂基础，新手可先记常用命令，结合实例练习，逐步掌握脚本编写技巧。以下是全场景常用脚本命令，按功能分类详解，直奔主题，无冗余，适配Hero、GOM、GEE、3km2等主流引擎，可直接套用。
首先明确核心前提：所有传奇脚本命令均区分大小写（部分引擎不区分，但建议统一规范），命令后参数需用空格分隔，脚本编写时需遵循“@标识#IF#ACT#SAY”的基础格式，其中@后为脚本触发标识，#IF后为执行条件，#ACT后为执行动作，#SAY后为对话显示内容。编写脚本需用记事本编辑，编码格式设为ANSI，避免中文乱码，保存后重启服务端生效，所有命令均需结合服务端实际路径和参数填写，避免路径、ID错误导致脚本失效。
一、基础核心命令（必学，所有脚本都需用到）
基础命令是脚本编写的基石，涵盖脚本触发、条件判断、对话显示等核心功能，所有引擎通用，新手需熟练掌握，无需记忆复杂参数，重点记住命令格式和基础用法。
1.脚本触发标识命令（@开头，自定义命名，唯一不可重复）
格式：@标识名称（如@NewPlayer、@GetItem、@GoMap）
用法：作为脚本的触发入口，可通过GM命令、NPC点击、物品使用等方式触发，标识名称可自定义，建议贴合脚本功能，便于后续修改和识别，避免与系统默认标识重复（如@Admin、@GM等系统标识不可占用）。
实例：(@NewPlayer)//新手引导脚本触发标识，玩家点击新手NPC即可触发
2.条件判断命令（#IF后使用，判断是否执行后续动作）
（1）checklevel等级//检测玩家等级
格式：#IFchecklevel数值（如checklevel10，检测玩家等级是否≥10级）
用法：最常用的条件命令，可用于限制脚本执行的等级门槛，如新手任务需等级≥1级才可触发，高阶脚本需等级≥50级才可执行。
实例：#IFchecklevel10//判断玩家等级是否≥10级#ACTgive金币1000//满足条件则给予1000金币
（2）checkjob职业//检测玩家职业
格式：#IFcheckjob职业缩写（Warr=战士、Wizard=法师、Taos=道士）
用法：用于区分不同职业执行不同脚本动作，如战士领取专属武器，法师领取专属法术书，道士领取专属宠物道具。
实例：#IFcheckjobWarr//判断玩家是否为战士#ACTgive裁决1//满足条件则给予裁决武器1把
（3）checkitem物品名称/物品ID数量//检测玩家背包物品及数量
格式：#IFcheckitem物品名称数值（如checkitem疗伤药5，检测背包是否有5个疗伤药）；也可使用物品ID（如checkitem10015，1001为疗伤药ID）
用法：用于道具兑换、任务提交等场景，检测玩家是否拥有指定数量的道具，无道具则不执行后续动作。
实例：#IFcheckitem铁矿石10//检测背包是否有10个铁矿石#ACTtake铁矿石10//拿走10个铁矿石give生铁1//给予1个生铁
（4）checkgold金币数量//检测玩家背包金币
格式：#IFcheckgold数值（如checkgold5000，检测玩家金币是否≥5000）
用法：用于金币兑换、NPC交易等场景，限制玩家需拥有足够金币才可执行脚本动作。
实例：#IFcheckgold5000//检测金币是否≥5000#ACTtakegold5000//扣除5000金币give沃玛号角1//给予沃玛号角1个
（5）checkpkpoint数值//检测玩家PK值
格式：#IFcheckpkpoint数值（如checkpkpoint0，检测玩家PK值是否为0；checkpkpoint<5，检测PK值是否小于5）
用法：用于限制红名玩家执行脚本，如红名玩家无法领取任务、无法兑换道具，需PK值清零后才可执行。
实例：#IFcheckpkpoint0//检测PK值是否为0#ACTgive声望值10//给予10点声望值
3.对话显示命令（#SAY后使用，显示NPC对话或提示信息）
格式：#SAY对话内容（可换行，换行用换行符，无需额外命令）
用法：用于NPC对话、脚本提示，可添加触发按钮（格式：<按钮名称/@标识>），引导玩家触发后续脚本动作。
实例：#SAY欢迎来到新手村！我可以给你新手装备，需要领取吗？<领取装备/@GetNewEquip><离开/@Close>
4.中断脚本命令（break）
格式：#ACTbreak
用法：用于中断当前脚本流程，避免后续动作执行，常与条件判断配合使用，如玩家不满足条件时，中断脚本并提示。
实例：#IFchecklevel5//判断玩家等级是否≥5级#ACTgive新手剑1#ELSEACT#SAY你的等级不足5级，无法领取新手剑！break//中断脚本，不执行后续动作
二、物品操作命令（常用，道具发放、扣除、属性修改）
物品操作命令是脚本中最常用的一类，涵盖道具发放、扣除、属性修改、背包检测等功能，适配所有引擎，重点注意物品名称或ID需与服务端物品数据库一致，避免无法识别。
1.物品发放命令（give）
格式1：give物品名称数量（如give新手衣1，发放1件新手衣）
格式2：give物品ID数量（如give10023，1002为新手衣ID，发放3件）
补充：givegold数值（发放金币，如givegold10000，发放10000金币）；give声望值数值（发放声望，如give声望值5）
用法：用于新手福利、任务奖励、NPC兑换等场景，发放指定物品或资源，数量可自定义，超出背包容量时，物品会掉落在地面。
实例：#IFchecklevel1//玩家等级≥1级#ACTgive新手剑1give疗伤药5givegold500//发放新手剑1把、疗伤药5个、金币500
2.物品扣除命令（take）
格式1：take物品名称数量（如take疗伤药2，扣除2个疗伤药）
格式2：take物品ID数量（如take10012，扣除2个疗伤药）
补充：takegold数值（扣除金币，如takegold2000，扣除2000金币）；take声望值数值（扣除声望）
用法：用于道具兑换、任务提交、消耗类玩法，扣除玩家背包中的指定物品或资源，玩家背包中物品不足时，脚本不执行后续动作。
实例：#IFcheckitem沃玛凭证1//检测是否有1个沃玛凭证#ACTtake沃玛凭证1give沃玛手镯1//扣除凭证，发放手镯
3.物品属性修改命令（ChangeItemAttr）
格式：ChangeItemAttr物品名称/ID属性数值（如ChangeItemAttr裁决攻击10，将裁决的攻击属性增加10点）
常用属性：攻击、魔法、道术、防御、魔防、持久、幸运、诅咒
用法：用于自定义物品属性，如打造专属装备、道具升级等场景，可增加或减少物品属性数值（数值为负则减少）。
实例：#IFcheckitem裁决1//检测是否有裁决#ACTChangeItemAttr裁决攻击5ChangeItemAttr裁决幸运1//裁决攻击+5，幸运+1
4.背包检测命令（checkbaggage）
格式：#IFcheckbaggage//检测背包是否有空闲格子
用法：发放物品前检测背包，避免物品掉落，常与give命令配合使用，背包无空闲格子时，提示玩家清理背包。
实例：#IFcheckbaggagechecklevel10//背包有空闲且等级≥10级#ACTgive祖玛头盔1#ELSEACT#SAY你的背包已满，请清理后再领取！
5.物品回收命令（RecycleItem）
格式：RecycleItem物品名称/ID数量奖励物品奖励数量（如RecycleItem废铁10金币1000，回收10个废铁，奖励1000金币）
用法：用于物品回收玩法，玩家提交指定数量的废弃道具，获仍应奖励，简化道具处理流程。
实例：#SAY回收废铁啦！10个废铁可兑换1000金币，需要回收吗？<回收/@RecycleIron>#IFcheckitem废铁10#ACTRecycleItem废铁10金币1000
三、地图与移动命令（常用，场景切换、坐标定位）
地图与移动命令用于实现玩家场景切换、指定坐标移动、地图清理等功能，适配所有主流引擎，重点注意地图名称需与服务端地图数据库一致，坐标需准确，避免移动到地图外导致异常。
1.地图移动命令（mapmove）
格式：mapmove地图名称坐标X坐标Y（如mapmove新手村320280，将玩家移动到新手村320280坐标）
补充：map地图名称（如map沃玛寺庙，直接移动到该地图默认坐标，无需填写具体坐标）
用法：用于NPC传送、任务场景切换、随机传送等场景，如新手村NPC传送玩家到比奇城，任务完成后传送玩家到指定地图。
实例：#IFchecklevel15//等级≥15级#ACTmapmove比奇城330350//传送玩家到比奇城指定坐标#SAY已为你传送到比奇城，开启新的冒险吧！
2.随机移动命令（RandomMove）
格式：RandomMove地图名称坐标X1坐标Y1坐标X2坐标Y2（如RandomMove蜈蚣洞200200300300，在蜈蚣洞200-300坐标范围内随机移动）
用法：用于随机传送道具、随机任务场景，让玩家在指定地图的指定区域内随机移动，增加玩法随机性。
实例：#IFcheckitem随机传送卷1//检测是否有随机传送卷#ACTtake随机传送卷1RandomMove蜈蚣洞200200300300//消耗传送卷，随机移动
3.地图清理命令（monclear）
格式：monclear地图名称（如monclear新手村，清空新手村所有怪物）；monclear地图名称怪物名称（如monclear蜈蚣洞蜈蚣，清空蜈蚣洞所有蜈蚣）
用法：用于任务清理、活动场景重置，清空指定地图的所有怪物或指定怪物，避免怪物干扰脚本执行。
实例：#IFcheckjobWizard//法师玩家#ACTmonclear猪洞白野猪//清空猪洞所有白野猪#SAY猪洞白野猪已清空，快去寻宝吧！
4.地图人数检测命令（checkhum）
格式：checkhum地图名称数值（如checkhum沙巴克10，检测沙巴克地图人数是否≥10人）
用法：用于攻城战、团队活动等场景，检测指定地图的玩家人数，满足人数条件才可触发后续脚本动作。
实例：#IFcheckhum沙巴克10//沙巴克人数≥10人#ACT#SAY沙巴克人数已达标，攻城战即将开启！
四、玩家属性操作命令（常用，等级、血量、技能修改）
玩家属性操作命令用于修改玩家等级、血量、魔法值、技能等核心属性，适配所有引擎，常用于新手福利、任务奖励、GM脚本等场景，修改时需注意数值合理性，避免破坏玩法平衡。
1.等级修改命令（ChangeLevel）
格式：ChangeLevel数值（如ChangeLevel10，将玩家等级修改为10级）；ChangeLevel+数值（如ChangeLevel+5，玩家等级提升5级）
用法：用于新手升级、任务奖励，快速提升玩家等级，减少升级时间，数值可自定义，最高等级不超过服务端设置的上限。
实例：#IFcheckitem升级卷轴1//检测是否有升级卷轴#ACTtake升级卷轴1ChangeLevel+3//消耗卷轴，等级+3#SAY恭喜你，等级提升3级！
2.血量/魔法值修改命令（ChangeHp、ChangeMp）
格式：ChangeHp数值（如ChangeHp100，将玩家当前血量修改为100点）；ChangeHp+数值（如ChangeHp+50，血量增加50点）
同理：ChangeMp数值（修改魔法值）、ChangeHpMax数值（修改血量上限）、ChangeMpMax数值（修改魔法值上限）
用法：用于回血、回蓝道具、任务奖励，快速恢复玩家血量或魔法值，提升玩家生存能力。
实例：#IFcheckitem强效疗伤药1//检测是否有强效疗伤药#ACTtake强效疗伤药1ChangeHp+200ChangeMp+150//回血200、回蓝150
3.技能学习命令（LearnSkill）
格式：LearnSkill技能名称等级（如LearnSkill烈火剑法1，让玩家学会1级烈火剑法）；也可使用技能ID（如LearnSkill2011，201为烈火剑法ID）
用法：用于新手技能发放、技能书兑换，让玩家直接学会指定技能，无需手动使用技能书，等级可设置为1-3级（根据服务端技能上限调整）。
实例：#IFcheckjobWarrchecklevel25//战士且等级≥25级#ACTgive烈火剑法1LearnSkill烈火剑法1//发放技能书并学会1级技能
4.声望/荣誉值修改命令（ChangeRepute）
格式：ChangeRepute数值（如ChangeRepute10，增加10点声望）；ChangeRepute-数值（如ChangeRepute-5，减少5点声望）
用法：用于任务奖励、行会操作，修改玩家声望值，声望可用于兑换道具、提升行会等级。
实例：#IFcheckitem声望令牌1//检测是否有声望令牌#ACTtake声望令牌1ChangeRepute5//消耗令牌，声望+5
五、NPC与机器人脚本专用命令（核心，交互与定时）
此类命令专门用于NPC交互、机器人脚本编写，涵盖NPC对话控制、定时执行、文件操作等功能，是实现自动化脚本（如定时清理、自动发奖）的核心，不同引擎用法基本一致，细微差异可参考服务端说明。
1.NPC对话关闭命令（Close）
格式：#ACTClose或<离开/@Close>
用法：用于关闭NPC对话窗口，玩家点击“离开”按钮后，关闭当前对话，返回游戏界面，是NPC脚本必备命令。
实例：#SAY请问需要什么帮助？<领取福利/@GetGift><离开/@Close>#IF@Close#ACTClose
2.定时执行命令（#AutoRun）
格式1（Hero/3km2引擎）：#AutoRunNPCRUNONDAY时间@脚本标识（如#AutoRunNPCRUNONDAY00:00:00@ClearSabuk，每天00:00执行@ClearSabuk脚本）
格式2（GOM/GEE引擎）：#AutoRunNPCHOUR时间@脚本标识（如#AutoRunNPCHOUR20:00:00@SendGift，每天20:00执行@SendGift脚本）
用法：用于机器人定时脚本，实现每天固定时间自动执行脚本动作，如定时发福利、定时清理地图、定时重置数据。
实例：#AutoRunNPCRUNONDAY20:00:00@SendSystemMsg全服福利发放！在线玩家可领取金币10000//每天20:00全服提示
3.文件操作命令（ClearFile、WriteFile）
（1）ClearFile路径/文件名（如ClearFileMir200\Castle\SabukW.txt，清空该文件内容，不删除文件）
（2）WriteFile路径/文件名内容（如WriteFileMir200\Castle\SabukW.txtOwnGuild=，向文件写入指定内容）
用法：用于修改服务端配置文件，如清空沙巴克占领信息、写入玩家数据、保存脚本执行记录，常与定时命令配合使用。
实例：#ACTClearFileMir200\Castle\AttackSabukWall.txtWriteFileMir200\Castle\AttackSabukWall.txt""//清空攻城记录文件
4.全服提示命令（SendSystemMsg）
格式：SendSystemMsg提示内容（如SendSystemMsg全服公告：攻城战将于今晚20:00开启！）
用法：用于全服公告、脚本执行提示，所有在线玩家均可看到提示信息，可配合定时命令、任务完成提示使用。
实例：#IFchecklevel100//有玩家达到100级#ACTSendSystemMsg恭喜玩家XXX达到100级，获得全服祝福！//全服提示
六、变量操作命令（进阶，脚本逻辑优化）
变量操作命令用于脚本逻辑优化，实现复杂脚本功能（如任务进度记录、随机事件触发），适合有一定基础后学习，新手可先掌握基础用法，后续逐步进阶，所有引擎通用，变量名称可自定义。
1.变量赋值命令（mov）
格式：mov变量名数值（如movp11，将变量p1赋值为1；movd010，将变量d0赋值为10）
用法：用于记录任务进度、标记玩家状态，如玩家领取任务后，变量赋值为1，完成任务后赋值为2，判断变量值执行不同动作。
实例：#IFcheckitem任务道具1//领取任务道具#ACTtake任务道具1movp11//变量p1赋值为1，标记任务开始#SAY任务已开始，快去完成吧！
2.变量增减命令（inc、dec）
格式：inc变量名数值（如incp11，变量p1增加1）；dec变量名数值（如decp11，变量p1减少1）
用法：用于累计任务进度、计数，如玩家击杀1个怪物，变量增加1，累计达到指定数值后，完成任务并给予奖励。
实例：#IFcheckmon僵尸1//击杀1个僵尸#ACTincp11//变量p1+1#SAY已击杀1个僵尸，还需击杀9个！
3.变量判断命令（equal、large、small）
格式：#IFequal变量名数值（判断变量是否等于指定数值，如equalp110）；large变量名数值（判断变量是否大于指定数值）；small变量名数值（判断变量是否小于指定数值）
用法：配合变量赋值、增减命令，实现复杂逻辑，如任务累计击杀10个怪物（变量p1=10），则完成任务并给予奖励。
实例：#IFequalp110//变量p1等于10（击杀10个僵尸）#ACTgive任务奖励1movp10//发放奖励，重置变量#SAY任务完成，恭喜你获得奖励！
4.随机变量命令（movr）
格式：movr变量名数值（如movrd06，随机给变量d0赋予1-6之间的数值）
用法：用于随机事件、骰子玩法，随机生成数值，根据数值执行不同脚本动作，增加玩法趣味性。
实例：#ACTmovrd06//随机生成1-6的数值#IFequald06#SAY恭喜你，抽到大奖！give金币10000#ELSEACT#SAY谢谢参与，下次好运！
七、脚本学习注意事项与实战技巧（新手必看）
1.所有命令需在对应脚本文件中编写，NPC脚本放在“Mir200\Envir\NPC”文件夹，机器人脚本放在“Mir200\Envir\Robot_def”文件夹，不可放错路径，否则脚本无法触发。
2.编写脚本前，建议备份对应脚本文件，若修改错误，可直接替换备份文件，避免脚本失效或服务端异常。
3.物品名称、地图名称、技能名称需与服务端数据库完全一致，可在服务端“物品数据库”“地图数据库”中查询准确名称和ID，避免因名称错误导致脚本无法执行。
4.新手学习建议：先从基础命令入手，练习简单脚本（如新手领取装备、道具兑换），熟悉命令格式后，再学习变量命令，编写复杂脚本（如任务脚本、定时脚本）。
5.脚本编写完成后，需重启服务端生效，测试时优先用GM账号手动触发，排查命令错误、路径错误，确认脚本正常执行后，再开放给普通玩家。
6.不同引擎命令细微差异：GOM/GEE引擎部分命令需添加“HOUR”参数（如定时命令），3km2引擎需开启机器人定时功能，若命令无法执行，可查看服务端引擎说明文档，调整命令格式。
8.实战练习建议：新手可先编写“新手引导脚本”，整合基础命令（@标识、#IF、#ACT、give、mapmove），练习条件判断和物品发放，逐步掌握脚本编写逻辑，再尝试编写任务脚本、回收脚本，积累实战经验。
传奇技术脚本学习的核心是多记、多练、多排查，以上命令涵盖新手入门到进阶的全场景用法，无需记忆所有命令，重点掌握常用命令的格式和用法，结合实例练习，即可快速上手脚本编写。遇到命令无法执行、脚本失效等问题，优先检查命令格式、路径、参数是否正确，多数问题均可通过核对修改解决，熟练掌握后，可根据自身需求编写自定义脚本，丰富游戏玩法。
首先明确核心前提：所有传奇脚本命令均区分大小写（部分引擎不区分，但建议统一规范），命令后参数需用空格分隔，脚本编写时需遵循“@标识#IF#ACT#SAY”的基础格式，其中@后为脚本触发标识，#IF后为执行条件，#ACT后为执行动作，#SAY后为对话显示内容。编写脚本需用记事本编辑，编码格式设为ANSI，避免中文乱码，保存后重启服务端生效，所有命令均需结合服务端实际路径和参数填写，避免路径、ID错误导致脚本失效。
一、基础核心命令（必学，所有脚本都需用到）
基础命令是脚本编写的基石，涵盖脚本触发、条件判断、对话显示等核心功能，所有引擎通用，新手需熟练掌握，无需记忆复杂参数，重点记住命令格式和基础用法。
1.脚本触发标识命令（@开头，自定义命名，唯一不可重复）
格式：@标识名称（如@NewPlayer、@GetItem、@GoMap）
用法：作为脚本的触发入口，可通过GM命令、NPC点击、物品使用等方式触发，标识名称可自定义，建议贴合脚本功能，便于后续修改和识别，避免与系统默认标识重复（如@Admin、@GM等系统标识不可占用）。
实例：(@NewPlayer)//新手引导脚本触发标识，玩家点击新手NPC即可触发
2.条件判断命令（#IF后使用，判断是否执行后续动作）
（1）checklevel等级//检测玩家等级
格式：#IFchecklevel数值（如checklevel10，检测玩家等级是否≥10级）
用法：最常用的条件命令，可用于限制脚本执行的等级门槛，如新手任务需等级≥1级才可触发，高阶脚本需等级≥50级才可执行。
实例：#IFchecklevel10//判断玩家等级是否≥10级#ACTgive金币1000//满足条件则给予1000金币
（2）checkjob职业//检测玩家职业
格式：#IFcheckjob职业缩写（Warr=战士、Wizard=法师、Taos=道士）
用法：用于区分不同职业执行不同脚本动作，如战士领取专属武器，法师领取专属法术书，道士领取专属宠物道具。
实例：#IFcheckjobWarr//判断玩家是否为战士#ACTgive裁决1//满足条件则给予裁决武器1把
（3）checkitem物品名称/物品ID数量//检测玩家背包物品及数量
格式：#IFcheckitem物品名称数值（如checkitem疗伤药5，检测背包是否有5个疗伤药）；也可使用物品ID（如checkitem10015，1001为疗伤药ID）
用法：用于道具兑换、任务提交等场景，检测玩家是否拥有指定数量的道具，无道具则不执行后续动作。
实例：#IFcheckitem铁矿石10//检测背包是否有10个铁矿石#ACTtake铁矿石10//拿走10个铁矿石give生铁1//给予1个生铁
（4）checkgold金币数量//检测玩家背包金币
格式：#IFcheckgold数值（如checkgold5000，检测玩家金币是否≥5000）
用法：用于金币兑换、NPC交易等场景，限制玩家需拥有足够金币才可执行脚本动作。
实例：#IFcheckgold5000//检测金币是否≥5000#ACTtakegold5000//扣除5000金币give沃玛号角1//给予沃玛号角1个
（5）checkpkpoint数值//检测玩家PK值
格式：#IFcheckpkpoint数值（如checkpkpoint0，检测玩家PK值是否为0；checkpkpoint<5，检测PK值是否小于5）
用法：用于限制红名玩家执行脚本，如红名玩家无法领取任务、无法兑换道具，需PK值清零后才可执行。
实例：#IFcheckpkpoint0//检测PK值是否为0#ACTgive声望值10//给予10点声望值
3.对话显示命令（#SAY后使用，显示NPC对话或提示信息）
格式：#SAY对话内容（可换行，换行用换行符，无需额外命令）
用法：用于NPC对话、脚本提示，可添加触发按钮（格式：<按钮名称/@标识>），引导玩家触发后续脚本动作。
实例：#SAY欢迎来到新手村！我可以给你新手装备，需要领取吗？<领取装备/@GetNewEquip><离开/@Close>
4.中断脚本命令（break）
格式：#ACTbreak
用法：用于中断当前脚本流程，避免后续动作执行，常与条件判断配合使用，如玩家不满足条件时，中断脚本并提示。
实例：#IFchecklevel5//判断玩家等级是否≥5级#ACTgive新手剑1#ELSEACT#SAY你的等级不足5级，无法领取新手剑！break//中断脚本，不执行后续动作
二、物品操作命令（常用，道具发放、扣除、属性修改）
物品操作命令是脚本中最常用的一类，涵盖道具发放、扣除、属性修改、背包检测等功能，适配所有引擎，重点注意物品名称或ID需与服务端物品数据库一致，避免无法识别。
1.物品发放命令（give）
格式1：give物品名称数量（如give新手衣1，发放1件新手衣）
格式2：give物品ID数量（如give10023，1002为新手衣ID，发放3件）
补充：givegold数值（发放金币，如givegold10000，发放10000金币）；give声望值数值（发放声望，如give声望值5）
用法：用于新手福利、任务奖励、NPC兑换等场景，发放指定物品或资源，数量可自定义，超出背包容量时，物品会掉落在地面。
实例：#IFchecklevel1//玩家等级≥1级#ACTgive新手剑1give疗伤药5givegold500//发放新手剑1把、疗伤药5个、金币500
2.物品扣除命令（take）
格式1：take物品名称数量（如take疗伤药2，扣除2个疗伤药）
格式2：take物品ID数量（如take10012，扣除2个疗伤药）
补充：takegold数值（扣除金币，如takegold2000，扣除2000金币）；take声望值数值（扣除声望）
用法：用于道具兑换、任务提交、消耗类玩法，扣除玩家背包中的指定物品或资源，玩家背包中物品不足时，脚本不执行后续动作。
实例：#IFcheckitem沃玛凭证1//检测是否有1个沃玛凭证#ACTtake沃玛凭证1give沃玛手镯1//扣除凭证，发放手镯
3.物品属性修改命令（ChangeItemAttr）
格式：ChangeItemAttr物品名称/ID属性数值（如ChangeItemAttr裁决攻击10，将裁决的攻击属性增加10点）
常用属性：攻击、魔法、道术、防御、魔防、持久、幸运、诅咒
用法：用于自定义物品属性，如打造专属装备、道具升级等场景，可增加或减少物品属性数值（数值为负则减少）。
实例：#IFcheckitem裁决1//检测是否有裁决#ACTChangeItemAttr裁决攻击5ChangeItemAttr裁决幸运1//裁决攻击+5，幸运+1
4.背包检测命令（checkbaggage）
格式：#IFcheckbaggage//检测背包是否有空闲格子
用法：发放物品前检测背包，避免物品掉落，常与give命令配合使用，背包无空闲格子时，提示玩家清理背包。
实例：#IFcheckbaggagechecklevel10//背包有空闲且等级≥10级#ACTgive祖玛头盔1#ELSEACT#SAY你的背包已满，请清理后再领取！
5.物品回收命令（RecycleItem）
格式：RecycleItem物品名称/ID数量奖励物品奖励数量（如RecycleItem废铁10金币1000，回收10个废铁，奖励1000金币）
用法：用于物品回收玩法，玩家提交指定数量的废弃道具，获仍应奖励，简化道具处理流程。
实例：#SAY回收废铁啦！10个废铁可兑换1000金币，需要回收吗？<回收/@RecycleIron>#IFcheckitem废铁10#ACTRecycleItem废铁10金币1000
三、地图与移动命令（常用，场景切换、坐标定位）
地图与移动命令用于实现玩家场景切换、指定坐标移动、地图清理等功能，适配所有主流引擎，重点注意地图名称需与服务端地图数据库一致，坐标需准确，避免移动到地图外导致异常。
1.地图移动命令（mapmove）
格式：mapmove地图名称坐标X坐标Y（如mapmove新手村320280，将玩家移动到新手村320280坐标）
补充：map地图名称（如map沃玛寺庙，直接移动到该地图默认坐标，无需填写具体坐标）
用法：用于NPC传送、任务场景切换、随机传送等场景，如新手村NPC传送玩家到比奇城，任务完成后传送玩家到指定地图。
实例：#IFchecklevel15//等级≥15级#ACTmapmove比奇城330350//传送玩家到比奇城指定坐标#SAY已为你传送到比奇城，开启新的冒险吧！
2.随机移动命令（RandomMove）
格式：RandomMove地图名称坐标X1坐标Y1坐标X2坐标Y2（如RandomMove蜈蚣洞200200300300，在蜈蚣洞200-300坐标范围内随机移动）
用法：用于随机传送道具、随机任务场景，让玩家在指定地图的指定区域内随机移动，增加玩法随机性。
实例：#IFcheckitem随机传送卷1//检测是否有随机传送卷#ACTtake随机传送卷1RandomMove蜈蚣洞200200300300//消耗传送卷，随机移动
3.地图清理命令（monclear）
格式：monclear地图名称（如monclear新手村，清空新手村所有怪物）；monclear地图名称怪物名称（如monclear蜈蚣洞蜈蚣，清空蜈蚣洞所有蜈蚣）
用法：用于任务清理、活动场景重置，清空指定地图的所有怪物或指定怪物，避免怪物干扰脚本执行。
实例：#IFcheckjobWizard//法师玩家#ACTmonclear猪洞白野猪//清空猪洞所有白野猪#SAY猪洞白野猪已清空，快去寻宝吧！
4.地图人数检测命令（checkhum）
格式：checkhum地图名称数值（如checkhum沙巴克10，检测沙巴克地图人数是否≥10人）
用法：用于攻城战、团队活动等场景，检测指定地图的玩家人数，满足人数条件才可触发后续脚本动作。
实例：#IFcheckhum沙巴克10//沙巴克人数≥10人#ACT#SAY沙巴克人数已达标，攻城战即将开启！
四、玩家属性操作命令（常用，等级、血量、技能修改）
玩家属性操作命令用于修改玩家等级、血量、魔法值、技能等核心属性，适配所有引擎，常用于新手福利、任务奖励、GM脚本等场景，修改时需注意数值合理性，避免破坏玩法平衡。
1.等级修改命令（ChangeLevel）
格式：ChangeLevel数值（如ChangeLevel10，将玩家等级修改为10级）；ChangeLevel+数值（如ChangeLevel+5，玩家等级提升5级）
用法：用于新手升级、任务奖励，快速提升玩家等级，减少升级时间，数值可自定义，最高等级不超过服务端设置的上限。
实例：#IFcheckitem升级卷轴1//检测是否有升级卷轴#ACTtake升级卷轴1ChangeLevel+3//消耗卷轴，等级+3#SAY恭喜你，等级提升3级！
2.血量/魔法值修改命令（ChangeHp、ChangeMp）
格式：ChangeHp数值（如ChangeHp100，将玩家当前血量修改为100点）；ChangeHp+数值（如ChangeHp+50，血量增加50点）
同理：ChangeMp数值（修改魔法值）、ChangeHpMax数值（修改血量上限）、ChangeMpMax数值（修改魔法值上限）
用法：用于回血、回蓝道具、任务奖励，快速恢复玩家血量或魔法值，提升玩家生存能力。
实例：#IFcheckitem强效疗伤药1//检测是否有强效疗伤药#ACTtake强效疗伤药1ChangeHp+200ChangeMp+150//回血200、回蓝150
3.技能学习命令（LearnSkill）
格式：LearnSkill技能名称等级（如LearnSkill烈火剑法1，让玩家学会1级烈火剑法）；也可使用技能ID（如LearnSkill2011，201为烈火剑法ID）
用法：用于新手技能发放、技能书兑换，让玩家直接学会指定技能，无需手动使用技能书，等级可设置为1-3级（根据服务端技能上限调整）。
实例：#IFcheckjobWarrchecklevel25//战士且等级≥25级#ACTgive烈火剑法1LearnSkill烈火剑法1//发放技能书并学会1级技能
4.声望/荣誉值修改命令（ChangeRepute）
格式：ChangeRepute数值（如ChangeRepute10，增加10点声望）；ChangeRepute-数值（如ChangeRepute-5，减少5点声望）
用法：用于任务奖励、行会操作，修改玩家声望值，声望可用于兑换道具、提升行会等级。
实例：#IFcheckitem声望令牌1//检测是否有声望令牌#ACTtake声望令牌1ChangeRepute5//消耗令牌，声望+5
五、NPC与机器人脚本专用命令（核心，交互与定时）
此类命令专门用于NPC交互、机器人脚本编写，涵盖NPC对话控制、定时执行、文件操作等功能，是实现自动化脚本（如定时清理、自动发奖）的核心，不同引擎用法基本一致，细微差异可参考服务端说明。
1.NPC对话关闭命令（Close）
格式：#ACTClose或<离开/@Close>
用法：用于关闭NPC对话窗口，玩家点击“离开”按钮后，关闭当前对话，返回游戏界面，是NPC脚本必备命令。
实例：#SAY请问需要什么帮助？<领取福利/@GetGift><离开/@Close>#IF@Close#ACTClose
2.定时执行命令（#AutoRun）
格式1（Hero/3km2引擎）：#AutoRunNPCRUNONDAY时间@脚本标识（如#AutoRunNPCRUNONDAY00:00:00@ClearSabuk，每天00:00执行@ClearSabuk脚本）
格式2（GOM/GEE引擎）：#AutoRunNPCHOUR时间@脚本标识（如#AutoRunNPCHOUR20:00:00@SendGift，每天20:00执行@SendGift脚本）
用法：用于机器人定时脚本，实现每天固定时间自动执行脚本动作，如定时发福利、定时清理地图、定时重置数据。
实例：#AutoRunNPCRUNONDAY20:00:00@SendSystemMsg全服福利发放！在线玩家可领取金币10000//每天20:00全服提示
3.文件操作命令（ClearFile、WriteFile）
（1）ClearFile路径/文件名（如ClearFileMir200\Castle\SabukW.txt，清空该文件内容，不删除文件）
（2）WriteFile路径/文件名内容（如WriteFileMir200\Castle\SabukW.txtOwnGuild=，向文件写入指定内容）
用法：用于修改服务端配置文件，如清空沙巴克占领信息、写入玩家数据、保存脚本执行记录，常与定时命令配合使用。
实例：#ACTClearFileMir200\Castle\AttackSabukWall.txtWriteFileMir200\Castle\AttackSabukWall.txt""//清空攻城记录文件
4.全服提示命令（SendSystemMsg）
格式：SendSystemMsg提示内容（如SendSystemMsg全服公告：攻城战将于今晚20:00开启！）
用法：用于全服公告、脚本执行提示，所有在线玩家均可看到提示信息，可配合定时命令、任务完成提示使用。
实例：#IFchecklevel100//有玩家达到100级#ACTSendSystemMsg恭喜玩家XXX达到100级，获得全服祝福！//全服提示
六、变量操作命令（进阶，脚本逻辑优化）
变量操作命令用于脚本逻辑优化，实现复杂脚本功能（如任务进度记录、随机事件触发），适合有一定基础后学习，新手可先掌握基础用法，后续逐步进阶，所有引擎通用，变量名称可自定义。
1.变量赋值命令（mov）
格式：mov变量名数值（如movp11，将变量p1赋值为1；movd010，将变量d0赋值为10）
用法：用于记录任务进度、标记玩家状态，如玩家领取任务后，变量赋值为1，完成任务后赋值为2，判断变量值执行不同动作。
实例：#IFcheckitem任务道具1//领取任务道具#ACTtake任务道具1movp11//变量p1赋值为1，标记任务开始#SAY任务已开始，快去完成吧！
2.变量增减命令（inc、dec）
格式：inc变量名数值（如incp11，变量p1增加1）；dec变量名数值（如decp11，变量p1减少1）
用法：用于累计任务进度、计数，如玩家击杀1个怪物，变量增加1，累计达到指定数值后，完成任务并给予奖励。
实例：#IFcheckmon僵尸1//击杀1个僵尸#ACTincp11//变量p1+1#SAY已击杀1个僵尸，还需击杀9个！
3.变量判断命令（equal、large、small）
格式：#IFequal变量名数值（判断变量是否等于指定数值，如equalp110）；large变量名数值（判断变量是否大于指定数值）；small变量名数值（判断变量是否小于指定数值）
用法：配合变量赋值、增减命令，实现复杂逻辑，如任务累计击杀10个怪物（变量p1=10），则完成任务并给予奖励。
实例：#IFequalp110//变量p1等于10（击杀10个僵尸）#ACTgive任务奖励1movp10//发放奖励，重置变量#SAY任务完成，恭喜你获得奖励！
4.随机变量命令（movr）
格式：movr变量名数值（如movrd06，随机给变量d0赋予1-6之间的数值）
用法：用于随机事件、骰子玩法，随机生成数值，根据数值执行不同脚本动作，增加玩法趣味性。
实例：#ACTmovrd06//随机生成1-6的数值#IFequald06#SAY恭喜你，抽到大奖！give金币10000#ELSEACT#SAY谢谢参与，下次好运！
七、脚本学习注意事项与实战技巧（新手必看）
1.所有命令需在对应脚本文件中编写，NPC脚本放在“Mir200\Envir\NPC”文件夹，机器人脚本放在“Mir200\Envir\Robot_def”文件夹，不可放错路径，否则脚本无法触发。
2.编写脚本前，建议备份对应脚本文件，若修改错误，可直接替换备份文件，避免脚本失效或服务端异常。
3.物品名称、地图名称、技能名称需与服务端数据库完全一致，可在服务端“物品数据库”“地图数据库”中查询准确名称和ID，避免因名称错误导致脚本无法执行。
4.新手学习建议：先从基础命令入手，练习简单脚本（如新手领取装备、道具兑换），熟悉命令格式后，再学习变量命令，编写复杂脚本（如任务脚本、定时脚本）。
5.脚本编写完成后，需重启服务端生效，测试时优先用GM账号手动触发，排查命令错误、路径错误，确认脚本正常执行后，再开放给普通玩家。
6.不同引擎命令细微差异：GOM/GEE引擎部分命令需添加“HOUR”参数（如定时命令），3km2引擎需开启机器人定时功能，若命令无法执行，可查看服务端引擎说明文档，调整命令格式。
8.实战练习建议：新手可先编写“新手引导脚本”，整合基础命令（@标识、#IF、#ACT、give、mapmove），练习条件判断和物品发放，逐步掌握脚本编写逻辑，再尝试编写任务脚本、回收脚本，积累实战经验。
传奇技术脚本学习的核心是多记、多练、多排查，以上命令涵盖新手入门到进阶的全场景用法，无需记忆所有命令，重点掌握常用命令的格式和用法，结合实例练习，即可快速上手脚本编写。遇到命令无法执行、脚本失效等问题，优先检查命令格式、路径、参数是否正确，多数问题均可通过核对修改解决，熟练掌握后，可根据自身需求编写自定义脚本，丰富游戏玩法。