传奇GetListString命令使用方法 读取文本文件数据教程
一、命令核心功能介绍传奇脚本中GetListString是高频实用的读取命令，主要用于读取本地文本文件中的指定行内容，并将读取到的数据存入自定义变量中，方便后续脚本调用数值、人物数据等内容。该命令广泛应用于传奇Quest任务脚本、数值配置、人物属性读取、榜单数据调取等场景，是传奇脚本编写中不可或缺的…
一、命令核心功能介绍
传奇脚本中GetListString是高频实用的读取命令，主要用于读取本地文本文件中的指定行内容，并将读取到的数据存入自定义变量中，方便后续脚本调用数值、人物数据等内容。该命令广泛应用于传奇Quest任务脚本、数值配置、人物属性读取、榜单数据调取等场景，是传奇脚本编写中不可或缺的基础命令。
二、标准命令格式详解
命令格式：GetListString 文件路径 行号(行号从0开始) 变量1 变量2
三、命令参数详细说明
1、文件路径：填写需要读取的文本文件存放路径，支持传奇脚本相对路径写法，无需复杂绝对路径配置，适配传奇服务端默认文件架构。
2、行号：文本内容读取的指定行数，核心规则为行号从0开始计数，文本第一行对应行号0，第二行对应行号1，以此类推。
3、变量1：基础存储变量，用于存放读取到的文本核心内容，为必填参数。
4、变量2：可选存储变量，非必填参数。若需要启用变量2读取数据，文本单行内容必须严格遵循专属格式，否则会出现读取失败、数据错乱等问题。
四、变量2专属文本格式要求
当脚本中调用变量2进行双变量读取时，对应文本文件的单行内容必须采用【名称:数值】的标准格式，精准适配传奇脚本数据解析规则，标准示例格式如下：
人物1:10
人物2:20
该格式可精准拆分文本中的名称与数值，分别对应存入变量1和变量2，实现双数据同步读取，满足复杂脚本的数值调取需求。
五、传奇脚本实战示例
以下为可直接套用的完整传奇脚本示例，适配绝大多数传奇服务端版本，可直接放入Quest任务脚本中使用：
[@main]
#IF
#ACT
GetListString ..\QuestDiary\测试.txt 5 A10 N10
示例解析：该脚本含义为读取服务端QuestDiary目录下【测试.txt】文件中第6行内容（行号5），并将解析后的数据分别存入A10、N10两个自定义变量中，供后续脚本逻辑调用。
六、命令使用注意事项
1、行号计数切勿出错，必须从0开始统计，避免因行数偏差导致读取内容为空或读取错误。
2、使用双变量读取模式时，文本内容必须严格匹配【名称:数值】格式，禁止出现多余空格、特殊符号。
3、文件路径需保证准确无误，相对路径适配传奇默认目录结构，路径错误会直接导致脚本执行失效。
4、文本文件编码需适配传奇服务端，避免编码冲突造成数据读取乱码、脚本不执行等问题。
