ESPGETGUILDMEMCOUNT 获取指定行会成员数量使用教程

本文详细讲解传奇脚本中 ESPGETGUILDMEMCOUNT 指令的功能、参数含义及实际使用案例，帮助玩家和脚本开发者快速掌握获取行会成员数量的脚本写法，适配各类行会人数统计场景。

一、指令基础介绍
指令名称：ESPGETGUILDMEMCOUNT
核心功能：用于读取并获取游戏中指定行会的在线/总成员数量，是传奇行会脚本中常用的人数统计核心指令。

二、指令参数详解
该指令包含两个必填参数，参数分工明确，可灵活适配自身行会、指定行会两种统计场景，具体说明如下：
参数1：用于存储行会人数数据的变量名称，执行指令后，行会成员数量会自动赋值到该变量中，方便后续调用、展示数据。
参数2：目标行会名称。该参数支持自定义配置，若参数内容为空，默认读取当前玩家自身所在行会的成员数量；若填写具体行会名称，则精准统计对应行会的人数。

三、完整脚本示例
以下为可直接运行的完整脚本案例，实现一键查询当前玩家所在行会人数，并弹窗展示统计结果，代码规范、可直接复制使用：
[@main]
#if
#act
ESPGETGUILDMEMCOUNT N$人数 <$GUILDNAME>
sendmsg 6 你的行会人数为：<$str(N$人数)>

四、脚本代码说明
1、[@main]：脚本主触发入口，为脚本执行的基础启动标签，所有功能代码均在该入口下生效。
2、ESPGETGUILDMEMCOUNT N$人数 <$GUILDNAME>：核心执行代码，定义变量“N$人数”存储数据，通过系统自带变量 <$GUILDNAME> 获取玩家当前行会名称，统计对应行会总人数。
3、sendmsg 6：游戏弹窗消息推送指令，等级6为普通提示弹窗，用于向玩家展示最终的行会人数统计结果。
4、<$str(N$人数)>：数据转换输出，将存储在变量中的数字人数转换为可展示的文本内容，正常显示在游戏弹窗中。

五、使用注意事项
1、变量名称可自定义修改，无需固定使用“N$人数”，只要符合脚本变量命名规则即可。
2、若需查询其他指定行会人数，只需将第二个参数 <$GUILDNAME> 替换为具体行会名称(如“战神行会”)即可。
3、代码复制使用时，需严格保留原有代码格式与符号，避免空格、符号错误导致脚本失效。