传奇服务端脚本命令大全 常用脚本语法与实操使用教程

传奇服务端所有功能拓展、NPC交互、属性判定、道具发放、地图规则、等级经验调整，全部依托专属脚本命令实现。无论是版本修改、功能新增、BUG修复、自定义活动搭建，都需要依托标准脚本语法与命令执行。不同传奇引擎的基础脚本命令通用度极高，仅少数拓展指令存在细微差异，本文全面汇总服务端核心脚本命令、基础语法结构、分类功能指令与真实落地案例，适配GOM、GEE、BLUE、SKY等主流引擎，无冗余理论，全部为可直接套用的实操内容。
一、传奇服务端脚本基础结构命令
传奇所有自定义脚本都遵循固定基础逻辑框架，由判断语句、执行语句、跳转语句、结束语句组成，是编写所有功能脚本的核心基础，任何自定义NPC、活动、奖励机制都需要依托该结构运行。
#IF 为核心判断指令，作用是判定设定条件是否成立，是所有脚本的起始逻辑语句，可叠加多层判定条件，包含等级、金币、道具、职业、地图、变量等各类检测维度。所有跟在#IF下方的条件语句，都会被系统依次校验，全部满足后才会执行后续操作。
#ACT 为执行指令，搭配#IF判定使用，条件成立后，触发#ACT后方的所有操作命令，包含发放道具、增减经验、扣除货币、跳转界面、修改属性等各类功能。单组脚本中#IF与#ACT为固定搭配，缺一不可。
#ELSEACT 为兜底执行指令，当#IF设定的所有条件全部不满足时，自动执行该指令后的内容，多用于弹出提示文字、返还错误提醒、终止操作流程，是完善脚本容错性的关键命令。
#SAY 为文字输出指令，用于NPC界面、系统弹窗展示自定义文字内容，支持纯文字、变量调用、换行展示，无需额外符号包裹，直接填写展示内容即可。
goto @+标签名 为脚本跳转指令，可让脚本直接跳转到指定标签段落执行对应逻辑，实现分段循环、分支选择、多流程切换效果，常用于复杂活动、多阶段任务脚本编写。
break 为终止指令，执行后直接结束当前整段脚本逻辑，不再向下读取剩余代码，用于阻断多余执行流程，避免脚本冲突。close 为对话关闭指令，多用于NPC交互脚本，操作完成后自动关闭NPC对话界面。
二、人物基础检测脚本命令
此类命令主要用于检测玩家人物基础状态，是NPC领取、权限判定、活动参与门槛设置的核心指令，可单独使用或多层叠加判定。
CHECKLEVELEX 等级检测命令，支持大于、小于、等于数值判定，格式为 CHECKLEVELEX > 数字、CHECKLEVELEX < 数字，用于限制指定等级以上或以下玩家使用对应功能，比如等级达标领取奖励、低等级禁止进入地图。
CHECKGOLD 金币检测命令，用于检测人物背包基础金币数量，格式为 CHECKGOLD >= 数值，可判定玩家金币是否满足消耗条件，用于金币兑换、金币开启功能等场景。
CHECKGAMEGOLD 元宝检测命令，检测人物绑定元宝、通用元宝数量，是版本中付费功能、道具兑换最常用的判定指令，可精准校验玩家元宝储备数值。
CHECKJOB 职业检测命令，支持三职业精准判定，参数为Warr战士、Wizard法师、Taos道士，格式为 CHECKJOB Warr，可限定单一职业使用专属功能，实现职业专属奖励、职业专属buff效果。
CHECKHP、CHECKMP 血量蓝量检测命令，可实时判定人物当前生命值、魔法值，用于残血保护、满血兑换、耗蓝触发技能等自定义功能开发。
三、物品道具检测与操作脚本命令
道具相关脚本命令主要用于检测玩家背包道具、消耗道具、发放道具、清理道具，适配道具兑换、礼包领取、材料合成、道具回收等所有道具类功能。
CHECKITEM 物品检测命令，核心格式为 CHECKITEM 物品名称 数量，精准检测玩家背包内指定道具的持有数量，区分叠加道具与单件道具，是合成、兑换功能的基础判定指令。
TAKE 物品扣除命令，格式为 TAKE 物品名称 数量，条件判定成立后，自动扣除玩家背包对应道具，多用于材料合成、道具兑换、活动报名消耗场景。
GIVE 物品发放命令，格式为 GIVE 物品名称 数量，可自动给玩家背包添加指定道具，支持极品道具、套装、材料、卷轴等所有游戏物品，是礼包脚本、奖励脚本核心指令。
CHECKITEMTYPE 道具类型检测命令，无需指定具体道具名称，可通过道具类型判定，检测玩家是否持有武器、衣服、首饰、药品等指定类型道具，适配通用装备检测功能。
四、人物属性与数据修改脚本命令
此类命令可直接修改玩家人物经验、等级、属性、货币数据，用于升级奖励、属性提升、福利发放、数据重置等自定义功能。
ChangeExp 经验修改命令，格式为 ChangeExp + 数值、ChangeExp - 数值，可增减人物经验数值，常用于泡点升级、打怪额外经验、活动经验奖励脚本。
CHANGELEVEL 等级调整命令，支持直接提升或降低人物等级，多用于新手直升、等级回档、活动等级奖励场景。
GOLD +、GOLD - 金币增减命令，可直接给玩家增加或扣除基础金币，无需玩家手动操作，适配在线奖励、签到金币福利脚本。
GAMEGOLD +、GAMEGOLD - 元宝增减命令，自动调整玩家元宝数量，是各类付费活动、在线奖励、礼包元宝发放的核心指令。
ADDHP、ADDMP 血量魔法上限提升命令，可永久或临时增加人物生命、魔法属性，用于称号属性、buff增益、专属身份加成功能开发。
五、地图与场景判定脚本命令
地图脚本命令用于判定玩家所在地图、限制地图操作、实现地图专属福利、地图专属扣费升级等场景，是地图功能定制的核心指令。
ISONMAP 地图判定命令，格式为 ISONMAP 地图编号，精准检测玩家当前是否处于指定地图，仅对应地图内可触发后续功能，常用于泡点地图、专属地图福利判定。
MAPMOVE 地图跳转命令，格式为 MAPMOVE 地图编号 坐标X 坐标Y，可将玩家直接传送至指定地图指定坐标，用于回城功能、活动传送、专属地图进入通道。
CHECKMAPNAME 地图名称检测命令，通过地图文字名称判定玩家所在场景，适配多地图通用功能设置，无需逐个填写地图编号。
六、系统提示与弹窗脚本命令
提示类命令用于给玩家发送系统弹窗、聊天栏提示、顶部公告，优化脚本交互体验，提示玩家操作结果、条件不满足原因、活动规则等内容。
SENDMSG 系统消息发送命令，格式为 SENDMSG 优先级 提示文字，可在游戏聊天栏弹出对应提示，优先级数字对应展示位置与字体样式，是最常用的提示指令。
SENDTOPMSG 顶部滚动公告命令，可在游戏屏幕顶部弹出滚动文字公告，适合活动通知、奖励提示、规则告知等醒目提示场景。
七、变量与进阶逻辑脚本命令
变量命令用于记录玩家临时数据、单次数据、下线清零数据、永久数据，是复杂任务、累计奖励、次数限制、签到功能的核心支撑，主流引擎变量规则通用。
P0-P99 私人数字变量，关闭对话框后自动重置归零，适合单次交互、临时判定的短期数据记录。D0-D99 下线不保存变量，玩家退出游戏后数据清零，适合每日次数、临时计数功能。
M0-M99 地图清空变量，玩家切换地图后数据归零，适配单地图专属临时功能。N0-N99 小退归零变量，角色小退游戏后数据重置，用于单次上线专属福利判定。S0-S99 字符型变量，可记录文字类数据，用于备注、标记、身份识别等拓展功能。
八、GM管理与服务端刷新脚本命令
此类命令多用于服务端后台、GM控制台，可快速刷新服务端数据、更新配置、重置游戏内容，无需重启服务端，方便版本调试与运营维护。
@ReloadAdmin 刷新管理员配置命令，实时更新GM账号权限列表，新增或修改GM账号后无需重启服务端即可生效。
@ReloadNPC 刷新NPC数据命令，修改NPC脚本、新增NPC功能后，执行命令可实时加载新数据，覆盖旧配置内容。
@RefineWeapon 武器属性调整命令，可自定义修改武器攻击、魔法、道术属性数值，快速调整装备基础属性。
@ClearBonus 清除人物附加属性命令，清空玩家所有临时增益、称号加成、buff附加属性，用于数据重置调试。
九、完整通用脚本实操案例
以下为传奇服务端通用可直接套用的完整脚本，适配所有主流引擎，可直接放入NPC脚本目录使用。
等级达标领取奖励脚本：
[@Main]
#SAY 等级达标可免费领取新手奖励\
#IF
CHECKLEVELEX >= 30
#ACT
GIVE 金条 1
GIVE 双倍经验卷 2
SENDMSG 5 恭喜你领取30级新手奖励
#ELSEACT
SENDMSG 5 等级不足30级，无法领取奖励
元宝兑换金币脚本：
[@Main]
#SAY 100元宝兑换100万金币\
#IF
CHECKGAMEGOLD >= 100
#ACT
GAMEGOLD - 100
GOLD + 1000000
SENDMSG 5 兑换成功，获得100万金币
#ELSEACT
SENDMSG 5 元宝数量不足，兑换失败
指定地图泡点升级脚本：
[@OnTimer7]
#IF
ISONMAP paodian
#ACT
ChangeExp + 50000
#ELSEACT
SENDMSG 5 不在泡点地图，无法获得经验
传奇服务端脚本命令整体通用性极强，绝大多数基础指令不受引擎版本限制，仅高端拓展指令存在细微区别。所有脚本编写需严格遵循层级格式，判定条件与执行命令对应匹配，避免语句错位、指令拼写错误、参数缺失，即可正常运行各类自定义游戏功能。