GetListString命令用于读取文本文件指定行内容并赋值给变量，适配HERO、GOM、GEE主流引擎，常用于任务系统、配置读取场景。以下详解用法、参数格式，及脚本报错、仅读第一行的问题排查。
一、GetListString命令基础用法
1. 命令语法格式
核心语法：GetListString 文本文件路径 读取行数 目标变量。三者缺一不可，参数顺序固定，语法错误会直接导致脚本失效。
参数说明：文本文件路径需填写相对路径或绝对路径，相对路径以脚本所在文件夹为基准；读取行数为正整数，从1开始计数，对应文本文件中行号；目标变量需符合引擎变量规则，常用角色变量（HUMAN前缀）或临时变量。
2. 正确使用示例
以读取主线名称.txt为例，脚本写法如下（适配多数引擎）：
#IF
CHECK [102] 1 ;触发条件，检测变量[102]值为1
#ACT
MOV N主线段数 1 ;给行数变量赋值为1，无需嵌套STR函数
GetListString ..\QuestDiary\二明专用\任务系统\任务变量\主线名称.txt $N主线段数 S主线名称
SendMsg 6 读取内容：$S主线名称 ;验证读取结果
说明：变量赋值直接使用变量名，无需添加<$STR()>嵌套，目标变量S主线名称直接接收读取内容，调用时用$前缀即可。
3. 适用场景与注意事项
适用场景：任务对话、地图跳转配置、多选项读取等，需批量读取文本内容时优先使用。注意事项：文本文件需为ANSI编码，路径中文件夹名称避免含特殊字符、空格；命令仅能读取纯文本文件，不可读取加密、格式错乱的文件。
二、脚本报错原因及解决方案（MOV命令报错）
1. 核心报错原因分析
你提供的脚本中，报错[脚本错误] 脚本命令:MOV ，根源是变量赋值语法错误：MOV命令后直接嵌套<$STR(N主线段数)>，引擎无法识别嵌套格式的参数，MOV命令仅支持“变量名+数值/常量”的直接赋值格式，不可叠加STR函数嵌套。
次要原因：变量名格式不规范，部分引擎对变量名前缀有要求（如HERO引擎角色变量需加HUMAN前缀），未按规则命名也可能触发报错。
2. 分步解决报错步骤
第一步：修正MOV命令赋值格式。删除<$STR()>嵌套，直接使用变量名赋值，正确写法为“MOV N主线段数 1”，若为角色变量需标注前缀，如“MOV HUMAN主线段数 1”，确保变量名无特殊字符、无空格。
第二步：统一变量调用格式。GetListString命令中，读取行数参数直接使用变量名（如$N主线段数），无需再次嵌套函数，目标变量同理，避免格式冗余导致引擎解析失败。
第三步：校验变量合法性。确认变量名未与引擎内置变量冲突（如避免使用“HP”“Attack”等内置变量名），变量名长度控制在15字符内，仅支持字母、数字、下划线组合。
3. 报错修正后完整脚本
#IF
CHECK [102] 1
#ACT
MOV HUMAN主线段数 1 ;角色变量，加HUMAN前缀确保持久化
GetListString ..\QuestDiary\二明专用\任务系统\任务变量\主线名称.txt $HUMAN主线段数 HUMAN主线名称
SendMsg 6 已读取第$HUMAN主线段数行，内容：$HUMAN主线名称
三、仅读取第一行内容的问题排查
1. 四大核心原因
原因一：文本文件格式错误。Windows系统创建的文本默认行结束符为\r\n，部分引擎仅识别\n换行符，导致无法读取后续行，误判为只有一行内容。
原因二：变量未递增或赋值错误。若需循环读取多行，未添加变量递增脚本，读取行数始终为1，仅能读取第一行；或变量赋值后未同步更新，保持初始值不变。
原因三：文本文件编码异常。编码格式为UTF-8、Unicode时，引擎无法正确解析行分隔符，仅能读取首行，甚至出现乱码。
原因四：路径或文件名错误。路径填写错误导致引擎读取到缓存文件或空文件，看似仅读第一行，实则未读取到目标文件。
2. 针对性解决方法
方法一：转换文本文件格式。用Notepad++打开主线名称.txt，点击“格式”选择“转换为Unix格式”，同时将编码设为“ANSI”，保存后重启服务端，确保引擎正常识别换行符。
方法二：添加变量递增脚本（循环读取场景）。若需读取多行，在脚本中添加变量递增指令，示例：
#IF
CHECK [102] 1
#ACT
MOV HUMAN主线段数 1
LoopStart: ;循环标记
GetListString 文本路径 $HUMAN主线段数 HUMAN主线名称
SendMsg 6 第$HUMAN主线段数行：$HUMAN主线名称
ADD HUMAN主线段数 1 ;变量递增
CHECKVAR HUMAN主线段数 <= 3 ;读取3行后停止
GOTO LoopStart ;跳转循环
方法三：校验路径与文件完整性。核对文本文件路径，确保文件夹层级正确，可先将文本文件放在QuestDiary根目录，用相对路径“主线名称.txt”测试，排除路径层级错误；同时确认文件无损坏，重新创建文本并复制内容粘贴，避免格式错乱。
四、不同引擎适配调整
1. HERO引擎适配
HERO引擎变量需区分角色变量与临时变量，角色变量必须加HUMAN前缀，GetListString命令无额外语法调整，示例：
MOV HUMAN主线段数 2
GetListString 主线名称.txt $HUMAN主线段数 HUMAN主线名称
同时需在引擎配置工具中开启“变量持久化”，避免下线后变量丢失导致读取异常。
2. GOM/GEE引擎适配
支持无前缀临时变量，路径中可含中文文件夹，无需额外配置变量前缀，仅需确保命令格式正确；GEE引擎需勾选“脚本命令扩展支持”（在配置工具“功能设置”中），否则可能无法识别GetListString命令。
3. 通用适配原则
不同引擎核心语法一致，差异仅在于变量前缀与功能开关，优先使用角色变量（加对应前缀），确保读取内容可跨场景调用；测试时先简化脚本，用最短路径、最少参数验证命令有效性，再逐步扩展功能。
五、常见问题补充排查
1. 读取内容为空或乱码
原因：编码格式错误或文件路径错误。解决方案：统一转为ANSI编码，核对路径是否含中文、特殊字符，用绝对路径（如D:\Mirserver\Mir200\Envir\QuestDiary\主线名称.txt）测试，排除相对路径歧义。
2. 命令无反应，无报错也无结果
原因：引擎未开启命令支持，或文本文件行数不足。解决方案：在引擎配置工具中检查“脚本扩展命令”是否开启；核对读取行数是否超过文本实际行数，确保行数参数小于等于文件总行数。
3. 循环读取时卡死
原因：缺少循环终止条件，导致无限循环。解决方案：添加CHECKVAR判断或计数限制，如设定读取上限行数，避免无限循环占用引擎资源，导致服务端卡顿。
六、新手实操建议
1. 先测试基础功能。初次使用时，简化脚本仅保留赋值、读取、提示指令，验证命令可正常运行后，再添加触发条件、循环逻辑，降低排查难度。
2. 备份文本与脚本。修改前备份目标文本文件及脚本，避免格式错误或语法错误导致原有配置丢失，便于回滚恢复。
3. 借助引擎日志排查。若仍有异常，查看服务端日志文件（如HeroLog、GomLog），日志会标注具体错误位置（行号、参数），精准定位问题根源。
