传奇QM脚本常用触发条目大全 服务端登录定时脚本用法详解

在传奇服务端搭建与脚本修改工作中，QManage.txt（简称QM）是核心脚本文件，掌控着服务端启动、玩家登录、功能触发、变量加载等核心运行逻辑。传奇版本的基础功能、自定义玩法与各类系统设定，大多依托QM脚本的各类触发条目实现。本文汇总整理传奇QM脚本常用触发条目，清晰讲解各类脚本的触发规则与适用场…

在传奇服务端搭建与脚本修改工作中，QManage.txt（简称QM）是核心脚本文件，掌控着服务端启动、玩家登录、功能触发、变量加载等核心运行逻辑。传奇版本的基础功能、自定义玩法与各类系统设定，大多依托QM脚本的各类触发条目实现。本文汇总整理传奇QM脚本常用触发条目，清晰讲解各类脚本的触发规则与适用场景，方便传奇技术爱好者查阅使用、快速落地脚本修改与开发工作。

一、服务端启动触发脚本

触发标识：[@Startup]

该脚本为传奇服务端基础核心触发机制，仅在服务端启动、程序初始化加载时单次执行。主要用于版本基础参数配置、全局变量初始化、系统功能开启、活动数据初始化、每日数据重置等全局操作，是搭建传奇版本基础框架的核心脚本，所有服务端全局初始配置均可在此编写实现。

二、玩家登录触发脚本

触发标识：[@Login]（登录脚本通用俗称）

[@Login]也是行业俗称的登录脚本，是传奇版本高频使用的核心触发条目，会在玩家登录游戏、加载角色数据时自动执行。可用于实现登录奖励发放、登录状态检测、新人权限初始化、角色数据补全、在线记录统计、登录弹窗提示等功能，适配各类玩家登录相关的自定义玩法开发。

三、定时器触发脚本

触发标识：[@OnTimerX]、[@OnTimerExX]（个人定时器、全局定时器）

QM脚本定时器分为个人定时器与全局定时器，是实现游戏定时功能的关键。其中[@OnTimerX]属于个人定时器，针对单个在线玩家循环触发，适用于个人定时buff、专属任务倒计时、个人福利刷新等个性化功能；[@OnTimerExX]为全局定时器，作用于全服所有玩家，多用于全服定时活动、系统定时刷新、全局状态检测等公共场景，是传奇自定义玩法开发的重要支撑。

四、全服指令调用脚本

触发标识：[GMEXECUTE StartQuest]

[GMEXECUTE StartQuest]主要用于全服统一调用任务与各类系统功能，支持通过GM指令一键触发全服玩法。日常多用于开启限时全服活动、批量触发玩家任务、启动版本特色功能、全局任务数据刷新等场景，无需玩家手动触发，由服务端统一执行，有效提升版本调试和运营操作效率。

五、行会变量申明脚本

触发标识：[@LoadGuild]

[@LoadGuild]是传奇行会系统专属的变量加载触发条目，在行会数据初始化、版本加载、服务器重启读取行会数据时自动触发。主要用于申明行会专属变量、初始化行会属性、配置行会权限、重置行会日常数据、设置行会专属福利，是开发行会特色玩法、优化行会系统的核心脚本。

六、国家变量申明脚本

触发标识：[@LoadNation]

[@LoadNation]适配传奇国战、阵营类版本，用于自定义国家与阵营变量的申明和加载，在服务端初始化、阵营数据刷新时触发。可实现国家属性配置、阵营权限设定、国别专属功能初始化、阵营数据同步等操作，是阵营对抗、多国版本开发的必备脚本条目。

七、指定玩家触发脚本

触发标识：HCALL

HCALL为指定玩家专属触发指令，区别于全服触发机制，可精准定向单个或多名玩家执行脚本功能。常用于定制玩家专属福利、单独触发指定角色任务、调整个别玩家权限、激活专属活动、修复玩家异常数据等精细化操作，适配各类个性化定制开发与运维调试需求。