传奇脚本GetStringPos字符串下标查询功能使用教程
一、功能核心介绍GetStringPos是传奇脚本中常用的实用字符串处理功能，核心作用为精准获取指定字符串在目标文本列表中的对应下标位置，广泛应用于传奇游戏脚本判定、权限识别、文本数据匹配等场景，是搭建Quest任务脚本、玩家权限检测脚本的基础核心指令。该功能运行后会将最终返回值存入人物N0变量，方…
一、功能核心介绍
GetStringPos是传奇脚本中常用的实用字符串处理功能，核心作用为精准获取指定字符串在目标文本列表中的对应下标位置，广泛应用于传奇游戏脚本判定、权限识别、文本数据匹配等场景，是搭建Quest任务脚本、玩家权限检测脚本的基础核心指令。
该功能运行后会将最终返回值存入人物N0变量，方便后续脚本进行条件判断、指令触发等联动操作，适配绝大多数传奇版本的自定义脚本开发需求。
二、标准使用格式
GetStringPos 路径 字符串
参数解析：第一个参数为目标文本文件路径，第二个参数为需要检索匹配的目标字符串，参数顺序不可颠倒，否则会导致脚本执行失效。
三、功能返回值说明
1、正常检索成功：系统自动将目标字符串在文本列表中的下标数值，赋值到人物N0变量中；
2、检索匹配失败：若目标文本中无对应字符串，N0变量值固定为9999999，可通过该固定数值判定匹配结果。
四、脚本条件检测规则
GetStringPos功能的返回值可搭配EQUAL指令完成条件检测，实现精准的脚本分支判断。开发者可根据N0变量的返回数值，设置不同的游戏触发效果、权限开启、任务进度判定等玩法逻辑，适配各类传奇自定义脚本场景。
五、完整可直接使用脚本案例
以下为实测可用的传奇脚本代码，格式规整、无冗余代码，可直接复制套用，用于检测文本内指定字符串下标：
[@main]
#IF
#ACT
GetStringPos ..\QuestDiary\测试.txt 管理员
SendMsg 5 字符串在列表中的位置:<$STR(N0)>
脚本解析：该脚本以QuestDiary目录下的测试文本为检索对象，检索“管理员”字符串的下标位置，最终通过游戏弹窗消息展示具体下标数值，方便开发者调试脚本、检测文本数据匹配状态。
六、脚本使用注意事项
1、文本路径填写必须准确无误，目录层级、文件名称需完全匹配，大小写严格区分，避免路径错误导致检索失效；
2、目标字符串需与文本内内容完全一致，包含符号、文字格式统一，否则会出现匹配失败，返回9999999数值；
3、所有条件判断逻辑需依托EQUAL指令执行，可精准区分匹配成功、匹配失败两种场景，完善脚本逻辑。
