ESPGetItemsNumber 获取背包指定物品数量功能使用教程

在脚本开发过程中，经常需要读取玩家背包内指定物品的数量，以此实现物品数量校验、条件判断、道具不足提示等各类功能。本文详细讲解ESPGetItemsNumber 指令的使用方法、参数规则以及实战应用案例，方便开发者快速掌握并落地使用。

一、功能指令概述
ESPGetItemsNumber获取背包指定物品的数量
二、指令详细参数说明
该指令共包含三个参数，每个参数的用法、传参规则和返回效果各不相同，具体参数详解如下：
参数1：物品名字
填写需要检测的背包物品完整名称，必须和游戏内物品数据库名称保持一致，确保指令能够精准匹配目标物品，避免检测失效。
参数2：变量名
自定义变量名称，用于存储指令获取到的物品数量数据，后续可通过调用该变量，实现数据展示、条件判断等操作。
参数3：需要的数量
该参数为可选判断参数，核心逻辑分两种场景：参数为空或者数值为0时，参数2变量直接返回背包内该物品的实际持有数量；参数数值大于0时，系统会自动对比玩家持有数量与目标数量，变量返回差值(未达标返回缺少数量，数量达标统一返回0)。

三、完整实战代码实例
以下为可直接复制使用的完整脚本案例，包含物品数量查询、数量达标校验、道具缺口提示三种常用场景，适配绝大多数脚本开发需求。
[@main]
#if
#act
; 获取背包内疗伤药实际总数量，存入变量N0
ESPGetItemsNumber 疗伤药 N0
; 弹窗展示当前背包物品数量
SendMsg 6 你的背包共有疗伤药[<$STR(N0)>]个

#if
#act
; 判断是否拥有10个疗伤药，计算数量差值
ESPGetItemsNumber 疗伤药 N0 10
#if
Equal N0 0
#act
; 变量为0代表数量达标
SendMsg 6 你需要疗伤药10个，你的背包的疗伤药数量已经足够了
#elseact
; 变量不为0代表存在数量缺口，展示缺少数量
SendMsg 6 你需要疗伤药10个，你目前还缺少[<$STR(N0)>]个

四、代码逻辑解析
1、基础数量查询：通过不传第三个参数的方式，直接读取玩家背包疗伤药的真实数量，借助 SendMsg 指令将数据展示在玩家界面。
2、定量条件判断：设置目标数量为10个，系统自动校验玩家持有数量。当物品数量满足10个时，变量N0返回0，触发数量充足提示；当物品数量不足时，变量N0返回缺少的具体数量，精准展示缺口数值。

五、使用注意事项
1、物品名称必须精准匹配，严禁错别字、简称，否则会出现读取数量为0、检测失效等问题。
2、自定义变量名可随意修改，但脚本内调用变量时必须保持前后一致。
3、第三个参数仅支持数字格式，填写非数字内容会导致指令无法正常执行。