传奇GetStateValue脚本指令 人物状态剩余时长获取教程
在传奇游戏脚本制作中，人物状态检测是各类功能开发的核心基础，无论是PK状态提示、buff/debuff时长展示，还是技能限制判定，都需要精准获取人物各类状态的剩余持续时间。GetStateValue作为传奇专用的状态时长获取脚本指令，能够高效读取人物各类异常状态、技能buff的剩余时长，适配绝大多数…
在传奇游戏脚本制作中，人物状态检测是各类功能开发的核心基础，无论是PK状态提示、buff/debuff时长展示，还是技能限制判定，都需要精准获取人物各类状态的剩余持续时间。GetStateValue作为传奇专用的状态时长获取脚本指令，能够高效读取人物各类异常状态、技能buff的剩余时长，适配绝大多数传奇版本的脚本开发需求。
一、GetStateValue指令核心作用
该指令主要用于精准获取人物状态剩余时长，可读取游戏内绿毒、红毒、麻痹、隐身、魔法盾、冰冻等十余种人物专属状态的剩余持续时间，支持搭配各类变量使用，广泛应用于传奇提示脚本、状态监控脚本、技能限制脚本等场景，是传奇脚本开发中使用率极高的基础指令。
二、指令完整参数详解
GetStateValue指令包含两个必填参数，参数分工明确，搭配使用即可精准调取对应人物状态数据，具体参数规则如下：
参数1：状态类型，专属数值对应固定人物状态，具体对应关系如下：
0=绿毒、1=红毒、2=不能攻击、4=不能移动、5=麻痹、8=隐身、9=神圣战甲术、10=幽灵盾、11=魔法盾、12=冰冻、13=紫毒、14=蛛网、15=护体神盾、16=无极真气
参数2：剩余时长，支持传奇脚本所有通用变量，可自定义变量存储状态剩余时长，方便后续调用、判断、弹窗提示等操作。
三、传奇脚本实战示例（获取麻痹状态剩余时长）
下面为大家分享可直接复制使用的完整脚本案例，功能为检测人物麻痹状态，实时提示玩家自身麻痹剩余时长，无状态则正常提示无麻痹效果，代码格式规整、兼容主流传奇版本：
[@获取麻痹状态]
#IF
#ACT
GetStateValue 5 N10
#IF
LARGE N10 0
#ACT
SENDMSG 7 你被麻痹中，剩余时长：<$STR(N10)>
#ELSEACT
SENDMSG 7 你没有被麻痹，剩余时长：<$STR(N10)>
四、脚本代码解析
1. 脚本触发标签[@获取麻痹状态]，可自定义名称，方便绑定NPC、技能、登录触发等场景。
2. 核心执行指令GetStateValue 5 N10，其中数值5对应人物麻痹状态，N10为存储时长的自定义变量。
3. 通过LARGE判断变量数值，区分人物处于麻痹状态、无麻痹状态两种情况。
4. SENDMSG为游戏弹窗提示指令，可将状态剩余时长直观展示给玩家，提升游戏体验。
