GOM引擎AddTextList DelTextList脚本教程 - 文件字符串增删配置与格式调试

AddTextList、DelTextList是GOM引擎专属的文件文本操作脚本命令，核心用于本地版本中对指定TXT文件完成字符串新增与删除操作，适配脚本定制学习、本地功能测试场景。

很多零基础学习者实操时，常遇到格式混用失效、字符串增删不生效、新旧格式不会区分的问题，该脚本可精准解决本地文本文件自定义内容编辑需求，帮助新手快速落地文本读写调试操作。

命令原理

AddTextList和DelTextList是GOM引擎轻量化文本操作核心命令，无需复杂插件辅助。

两个命令仅针对本地TXT格式文件生效，可精准识别自定义字符串内容，完成对应增删动作。

支持新旧两种语法格式，单字符串、多字符串操作均可兼容，适配不同版本调试需求。

整体运行逻辑为脚本触发后，定位指定文件路径，匹配目标字符串并执行新增或删除指令。

命令格式

本模块为脚本标准通用格式，严格区分新旧版本语法，新手可直接对照套用，无适配门槛。

标准新增命令老格式：AddTextList 文件位置 单条字符串

标准新增命令新格式：AddTextList 文件位置 字符串1 字符串2（多字符串同步新增）

标准删除命令老格式：DelTextList 文件位置 单条字符串

标准删除命令新格式：DelTextList 文件位置 字符串1 字符串2（多字符串同步删除）

参数详解

拓展案例

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

仅使用老格式完成单字符串的新增与删除，适合新手熟悉命令基础逻辑，零难度上手。

新增案例：触发脚本后，在TestList.txt文件中添加“游戏测试”文本内容。

删除案例：触发脚本后，精准清除TestList.txt文件内的“游戏测试”字符串。

全程仅需基础脚本结构，无需额外参数设置，适配新手入门调试。

中级优化案例（多字符串批量操作）

采用新格式语法，实现双字符串同步增删，提升脚本调试效率，适配批量文本操作需求。

批量新增：一次性在目标文件添加“角色等级”“角色职业”两组自定义文本。

批量删除：同步清除文件内“角色等级”“角色职业”冗余字符串内容。

相比老格式单条操作，新格式可减少脚本行数，简化版本调试流程。

高阶定制案例（自定义场景适配）

结合自定义脚本触发条件，实现条件式文本增删，适配个性化版本定制学习场景。

可设置玩家指定操作触发命令，自动记录玩家自定义信息至本地TXT文件。

支持冗余信息自动清理，搭配变量参数可实现动态字符串增删，拓展脚本实用性。

同时适配GOM引擎全系列版本，无版本兼容限制，可长期用于脚本功能研发学习。

零基础实操步骤

第一步，在本地版本根目录新建TestList.txt空白文本文件，作为脚本操作的目标文件。

第二步，打开版本管理面板，进入自定义脚本编辑界面，新建独立脚本触发段。

第三步，根据调试需求，粘贴对应新旧格式的AddTextList、DelTextList脚本代码。

第四步，核对文件路径与字符串内容无误后，保存脚本文件，重载本地版本脚本数据。

第五步，触发对应脚本功能，打开TestList.txt文件，即可查看字符串增删生效效果。

新手避坑指南

第一，严格区分文件路径格式，必须使用..\相对路径，绝对路径易导致脚本定位失效。

第二，新旧格式不可混合编写，单条脚本段内仅使用一种格式，避免命令冲突报错。

第三，字符串内容禁止包含特殊违禁符号，仅使用常规中文、数字、文字符号。

第四，修改脚本后必须重载版本数据，否则修改内容无法实时生效，属于高频误操作。

第五，目标TXT文件需保证读写权限正常，本地文件锁定会导致增删功能失效。

报错修复模块

问题现象

脚本正常触发无报错日志，但目标TXT文件无任何字符串新增、删除效果，功能完全失效。

核心成因

大概率为文件路径填写错误、新旧格式混用，或是目标文件权限异常导致脚本无法读写。

分步排查步骤

首先排查文件路径，核对是否为标准相对路径，无拼写错误、无多余字符。

其次检查脚本格式，确认单段脚本仅使用老格式或新格式，无混合混用情况。

最后查看本地文件属性，确认文件未被锁定、只读权限关闭，可正常编辑修改。

完整落地修复方案

修正文件路径为标准..\文件名.txt格式，统一单脚本段语法格式。

右键目标TXT文件，取消只读属性，保存后重新重载版本脚本，再次触发功能即可恢复正常。

FAQ问答

Q1：AddTextList新旧格式可以通用吗？

可以通用，GOM引擎全版本兼容两种格式，仅需保证单段脚本不混用格式即可。

Q2：脚本触发成功但文本无变化是什么原因？

主要为路径拼写错误、文件只读锁定、格式混用三种原因，按报错排查步骤即可修复。

Q3：DelTextList可以一次性删除多个字符串吗？

支持，使用新格式语法，多个字符串用空格分隔，即可批量删除多条文本内容。

Q4：是否支持自定义命名的TXT文件操作？

完全支持，只需修改脚本内对应的文件路径与文件名，即可适配任意本地TXT文件。

Q5：修改脚本后需要重启引擎吗？

无需重启引擎，仅需重载版本脚本数据即可实时生效，节省调试时间。

Q6：字符串内容可以使用特殊符号吗？

不建议使用特殊冷门符号，仅常规文字、数字、标点可正常识别，避免功能失效。

全文总结

本文详细讲解了AddTextList、DelTextList两大GOM引擎脚本命令的完整实操内容。

涵盖命令原理、新旧格式、参数解析、三阶案例、实操步骤及报错修复等核心内容。

该脚本核心用于本地版本TXT文件字符串增删调试，适配零基础学习者技术研究。

整体兼容性强、操作简单，是GOM引擎文本自定义功能开发的基础核心脚本。