ESPGetStateValue 获取人物Buff状态剩余时长脚本教程

本文详细讲解传奇脚本中 ESPGetStateValue 指令的使用方法，主要用于读取游戏人物各类负面状态、增益Buff的剩余持续时长，搭配完整参数说明与实战脚本案例，新手也可快速上手套用。

一、指令核心介绍
指令名称：ESPGetStateValue
指令功能：精准获取游戏人物各类状态、Buff效果的剩余持续时长，可适配中毒、麻痹、冰冻、护盾、隐身等多种人物状态，是传奇脚本中状态检测、状态提示的核心常用指令。

二、指令完整参数说明
该指令包含两个核心参数，参数分工明确，可自由搭配变量实现各类状态检测需求，具体参数释义如下：
参数1：状态类型(固定数值对应各类人物状态)
0=绿毒、1=红毒、2=不能攻击、4=不能移动、5=麻痹、8=隐身、9=神圣战甲术、10=幽灵盾、11=魔法盾、12=冰冻、13=紫毒、14=蛛网、15=护体神盾、16=无极真气
参数2：剩余时长：支持所有自定义变量，可将获取到的状态时长赋值给变量，用于后续判断、弹窗提示、文字播报等操作。

三、实战脚本案例：获取人物麻痹状态剩余时长
以下为完整可直接使用的传奇脚本示例，功能为检测人物麻痹状态，实时播报人物是否处于麻痹状态，并显示对应的剩余时长，代码格式规范、可直接复制粘贴使用。
[@获取麻痹状态]
#IF
#ACT
ESPGetStateValue 5 N10
#IF
LARGE N10 0
#ACT
SENDMSG 7 你被麻痹中，剩余时长：<$STR(N10)>
#ELSEACT
SENDMSG 7 你没有被麻痹，剩余时长：<$STR(N10)>

四、脚本使用说明
1、脚本中参数1数值设置为5，对应人物麻痹状态，精准读取麻痹效果剩余时长；
2、通过变量 N10 存储获取到的状态时长数据，全程适配通用脚本变量规则；
3、通过数值判断命令区分有无麻痹状态，分别对应不同的系统文字提示；
4、可根据需求替换参数1的状态数值，适配中毒、冰冻、护盾、隐身等各类人物Buff状态检测。