传奇全套人物检查脚本命令大全 实用触发脚本实例教程
在传奇版本搭建、脚本修改、功能定制的过程中，人物检查类脚本命令是最核心、使用频率最高的基础指令。涵盖地图人数检测、人物状态判断、道具检测、权限设置、列表管理等各类实用功能，能够满足GM搭建版本、自定义游戏玩法、优化游戏机制的各类需求。本文整理了传奇最全的人物检查脚本命令，附带详细功能解析、标准格式、…
在传奇版本搭建、脚本修改、功能定制的过程中，人物检查类脚本命令是最核心、使用频率最高的基础指令。涵盖地图人数检测、人物状态判断、道具检测、权限设置、列表管理等各类实用功能，能够满足GM搭建版本、自定义游戏玩法、优化游戏机制的各类需求。本文整理了传奇最全的人物检查脚本命令，附带详细功能解析、标准格式、实战触发案例，方便传奇开发者直接参考复用。
一、地图人物数量检测脚本命令
1、CHECKMAPHUMANCOUNT 地图人数检测
功能介绍：用于检测指定地图内的在线人物数量，可通过大于、小于、等于符号判断人数范围，常用于地图人数限制、活动开启条件、场景限流等玩法设置。
标准格式：CHECKMAPHUMANCOUNT 地图号 <=> 数量
实战示例：
[@CHECKMAPHUMANCOUNT]
#IF
CHECKMAPHUMANCOUNT 3 < 100
#SAY
地图3内人数小于100人
#ELSESAY
地图3内人数多于100人
2、CHECKHUM 定点地图人数检测
功能介绍：精准检测指定地图内的人物数量，匹配固定人数数值，适配地图人数达标触发专属奖励、场景开启等功能。
标准格式：CHECKHUM 地图号 数量
实战示例：
[@CHECKHUM]
#IF
CHECKHUM 3 2
#SAY
地图3内人数等于2个人！
#ELSESAY
地图3内人数少于2个人！
二、人物位置与场景状态检测命令
1、CHECKINMAPRANGE 坐标范围检测
功能介绍：检测人物是否处于指定地图的XY坐标范围内，可自定义检测范围，常用于定点打卡、区域活动、坐标权限判定等场景。
标准格式：CHECKINMAPRANGE 地图 X Y 范围
实战示例：
[@CHECKINMAPRANGE]
#IF
CHECKINMAPRANGE 3 330 330 10
#SAY
你在指定坐标范围内。
#ELSESAY
对不起，您没有在指定坐标范围内！
2、INSAFEZONE 安全区检测
功能介绍：检测人物当前地图XY坐标是否为安全区，可用于限制安全区内交易、PK、挂机等游戏规则设置。
标准格式：INSAFEZONE X Y
实战示例：
[@INSAFEZONE]
#IF
INSAFEZONE 329 332
#SAY
你在安全区里做什么呢？
3、ISONMAP 当前地图检测
功能介绍：判断人物当前所处地图编号，适配专属地图任务、地图专属福利、跨地图限制等功能。
标准格式：ISONMAP 地图号
实战示例：
[@ISONMAP]
#IF
ISONMAP 3
#SAY
你现在所在地图是盟重！
#ELSESAY
你现在所在地图不是盟重！
三、人物击杀与死亡状态命令
1、CHECKKILLPLAYMON 攻击怪物检测
功能介绍：属于QF攻击触发指令，人物或随从攻击指定怪物时自动触发，可用于怪物攻击提示、专属怪物任务、击杀统计等玩法。
触发方式：[@ATTACK] 攻击触发
实战示例：
[@ATTACK]
#IF
CHECKKILLPLAYMON 白野猪
#ACT
SENDMSG 7 【<$ATTINFO_NAME>】正在攻击你的目标【<$TARINFO_NAME>】
BREAK
2、KillByHum 玩家击杀检测
功能介绍：检测人物是否被其他玩家击杀，包含玩家宝宝击杀场景，可用于击杀提示、红名惩罚、死亡记录等功能。
标准格式：KillByHum
实战示例：
[@KillByHum]
#IF
KillByHum
#ACT
SENDMSG 5 [提示]:你被<$KILLER>杀害.!
CLOSE
#ELSEACT
SENDMSG 5 [提示]:你被<$MONKILLER>杀害.!
CLOSE
注意事项：若被玩家宝宝击杀，系统同样判定为玩家击杀信息。
3、KILL 人物击杀指令
功能介绍：强制击杀当前人物，支持多种击杀模式，可自定义是否掉落物品、是否显示凶手信息。
模式参数： 0=人物死亡，不显示凶手信息；1=人物死亡不掉物品，不显示凶手信息；2=人物死亡，显示凶手信息为NPC；3=人物死亡不掉物品，显示凶手信息为NPC
实战示例：
[@KILL]
#IF
#ACT
KILL 2
4、CHECKSIGNMAP 死亡地点回溯检测
功能介绍：检测人物是否存在死亡记录，支持一键返回上次死亡地点，常用于玩家复活、回城回溯功能。
标准格式：CHECKSIGNMAP
实战示例：
[@CHECKSIGNMAP]
#IF
CHECKSIGNMAP
#SAY
是否回到上次死亡的地点？\
<是/@SignMap> <否 /@exit>
[@SignMap]
#ACT
GMEXECUTE SignMove SELF
四、人物与英雄在线状态检测命令
1、CHECKONLINE 人物在线检测
功能介绍：检测指定玩家账号是否处于在线状态，支持S变量调用，可用于好友状态查询、组队检测、账号监控等场景。
实战示例：
[@CHECKONLINE]
#IF
CHECKONLINE 玩家名称
#SAY
人物在线！
#ELSEACT
MessageBox 人物不在线。
2、CHECKHEROONLINE 英雄在线检测
功能介绍：检测玩家英雄是否成功召唤、处于在线状态，适配英雄专属任务、英雄技能触发等功能。
实战示例：
[@CHECKONLINE1]
#IF
CHECKHEROONLINE
#SAY
英雄在线！
#ELSEACT
MESSAGEBOX 请先召唤出你的英雄！
BREAK
3、HAVEHERO 英雄拥有检测
功能介绍：判断玩家账号是否已创建英雄，用于新手引导、英雄功能解锁、专属福利领取等场景。
实战示例：
[@HAVEHERO]
#IF
HAVEHERO
#SAY
你有英雄
#ELSEACT
MessageBox 你没有英雄，可前往英雄特使处申请英雄。
4、ONLINELONGMIN 在线时长检测
功能介绍：检测玩家本次在线时长，支持大于、小于、等于数值判定，可用于在线时长奖励、挂机福利、防沉迷设置。
标准格式：ONLINELONGMIN <=> 分钟数
实战示例：
[@ONLINELONGMIN]
#IF
ONLINELONGMIN > 10
#SAY
在线时间大于 10分钟
五、人物身份与权限检测命令
1、ISNEWHUMAN 新人玩家检测
功能介绍：识别刚注册进入游戏的新玩家，指令仅执行一次，用于新手礼包、新手引导、首次登录福利等专属功能。
实战示例：
#IF
ISNEWHUMAN
#SAY
你是新人！
#ELSESAY
你不是新人！
2、ISADMIN 管理员身份检测
功能介绍：检测当前玩家是否为游戏管理员，用于GM专属权限解锁、后台功能使用、管理模式判定。
实战示例：
[@ISADMIN]
#IF
ISADMIN
#SAY
你是系统管理员。
#ELSESAY
你不是系统管理员。
3、CHANGEPERMISSION 人物权限设置
功能介绍：自定义设置玩家游戏权限，权限数值区间0-10，10为超级GM权限，多用于账号权限分配、管理员授权。
标准格式：CHANGEPERMISSION 权限数值
实战示例：
[@CHANGEPERMISSION]
#IF
#ACT
CHANGEPERMISSION 10
4、CHANGEMODE 人物模式设置
功能介绍：为管理员账号开启专属游戏模式，包含管理、无敌、隐身三种模式，支持开关控制。
模式参数：1=管理模式，2=无敌模式，3=隐身模式；1为开启，0为关闭
实战示例：
[@CHANGEMODE]
#IF
ISADMIN
#ACT
CHANGEMODE 1 1
CHANGEMODE 2 1
CHANGEMODE 3 1
六、人物付费与离线状态检测命令
1、CHECKPAYMENT 付费时长检测
功能介绍：检测玩家剩余付费游戏时长，精准判定剩余天数，适用于月卡、点卡版本的时长校验与提示。
标准格式：CHECKPAYMENT 天数
实战示例：
[@CHECKPAYMENT]
#if
CHECKPAYMENT 2
#say
您目前剩余游戏时间2天。
2、OFFLINEPLAYERCOUNT 脱机人数检测
功能介绍：统计当前地图内的脱机挂机人数，支持数值范围判定，可用于限制脱机挂机、场景人数管控。
标准格式：OFFLINEPLAYERCOUNT </>/= 数量
实战示例：
[@OFFLINEPLAYERCOUNT]
#IF
OFFLINEPLAYERCOUNT > 300
#SAY
当前地图脱机人数大于300人！
#ELSESAY
当前地图脱机人数小于300人。。。
七、仓库密码状态检测命令
1、ISLOCKPASSWORD 仓库解锁检测
功能介绍：检测玩家仓库是否处于锁定状态，可搭配密码修改、解锁、锁定功能，完善仓库安全机制。
实战示例：
[@CHECKISLOCK]
#IF
ISLOCKPASSWORD
#SAY
新加的密码仓库系统指令说明:\
修改密码：@<$CMD_STORAGESETPASSWORD>\
设置密码：@<$CMD_STORAGECHGPASSWORD>\
锁定仓库：@<$CMD_STORAGELOCK>\
解锁仓库：@<$CMD_STORAGEUNLOCK>\
#ELSESAY
您的仓库已经解锁。
2、PASSWORDERRORCOUNT 密码错误次数检测
功能介绍：统计玩家仓库密码输入错误次数，数值范围1-65535，可用于限制密码输入次数、锁定仓库保护账号。
实战示例：
;检测错误次数等于指定值
[@passworderror1]
#IF
PASSWORDERRORCOUNT = 3
#SAY
您的错误次数等于3。
#ELSESAY
您的错误次数不等于3。
;检测错误次数大于指定值
[@passworderror2]
#IF
PASSWORDERRORCOUNT > 3
#SAY
您的错误次数大于3。
#ELSESAY
您的错误次数不大于3。
;检测错误次数小于指定值
[@passworderror3]
#IF
PASSWORDERRORCOUNT < 3
#SAY
您的错误次数小于3。
#ELSESAY
您的错误次数不小于3。
3、CLEARPASSWORD 清除仓库密码
功能介绍：一键清除玩家仓库密码，多用于GM后台重置玩家仓库密码、账号解封等场景。
实战示例：
[@CLEARPASSWORD]
#IF
#ACT
CLEARPASSWORD
#SAY
你的仓库密码已清除。
八、人物包裹与物品检测命令
1、CHECKBAGSIZE 包裹空格检测
功能介绍：检测玩家包裹剩余空格数量，可用于限制道具拾取、礼包领取、物品兑换等需要空位的功能。
标准格式：CHECKBAGSIZE 剩余空格数
实战示例：
#IF
CHECKBAGSIZE 5
#SAY
您目前剩余包袱空格5个。
2、CHECKDURA 物品品质检测
功能介绍：精准检测玩家包裹内指定物品的纯度、品质数值，适配高纯度道具兑换、专属物品任务等玩法。
实战示例：
[@免费]
#IF
CHECKITEM 金矿 3
CHECKDURA 金矿 15
#SAY
啊？你真的把这些白给我？\
真没想到现如今还有你这样的人，看来还有人情啊。\
我不能白拿这么贵重的东西。\
你有没有听说过命运之刃？\
还有在北门街道小店修理武器之后，有没有仔细看过人？\ \
<返回/@kang>
#ACT
TAKE 金矿 2
TAKECHECKITEM
BREAK
3、CHECKITEM 包裹物品检测
功能介绍：检测玩家包裹内是否拥有指定数量的指定物品，是传奇任务、道具兑换、权限解锁的核心指令。
标准格式：CHECKITEM 物品名称 数量
实战示例：
[@MAIN]
#IF
CHECKITEM 裁决之杖 2
#SAY
你的包裹里有裁决之杖2把。
#ELSESAY
你的包裹里没有2把裁决之杖。
4、ISDUPMODE 人物重叠检测
功能介绍：检测当前人物是否与其他玩家坐标重叠，可用于限制卡位、重叠挂机、场景卡位bug修复。
实战示例：
[@ISDUPMODE]
#IF
ISDUPMODE
#SAY
请找一个空位置，不能与别人站在一起。
九、人物变量数值检测与调整命令
1、CHECKINTS 保存型变量检测
功能介绍：检测人物0-29号保存型变量数值，支持大小等于判定，常用于积分、活跃度、游戏数值统计检测。
实战示例：
[@CHECKINTS]
#IF
CHECKINTS 0 ? 1000
#SAY
你的积分有1000点。
#ELSESAY
你的积分不足1000点！
2、INTS 保存型变量调整
功能介绍：修改人物0-29号保存型变量数值，可搭配变量检测实现积分兑换、数值增减、福利发放等功能。
变量参数：可用变量 <$INTS0>~<$INTS29>
实战示例：
#IF
CHECKINTS 0 ? 1000
#ACT
INTS 0 - 1000
GAMEGOLD + 10
SENDMSG 5 成功使用1000点积分兑换10颗元宝！
#ELSESAY
你的积分不足1000点！
十、人物攻击模式检测与切换命令
1、CHECKATTACKMODE 攻击模式检测
功能介绍：检测玩家当前攻击模式，支持0-6模式判定，适配PK限制、模式校验、玩法规则检测。
模式参数：0=全体，1=和平，2=夫妻，3=师徒，4=编组，5=行会，6=善恶
实战示例：
[@CHECKATTACKMODE]
#IF
CHECKATTACKMODE > 0
#SAY
你现在的攻击模式是全体模式。
2、CHANGEATTACKMODE 攻击模式切换
功能介绍：强制切换玩家攻击模式，可用于活动场景禁止PK、自动切换和平模式等场景。
实战示例：
[@CHANGEATTACKMODE]
#IF
CHECKATTACKMODE > 0
#ACT
CHANGEATTACKMODE 1
#SAY
你现在的攻击模式是和平模式。
3、NOSWITCHATTACKMODE 模式锁定参数
功能介绍：地图专属参数，设置后指定地图内禁止玩家切换攻击模式，多用于行会争霸、竞技地图等场景。
配置格式：在MapInfo txt文件中添加对应参数即可生效
示例配置：[G003 行会争霸地图] NOSWITCHATTACKMODE
十一、文本列表检测与账号名单管理命令
1、CHECKCODELIST 文本列表检测
功能介绍：检测指定文本列表内容，支持清理列表数据，常用于激活码、卡号校验、权限名单核验。
实战示例：
(@@INPUTINTEGER @@INPUTSTRING)
[@@INPUTSTRING6]
#IF
CHECKCODELIST ..\QUESTDIARY\卡号\激活码.TXT HARDDISK
#ACT
CLEARCODELIST ..\QUESTDIARY\卡号\激活码.TXT HARDDISK
#ELSESAY
激活码不正确！\
<返回/@MAIN>
2、CHECKACCOUNTLIST 账号列表检测
功能介绍：核验玩家账号是否在指定文本名单中，多用于会员权限、白名单、专属账号福利判定。
实战示例：
[@MAIN]
#IF
CHECKACCOUNTLIST 帐号.TXT
#SAY
你是会员
#ELSESAY
你不是会员
3、ADDACCOUNTLIST/DELACCOUNTLIST 账号增删列表
功能介绍：实现账号批量添加、删除文本名单功能，适配会员开通、权限取消、白名单管理等场景。
实战示例：
[@ADDACCOUNTLIST]
#IF
!CHECKACCOUNTLIST 帐号.TXT
#ACT
ADDACCOUNTLIST 帐号.TXT
[@DELACCOUNTLIST]
#IF
CHECKACCOUNTLIST 帐号.TXT
#ACT
DELACCOUNTLIST 帐号.TXT
4、CHECKNAMELISTPOSITION 名单排名检测
功能介绍：检测玩家名称在文本名单中的排名位置，支持数值范围判定，可用于排行榜、战力排名、名额筛选。
实战示例：
[@main]
#IF
CHECKNAMELISTPOSITION List.txt < 10
#SAY
您在前10名。
#ELSESAY
您不在前10名。
5、CHECKNAMELIST/ADDNAMELIST/DELNAMELIST 名单管理
功能介绍：检测玩家名称是否在指定名单、新增名单人员、删除名单人员，多用于活动报名、行会名单、赛事名额管理。
实战示例：
[@CHECKNAMELIST]
#IF
CHECKNAMELIST 行会争霸名单.TXT
#SAY
你的名称已经在行会争霸名单里了。
#ELSESAY
你还没有申请行会争霸。
[@ADDNAMELIST]
#IF
!CHECKNAMELIST 行会争霸名单.TXT
#ACT
ADDNAMELIST 行会争霸名单.TXT
[@DELNAMELIST]
#IF
CHECKNAMELIST 行会争霸名单.TXT
#ACT
DELNAMELIST 行会争霸名单.TXT
十二、反向检测指令
!CHECK 反向检测
功能介绍：对所有检测指令进行反向判定，即不满足检测条件时触发对应功能，极大拓展脚本玩法逻辑，适配各类反向限制场景。
