GOM引擎AddTextListEx脚本教程 - 文本文件指定行写入配置方法

AddTextListEx是GOM引擎专属的文本文件操作脚本命令，核心用于将指定字符串写入本地文本文件，同时支持自定义写入行数，适配本地版本技术调试、脚本功能测试与定制学习场景。

很多零基础脚本学习者仅掌握基础文本写入命令，无法精准控制内容写入行数，容易出现内容覆盖、排版错乱、数据堆积等问题，该脚本可精准定位写入位置，帮助新手稳定实现文本数据存储、信息记录等落地功能。

命令原理

AddTextListEx命令属于GOM引擎文件操作类核心脚本，核心运行原理为调用引擎本地文件读写接口。

命令可精准读取目标文本文件路径，将设定的字符串内容，强制写入指定行数位置，支持空行插入、内容替换、定点记录等操作。

区别于普通文本写入命令，该命令不会默认追加文件末尾，依靠行数参数实现精细化内容排版，适配各类定制化文本数据记录需求。

命令格式

该命令拥有固定标准语法格式，参数顺序不可调换、格式不可修改，新手可直接对照套用，零语法报错。

标准命令格式：AddTextListEx 路径 字符串 行(0-65535)

格式拆解说明：命令主体为固定关键字，后续依次跟随文件路径、写入内容、目标行数三个必填参数，参数之间以单个空格分隔，无多余符号。

实操示例：

#IF
#ACT
AddTextListEx ..\TestList.txt <$USERNAME> 0

上述示例可将当前角色用户名，写入版本根目录下TestList.txt文件的第0行位置，是新手入门最基础的实操写法。

参数详解

AddTextListEx命令共包含三个核心必填参数，所有参数各司其职，无冗余设置，具体参数细节如下表所示：

拓展案例

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

实现角色等级达标后，自动将角色名+等级写入文本文件首行，用于新手等级统计记录。

#IF
CHECKLEVEL >= 50
#ACT
AddTextListEx ..\LevelLog.txt 角色名：<$USERNAME>，当前等级：<$LEVEL> 0

该案例逻辑简单，仅需修改等级数值即可适配不同需求，适合新手熟悉参数搭配与命令触发逻辑。

中级优化案例（功能升级调试）

实现多行定点写入，分别将角色名称、金币数量、登录时间写入文件不同行数，实现数据分类排版记录。

#IF
#ACT
AddTextListEx ..\UserInfo.txt 玩家账号：<$ACCOUNT> 0
AddTextListEx ..\UserInfo.txt 角色金币：<$GOLD> 1
AddTextListEx ..\UserInfo.txt 登录时间：<$DATETIME> 2

此案例解决了单一行数数据杂乱的问题，通过固定行数分区，让文本文件数据规整清晰，方便后期查看调试。

高阶定制案例（自定义玩法修改）

增加重复数据过滤逻辑，仅当文本文件无对应角色信息时，才执行写入操作，避免数据重复堆积。

#IF
NOTEXISTTEXT ..\UserLog.txt <$USERNAME>
#ACT
AddTextListEx ..\UserLog.txt 已登录玩家：<$USERNAME>【<$DATETIME>】 5

该案例结合文件文本检测命令，实现智能化写入，适配签到记录、首次登录统计等定制化脚本玩法。

实操步骤

本次实操基于GOM引擎本地测试版本，全程零跳过、零省略，新手照搬即可落地生效。

第一步，打开本地版本脚本文件夹，路径为「版本根目录\Mir200\Envir\Market_Def」，新建或打开已有功能脚本文本。

第二步，将基础实操代码粘贴至脚本对应触发段落，按需修改文件路径、写入字符串、目标行数参数。

第三步，保存脚本文件后，打开版本管理面板，执行脚本重载操作，刷新本地服务端脚本配置。

第四步，进入本地测试版本，触发对应脚本功能，打开目标文本文件，即可查看已成功写入的对应内容。

避坑指南

第一，行数参数严禁超出0-65535区间，输入负数或超大数值，会直接导致脚本失效、命令不执行。

第二，相对路径书写必须规范，遗漏..\符号、拼写错误文件名，会出现文件找不到、内容写入失败的问题。

第三，同文件同一行数重复写入，会直接覆盖原有内容，多行记录需逐行递增数值，避免数据丢失。

第四，脚本重载不及时会导致修改不生效，每次修改脚本参数后，必须手动重载脚本配置，适配GOM引擎运行机制。

报错修复

问题现象

脚本触发无报错，但目标文本文件无任何新增内容，命令完全不生效。

核心成因

大概率是文件路径拼写错误、目标文件夹无读写权限、参数格式错乱，或是脚本未成功重载导致配置未更新。

分步排查步骤

首先核对文件路径拼写，确认相对路径符号、文件名完全一致，区分大小写与符号格式。

其次检查版本文件夹权限，确保本地服务程序拥有文件读写权限，未被系统拦截限制。

最后重新重载脚本，重启本地版本测试，排除脚本缓存导致的功能失效问题。

完整落地修复方案

统一修正路径格式，使用标准相对路径，清空错误参数，重新保存脚本并重载，即可解决90%以上的写入失效问题。

FAQ问答

Q1：行数参数设置为0和设置为1有什么区别？

参数0代表写入文件第一行置顶位置，参数1代表第二行位置，数值逐次加1对应行数依次下移，可按需分区写入数据。

Q2：写入的中文内容出现乱码怎么解决？

将脚本文件与目标文本文件统一转为ANSI编码格式，适配GOM引擎编码规则，即可彻底解决中文乱码问题。

Q3：相对路径和绝对路径该如何选择？

零基础学习优先用相对路径，兼容性更强、不易出错；固定电脑本地调试可使用绝对路径，精准锁定文件位置。

Q4：如何实现内容逐行追加不覆盖原有数据？

只需每次新增内容时递增行数参数，不同内容对应不同行数，即可实现多行共存，避免覆盖原有文本数据。

Q5：脚本触发成功但文件自动消失是什么原因？

大概率是路径拼写错误导致文件生成在陌生目录，核对路径后重新执行命令，即可正常生成并写入内容。

Q6：最大支持65535行是否够用常规脚本调试？

完全够用，常规本地数据记录、信息统计调试，上千行数据完全满足需求，上限足够适配所有基础定制场景。

全文总结

AddTextListEx是GOM引擎实用的文本文件定点写入脚本，核心优势是支持精准行数控制，解决了普通写入命令排版混乱、数据覆盖的痛点。

该脚本适配本地版本学习调试、数据记录、玩法定制等场景，零基础学习者掌握参数搭配与实操步骤，可快速落地各类文本数据存储功能，是GOM引擎脚本入门的核心实用命令。