传奇脚本教程：checkHumanState检测人物状态命令详解
一、命令核心概述在传奇服务端脚本编写中，人物状态检测是触发攻防判定、技能制衡、Buff管控的核心逻辑，而checkHumanState是专属用于检测被攻击目标、自身人物身上增益、减益及控制状态的核心脚本命令。该命令适配所有主流传奇引擎，支持多级脚本嵌套调用，是制作定制化PK机制、技能触发、怪物AI逻…
一、命令核心概述
在传奇服务端脚本编写中，人物状态检测是触发攻防判定、技能制衡、Buff管控的核心逻辑，而checkHumanState是专属用于检测被攻击目标、自身人物身上增益、减益及控制状态的核心脚本命令。该命令适配所有主流传奇引擎，支持多级脚本嵌套调用，是制作定制化PK机制、技能触发、怪物AI逻辑的基础核心指令。
通过该命令，开发者可精准判断人物是否持有魔法盾、麻痹冰冻、毒素禁锢等状态，以此编写对应的弹窗提示、伤害修正、技能拦截、状态驱散等脚本逻辑，广泛应用于职业技能优化、专属怪物机制、PK规则限制等场景。
二、基础语法规范
2.1 标准调用格式
命令基础书写格式固定，无多余冗余参数，语法简洁适配所有传奇版本脚本编译规则：
checkHumanState 状态代码
2.2 主体调用区分
该命令分为自身检测与目标检测两种调用形式，核心区别在于前缀标识，二者语法逻辑一致，适配不同脚本触发主体：
1、无前缀：checkHumanState 状态代码，用于检测当前触发脚本的人物自身状态；
2、P.前缀：P.checkHumanState 状态代码，用于检测被攻击目标/指定人物状态，也是PK脚本、怪物反击逻辑中最常用的调用方式。
三、全量状态代码对照表
checkHumanState命令内置15种专属状态代码，覆盖传奇所有主流Buff、Debuff及控制效果，所有代码固定不可修改，编写脚本时直接引用数字即可，无需自定义参数：
1=魔法盾，2=护体神盾，3=无极真气，4=幽灵盾，5=神圣战甲术，6=隐身术，7=冰冻，8=麻痹，9=锁定，10=蛛网
11=绿毒，12=红毒，13=禁锢，14=0防御，15=0魔防
补充说明：0防御、0魔防为属性封禁状态，区别于毒素类持续掉血Debuff，主要用于专属装备、封号技能触发的属性剥夺逻辑。
四、脚本示例实战演示
以下为可直接复制使用的原生脚本示例，适配GOM、GEE、BLUE等主流传奇引擎，分别演示自身状态检测与目标状态检测两种常用场景。
4.1 人物自身状态检测脚本
适用场景：玩家自身技能状态提示、自身Buff时效检测、技能释放拦截
[@test]
#IF
CheckHumanState 1
#SAY
当前攻击目标魔法盾持续中
4.2 被攻击目标状态检测脚本
适用场景：怪物检测玩家状态触发反击、PK时目标状态提示、针对性伤害加成
[@test1]
#IF
P.CheckHumanState 1
#SAY
当前目标魔法盾持续中
五、高级使用注意事项
5.1 多级脚本嵌套支持
checkHumanState原生支持多级脚本嵌套调用，可与#CALL、条件分支、循环脚本组合使用，实现复杂逻辑。例如嵌套检测目标同时携带麻痹+红毒双状态，触发专属伤害减免效果。
5.2 状态判定优先级
控制类状态（冰冻、麻痹、禁锢）判定优先级高于Buff类状态，编写脚本时建议优先检测控制状态，再判定防御、增益状态，避免逻辑冲突导致脚本失效。
5.3 版本适配说明
1-15号状态代码为通用标准代码，全版本传奇通用，部分定制复古版本若修改过状态ID，需对照服务端状态配置文件微调数字参数，基础语法无需改动。
六、常用实战拓展场景
1、反隐身机制：通过检测6号隐身术状态，编写怪物识破隐身脚本，让BOSS自动攻击隐身玩家；
2、毒素叠加判定：同时检测11号绿毒、12号红毒状态，触发双毒叠加掉血倍率效果；
3、属性封禁反击：检测14号0防御、15号0魔防状态，给被封禁目标增加固定暴击伤害；
4、护盾击破逻辑：检测目标无1/2号护盾状态时，触发破盾增伤脚本，贴合主流PK玩法。
