传奇脚本教程：利用ESPGetItemsNumber读取背包物品数量
摘要：详解传奇ESP插件核心函数ESPGetItemsNumber使用方法，讲解背包道具数量读取、条件判定实操技巧，附带可直接套用的传奇脚本源码，解析函数参数逻辑与使用避坑要点，帮助传奇GM快速完成背包物品检测功能开发。…
一、函数基础介绍
ESPGetItemsNumber是ESP插件内置的核心检测函数，主要用于传奇服务端中读取玩家背包内指定道具存量。借助该指令，GM可实现道具统计、任务物品校验、道具缺口判定等功能，适配版本制作、任务脚本、道具兑换等主流传奇开发场景。
二、函数语法与参数详解
函数指令：ESPGetItemsNumber
该脚本指令共配置三个参数，两种运行逻辑可自由切换，分别适配单纯数量读取和条件判定场景，各项参数用途解析如下：
参数1：物品名字
填写服务端物品DB中的原始名称，字符、大小写必须和数据库完全一致，道具名称匹配错误是背包物品读取失效的最常见原因。
参数2：变量名
自定义数值变量，用来寄存读取到的道具数量数据，行业内普遍使用N系列全局变量，可灵活用于弹窗提示、脚本条件判断等场景。
参数3：目标数量
功能切换参数，控制脚本运行逻辑：参数留空或填0时，仅返还玩家背包内道具实际数量；参数设置为正整数时，系统自动比对存量与目标值，存量达标返回0，存量不足则返还缺失数量。
三、完整实战脚本示例
下方示范脚本基于ESP插件环境编写，包含道具数量查询、达标判定两个常用功能，全版本通用，GM可直接复制到服务端中测试使用。
[@main]
;读取背包疗伤药实际数量并弹窗提示
#if
#act
ESPGetItemsNumber 疗伤药 N0
SendMsg 6 你的背包共有疗伤药【<$STR(N0)>】个
;校验背包疗伤药是否满足10个目标要求
#if
#act
ESPGetItemsNumber 疗伤药 N0 10
#if
Equal N0 0
#act
SendMsg 6 你需要疗伤药10个，你的背包的疗伤药数量已经足够了
#elseact
SendMsg 6 你需要疗伤药10个，你目前还缺少【<$STR(N0)>】个
四、脚本逻辑解析
基础数量读取：脚本不填写第三参数时，系统直接抓取玩家背包疗伤药的真实数量，通过SendMsg弹窗指令展示给玩家，多用于库存查询类功能。
条件缺口判定：设定目标道具数量后，服务端自动完成存量比对。满足设定数量时变量返回0，触发达标提示；存量不足时变量返回差值，精准提示玩家当前缺少的道具数量，广泛用于任务领取、道具兑换前置校验。
五、常见使用注意事项
自定义道具、带特殊符号的道具，务必核对物品DB原始命名后再写入脚本，名称偏差会导致ESPGetItemsNumber无法识别背包道具。
脚本开发优先选用N系列全局变量，局部变量在跨脚本调用时容易出现数据丢失，影响背包数量检测结果的准确性。
该函数仅扫描玩家当前背包区域，不会识别穿戴装备、仓库库存及回收仓道具，仓库道具统计需要搭配专属仓库读取脚本联动实现。
目标数量参数仅支持非负整数，输入负数、特殊字符会触发脚本报错，日常制作版本时，数值建议控制在0-99999区间最为稳定。
