角色与英雄
检测人物在列表中的位置
判断当前人物名称在指定列表中的位置是否满足比较条件，并把位置信息写入 P 变量。
命令名
CheckNameListPosition
命令用途
CheckNameListPosition 用于检测当前人物名称在指定列表中的位置，并按给定条件比较该位置值。
调用格式
CheckNameListPosition <文件地址> <控制符> <位置> <P变量> [HardDisk]
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
文件地址 | 是 | 要检查的位置列表文件。 |
控制符 | 是 | 比较符号，支持 <、>、=。 |
位置 | 是 | 要比较的位置值。 |
P变量 | 是 | 用于接收位置信息的 P 变量，例如 P0。 |
HardDisk | 否 | 实时操作到硬盘，适合需要立即按最新列表内容判断的场景。 |
返回结果
- 条件成立：当前人物名称在列表中的位置满足比较条件。
- 条件不成立：未命中列表，或位置不满足比较条件。
- 位置信息会写入指定的
P变量，供后续脚本继续使用。
示例
基础用法
[@CheckNameListPosition]
#IF
CheckNameListPosition 排行名单.txt < 10 P0
#SAY
你当前在名单前 10 名。
这段写法用于判断当前人物是否位于指定名单前 10 位，并把实际位置写入 P0。
注意事项
- 这条命令检查的是当前人物名称在文件中的顺位，不是帐号顺位，也不是登录 IP 顺位。
- 位序起算方式建议先用一份已知顺序的小名单实测，再把结果接入正式业务流程。