ESPGetBoxItem 传奇OK框物品信息获取函数使用教程

ESPGetBoxItem 传奇OK框物品信息获取函数使用教程
在传奇脚本开发中，OK框物品信息读取是常用的核心功能，通过 ESPGetBoxItem 函数可以快速获取指定OK框内的物品名称、星星数量、来源信息等各类参数，满足脚本物品判定、信息展示、数据统计等开发需求。下面为大家详细讲解该函数的参数用法和实际调用案例。

一、函数基础说明
函数名称：ESPGetBoxItem
核心作用：读取游戏内OK框对应的物品全套信息，支持多维度数据获取，适配各类传奇脚本场景。

二、函数完整参数详解
该函数共包含三个必填参数，参数顺序固定，取值范围明确，具体参数释义如下：
参数一：OK框编号，取值范围 0~7，对应游戏内不同序号的OK物品框。
参数二：获取类型，用于指定需要读取的物品信息维度，具体取值对应功能：
·
0：物品名称
·
·
1：星星数量
·
·
2：来源类型
·
·
3：来源地图名
·
·
4：来源怪物名/来源名
·
·
5：来源角色名称
·
·
6：来源时间
·
参数三：存放变量，用于存储读取到的物品数据，一般使用S系列自定义变量。

三、实战脚本示例(获取OK框物品全部信息)
以下为完整可直接使用的传奇脚本案例，针对0号OK框，批量读取所有维度物品信息，并通过聊天窗口展示数据，代码格式规范、可直接复制使用：
#ACT
ESPGetBoxItem 0 0 S1
ESPGetBoxItem 0 1 S2
ESPGetBoxItem 0 2 S3
ESPGetBoxItem 0 3 S4
ESPGetBoxItem 0 4 S5
ESPGetBoxItem 0 5 S6
ESPGetBoxItem 0 6 S7
SendMsg 6 编号0的OK框物品名称为:[<$STR(S1)>],星星数量:[<$STR(S2)>],来源类型:[<$STR(S3)>],来源地图名:[<$STR(S4)>],来源怪物名称:[<$STR(S5)>],来源角色名称:[<$STR(S6)>],来源时间:[<$STR(S7)>]

四、代码示例说明
1、脚本中分别通过不同的类型参数，将0号OK框的物品各项信息依次存入S1-S7自定义变量中，数据分类清晰、方便后续调用。
2、通过 SendMsg 指令将读取到的所有物品信息整合展示，方便开发者测试数据是否读取成功，也可直接用于游戏内玩家信息展示。
3、可根据实际需求，修改第一个参数(0~7)，读取其他序号OK框的物品数据，适配多物品框场景。