GOM引擎GetListString脚本教程 - 文本文件读取与变量赋值设置方法

GetListString是GOM引擎专属的文件读取脚本命令，核心用于读取本地文本文件指定行数内容并赋值给自定义变量，适配版本技术研究与脚本功能测试场景。

很多零基础脚本学习者在做自定义数据读取、自定义数值调用功能时，常遇到文本内容无法读取、变量赋值失效、行数读取错误等问题，该脚本可完美解决本地文本数据批量调用、单行数据精准提取的实操需求。

命令原理

GetListString脚本的核心运行原理为精准定位本地文本文件路径，根据设置的行号提取对应单行内容。

脚本支持单变量与双变量两种赋值模式，适配不同格式的文本数据读取需求，全程在本地版本环境中运行调试。

单变量模式下可直接读取整行文本内容，双变量模式可拆分冒号格式的键值对数据，实现数据分类赋值。

命令格式

本脚本拥有固定标准命令格式，无多余修饰参数，新手可直接对照套用，适配所有新版GOM引擎本地测试版本。

标准命令格式：GetListString 文件路径 行号(行号从0开始) 变量1 变量2

格式拆解说明：命令由四部分组成，变量2为可选参数，可根据文本格式灵活选择是否启用。

实操示例：GetListString ..\QuestDiary\测试.txt 5 A10 N10

参数详解

该脚本共包含四个核心参数，各参数功能独立、搭配使用即可完成文本读取，具体参数明细如下：

拓展案例

初级入门案例（零基础基础套用）

适配纯文本单行内容读取场景，无需拆分数据，仅使用单变量完成赋值操作。

在QuestDiary目录创建【基础数据.txt】文件，首行写入“新手基础属性”文本内容。

编写脚本读取文件首行内容，赋值给变量A01，实现文本内容直接调取显示。

[@main]
#IF
#ACT
GetListString ..\QuestDiary\基础数据.txt 0 A01
SENDMSG 6 读取内容：<$A01>

中级优化案例（双变量数据拆分）

适配键值对格式文本，使用双变量拆分名称与数值，实现数据精准分类读取。

在测试文本文件第3行写入“攻击:50”，通过行号2精准读取并拆分两个变量数据。

脚本运行后可分别调取名称变量与数值变量，用于属性赋值、条件判断等功能。

[@main]
#IF
#ACT
GetListString ..\QuestDiary\测试.txt 2 NAME NUM
SENDMSG 6 读取属性：<$NAME> 数值：<$NUM>

高阶定制案例（多行数循环读取）

基于基础脚本拓展循环读取功能，批量提取文本多行键值对数据，适配批量数据配置场景。

通过变量自增实现行号递增，循环读取文本内多条人物属性数据，无需重复编写脚本。

该定制写法可大幅简化批量数据读取脚本，适配版本自定义属性、礼包数据调试场景。

[@批量读取数据]
#IF
#ACT
MOV S0 0
#LOOP 10
GetListString ..\QuestDiary\人物数据.txt <$S0> PNAME PNUM
SENDMSG 6 第<$S0>行数据：<$PNAME>=<$PNUM>
INC S0 1
#ENDLOOP

零基础实操步骤

第一步：打开本地测试版本脚本目录，进入QuestDiary文件夹，新建自定义TXT文本文件。

第二步：在文本文件中输入所需内容，若使用双变量则严格遵循“名称:数值”的固定格式排版。

第三步：记录文本存放相对路径与读取行号，行号按从0开始的规则精准换算，避免计数错误。

第四步：打开版本调试工具，新建脚本触发端口，粘贴对应GetListString读取脚本代码。

第五步：保存脚本文件后重载脚本功能，触发脚本即可读取文本内容并完成变量赋值。

新手避坑指南

第一，严格注意行号计数规则，文本第一行对应行号0，新手极易直接按1开始计数导致读取空内容。

第二，双变量读取仅支持纯冒号分隔格式，文本存在空格、特殊符号会导致变量赋值失效、数据拆分错乱。

第三，文件路径必须精准无误，相对路径书写错误、文件存放目录不符，会直接出现读取失败问题。

第四，读取的文本文件需保持关闭状态，文件打开编辑时运行脚本，会出现数据读取不完整的问题。

报错修复模块

问题现象一：脚本触发无任何读取数据，变量为空

核心成因：行号填写错误、文件路径匹配失败，或目标行数无任何文本内容。

分步排查步骤：首先核对文本文件存放目录，确认脚本路径与实际路径完全一致；其次逐行核对文本行数，重新换算对应行号；最后检查目标行数是否存在空白内容。

落地修复方案：修正错误路径与行号，删除文本多余空行，确保目标行数存在有效内容后重载脚本即可。

问题现象二：双变量读取时，变量2无数据仅变量1生效

核心成因：文本内容格式不规范，存在空格、顿号等多余符号，未遵循“名称:数值”标准格式。

分步排查步骤：打开目标文本文件，检查对应行数内容，查看冒号前后是否存在空格、特殊字符。

落地修复方案：清理文本多余符号，统一改为无空格的键值对格式，重新保存文件并再次调试脚本。

FAQ问答

Q1：GetListString脚本行号为什么必须从0开始？

这是GOM引擎脚本固定计数规则，所有文本读取命令均以0为起始行号，属于引擎底层设定，无法修改，严格按规则填写即可正常读取。

Q2：不填写变量2会影响脚本正常运行吗？

不会影响。变量2为可选参数，仅用于拆分键值对数据，读取普通单行文本时省略变量2，脚本可正常读取整行内容。

Q3：提示读取失败，文件明明存在是什么原因？

大概率是相对路径书写错误，可核对QuestDiary目录名称、文件后缀，确保路径无大小写错误、无多余字符，重新修正即可。

Q4：文本修改内容后，脚本读取数据不变怎么办？

修改文本内容后需保存文件，同时重载脚本功能，引擎会重新读取最新文本数据，未保存或未重载会读取缓存旧数据。

Q5：可以读取文本文件最后一行的内容吗？

可以，只需提前统计文本总行数，用总行数减1即为最后一行行号，代入脚本即可精准读取末尾内容。

Q6：变量名称可以自定义中文或特殊符号吗？

不可以，GOM引擎脚本变量仅支持字母、数字组合，中文、特殊符号变量会导致赋值失效、脚本运行报错。

全文总结

GetListString是GOM引擎中轻量化、高实用的文本读取脚本，核心优势是可精准提取本地文本指定行数内容，支持单双两种变量赋值模式。

该脚本操作简单、适配性强，适合零基础学习者用于本地版本数据读取、自定义参数配置、批量数据调试等学习场景，是脚本定制基础核心命令。

熟练掌握行号换算、路径填写、文本格式规范，即可彻底解决文本数据读取失效、拆分失败等常见实操问题。