传奇脚本教程：ESPQueryTargetEx检测人物怪物坐标功能用法
摘要：详解传奇ESP插件ESPQueryTargetEx命令用法，解析人物怪物范围检测脚本参数，提供可直接复制的魔龙教主查询传送成品脚本，教你制作升级版探魔球功能，适配所有传奇ESP插件版本开发。…
一、功能概述：替代探魔球的范围对象检测脚本
在传奇版本制作中，范围检测人物、怪物位置是常用功能，传统探魔球功能存在适配局限。传奇ESP插件内置ESPQueryTargetEx脚本命令，可自定义地图、对象类型、检索数量，精准查询玩家或怪物的地图、坐标、名称等信息，完美复刻进阶探魔球效果，广泛用于BOSS定位、玩家筛查、定点传送等版本功能开发。
该核心命令最大优势为可定向指定地图检索，支持批量获取目标数据并将信息存入自定义变量，搭配地图传送命令即可实现一键跳转目标点位，是传奇ESP插件定制功能性脚本的核心指令。
二、ESPQueryTargetEx命令完整参数解析
本命令共10个固定参数，参数顺序不可调换，精准控制检索范围、目标类型及变量存储规则，具体参数释义如下：
参数1：指定地图号 设定需要检索的目标地图ID，填写传奇服务端标准地图编号，仅限单一地图定向检索。
参数2：寻找类型 0=仅检索玩家人物，1=仅检索游戏怪物，二选一区分检索对象主体。
参数3：寻找数量 填0代表检索地图内所有符合条件目标；填写大于0的数字，代表限定检索目标数量。
参数4：寻找名称 填写精准怪物名、玩家名，支持模糊匹配，定向筛选指定名称的检索对象。
参数5：保存地图名变量 自定义字符串变量，用于存储检索到目标所在的地图中文名称。
参数6：保存地图号变量 自定义字符串变量，存储目标所在地图ID，专为mapmove传送命令调用。
参数7：保存对象名变量 自定义字符串变量，存储检索到的玩家名称或怪物名称。
参数8：保存坐标X变量 自定义字符串变量，存储目标所在地图X轴坐标。
参数9：保存坐标Y变量 自定义字符串变量，存储目标所在地图Y轴坐标。
参数10：共找到数量 数值型变量，统计本次检索命中的目标总数；若参数3设定固定数量，该参数同步留存设定值。
三、核心使用注意事项
1、变量存储规则：多目标检索时，插件会自动为变量添加下标后缀，格式为【变量名_0、变量名_1】，依次对应第1、第2个检索目标，调用时下标不可缺失。
2、传送调用要求：用于地图传送的地图号必须调取参数6存储的变量，不可手动填写地图ID，避免跨图传送失效。
3、数量参数联动：参数3设为0时，参数10自动统计全量目标数量；参数3为固定数值时，参数10与参数3数值保持一致。
四、完整可直接使用脚本示例（魔龙教主批量查询+一键传送）
以下脚本为成品测试脚本，可直接复制到传奇服务端NPC脚本中使用，功能为在1号地图检索5只魔龙教主，展示目标信息并支持一键传送至怪物坐标，适配所有搭载ESP插件的传奇版本。
[@查询对象]
#if
#act
;ESPQueryTargetEx 地图号 检索类型 检索数量 目标名称 地图名变量 地图号变量 对象名变量 X坐标 Y坐标 命中数量
ESPQueryTargetEx 1 1 5 魔龙教主 S$地图名变量 S$地图号变量 S$对象名变量 S$对象X坐标 S$对象Y坐标 N32
#if
#say
;下标_0为第一个目标，依次递增展示检索结果
<$STR(S$地图名变量_0)> <$STR(S$地图号变量_0)> <$STR(S$对象名变量_0)> <$STR(S$对象X坐标_0)> <$STR(S$对象Y坐标_0)> <去杀怪/@去0>\
<$STR(S$地图名变量_1)> <$STR(S$地图号变量_1)> <$STR(S$对象名变量_1)> <$STR(S$对象X坐标_1)> <$STR(S$对象Y坐标_1)> <去杀怪/@去1>\
[@去0]
#if
#act
;调用存储变量传送至第一个目标坐标
mapmove <$STR(S$地图号变量_0)> <$STR(S$对象X坐标_0)> <$STR(S$对象Y坐标_0)>
[@去1]
#if
#act
;调用存储变量传送至第二个目标坐标
mapmove <$STR(S$地图号变量_1)> <$STR(S$对象X坐标_1)> <$STR(S$对象Y坐标_1)>
五、脚本拓展应用场景
1、智能BOSS预警：利用该命令定时检索全地图BOSS，将坐标推送至玩家，替代传统探魔球的单次探测限制。
2、玩家定位筛查：将参数2改为0，可检索指定地图内指定玩家，用于GM巡查、会员定位、跨区玩家筛查。
3、定点怪物刷新校验：检索指定名称怪物数量，结合条件判断实现怪物数量不足时自动刷新，优化版本生态。
4、区域传送卷轴：封装脚本后制作专属传送道具，点击后自动检索目标点位并传送，提升版本趣味性。
