传奇地图怪物状态查询脚本 mapBossinfo命令用法详解
一、脚本命令核心功能介绍传奇服务端脚本中，mapBossinfo是专门用于获取当前地图怪物实时状态的核心命令，可精准读取地图内怪物的血量、刷新时间、坐标、归属玩家等核心数据，常用于BOSS提醒、怪物状态监控、区域战力检测等游戏功能开发，是传奇脚本制作中高频使用的实用指令。二、命令基础语法结构完整调用…
一、脚本命令核心功能介绍
传奇服务端脚本中，mapBossinfo是专门用于获取当前地图怪物实时状态的核心命令，可精准读取地图内怪物的血量、刷新时间、坐标、归属玩家等核心数据，常用于BOSS提醒、怪物状态监控、区域战力检测等游戏功能开发，是传奇脚本制作中高频使用的实用指令。
二、命令基础语法结构
完整调用格式：mapBossinfo 参数1 参数2 参数3 参数4 参数5
该命令需按固定顺序填写5个参数，参数缺一不可，空缺参数需填写0占位，确保脚本正常解析运行。
三、五大参数详细释义
3.1 参数1：地图编号
填写传奇服务端对应的地图专属编号，例如盟重地图、石墓地图、祖玛地图的内置数字ID，用于锁定数据查询的目标地图范围。
3.2 参数2：怪物名称
填写需要查询的目标怪物完整名称，支持BOSS怪物、普通小怪自定义查询，名称必须与怪物配置表内名称完全一致，否则无法读取数据。
3.3 参数3：怪物名字显示格式
该参数控制读取后怪物名称的展示样式，仅支持两个数值：
0：默认格式，怪物名称末尾携带生成数字标识；
1：精简格式，自动去除怪物名称末尾的数字后缀。
3.4 参数4：结果存入变量名
指定存储查询结果的字符串变量，常用s1、s2、s3等通用脚本变量，所有读取到的怪物状态数据会统一存入该变量，供后续弹窗、提示、判断功能调用。
3.5 参数5：怪物数据来源范围
用于界定查询的怪物数据来源，支持两种数值设置：
填空或0：仅读取刷怪文本生成的怪物数据；
1：同时读取刷怪文本怪物+脚本命令生成的怪物全部数据。
四、查询结果数据格式说明
4.1 整体拼接规则
命令执行后返回字符串格式数据，单地图多只怪物数据通过&符号分隔，单只怪物的各项状态通过#符号分隔，数据层级清晰，便于脚本拆分调用。
4.2 单怪物数据字段顺序
怪物名称#剩余HP百分比#剩余刷新时间#当前X坐标#当前Y坐标#归属玩家名字
字段释义：
剩余HP百分比：怪物当前血量占总血量的百分比，满血为100，死亡为0；
剩余刷新时间：单位为秒，已刷新存活的怪物该数值固定为0；
坐标信息：怪物在目标地图内的X、Y平面坐标；
归属玩家：怪物当前仇恨归属角色，无归属时默认显示无。
4.3 结果示例解析
示例数据：白野猪#90#0#330#330#玩家1&黑野猪#0#300#320#320#无
解析：白野猪剩余90%血量，已刷新存活，坐标330,330，归属玩家1；黑野猪血量为0，300秒后刷新，坐标320,320，无归属玩家。
五、特殊数据获取规则
第一，通过脚本命令生成的怪物，无论存活或死亡状态，剩余刷新时间固定为0；
第二，同一地图内存在多只同名怪物时，怪物死亡后仅能获取到其中一只的状态信息，无法批量读取同名死亡怪物数据。
六、配置前置要求与案例
6.1 基础配置前提
需要查询的BOSS怪物，必须在cfg_monster.xls怪物配置表中，将对应怪物X列的是否BOSS属性设置为1，否则命令无法精准识别BOSS级怪物数据。
6.2 刷怪文件配置案例
若怪物通过MonGen.txt刷怪文本生成，必须配置死亡自动刷新属性，配置案例：3 330 330 白野猪 5 1 3 0#1 255
七、完整脚本调用范例
[@获取当前地图怪物状态]
#if
#act
MapBossinfo 3 白野猪 0 s2 1
sendmsg 6 获取的是[<$STR(s2)>]
范例说明：锁定3号地图查询白野猪，默认显示带数字名称，数据存入s2变量，同时读取文本和脚本生成的怪物数据，最后通过系统弹窗输出全部状态信息。
八、实操常见问题总结
1. 数据为空：检查地图编号、怪物名称是否与配置文件一致，确认怪物BOSS属性已勾选为1；
2. 无法读取脚本怪数据：将参数5设置为1，开启全来源数据读取权限；
3. 同名怪物信息缺失：属于脚本固有规则，同名死亡怪物仅单条数据可读取，可通过区分怪物名称规避该问题。
