传奇INI配置项读写脚本命令实操教程

本文详解996引擎全套INI配置项读写删除脚本命令，覆盖普通模式与缓存模式的完整实操用法。

专门解决新手不会保存游戏变量、读取配置数据、清理INI冗余内容、命令报错失效等实操问题。

所有脚本代码可直接复制套用，适配996引擎所有版本，全程贴合传奇版本搭建实操场景。

一、996引擎INI读写脚本核心命令详解

996引擎针对INI配置文件提供两套操作命令，分别为普通读写删除命令和缓存高速读写删除命令，两套命令功能一致、适用场景不同，核心用于游戏数据持久化保存、读取、清理，替代临时变量，实现数据永久留存。

1.1 普通模式全套标准命令语法

普通模式命令实时读写INI文件，引擎运行期间手动修改INI文件可生效，操作速度较慢，适合需要手动干预配置的场景。

// 普通写配置项命令
WriteConfigFileItem 路径 配置项区 配置项节 配置项值

// 普通读配置项命令
ReadConfigFileItem 路径 配置项区 配置项节 配置项值

// 普通删除配置项区命令
DelConfigFileSection 路径 配置项区

// 普通删除配置项节命令
DelConfigFileItem 路径 配置项区 配置项节

1.2 缓存高速模式全套标准命令语法

缓存模式命令将INI数据载入内存运行，操作速度远超普通模式，仅脚本操作生效，引擎关闭后才会保存到本地文件，手动修改INI文件无效。

// 缓存写配置项命令
WriteCacheConfigFileItem 路径 配置项区 配置项节 配置项值

// 缓存读配置项命令
ReadCacheConfigFileItem 路径 配置项区 配置项节 配置项值

// 缓存删除配置项区命令
DelCacheConfigFileSection 路径 配置项区

// 缓存删除配置项节命令
DelCacheConfigFileItem 路径 配置项区 配置项节

1.3 脚本参数详细解析

所有INI操作命令参数统一规范，四个参数各司其职，新手严格按照顺序填写即可，参数含义及用法如下表：

二、多场景可直接套用脚本案例

2.1 基础自定义内容读写案例（新手通用）

实现玩家自主输入内容，写入INI配置文件，支持读取展示保存内容，最基础的读写实操模板。

[@main]
<写配置项> <请输入你要写入配置项的内容/@@InPutString3>\
<读配置项内容/@读配置项> <$STR(S$配置项内容)>

[@InPutString3]
#IF
#ACT
WriteConfigFileItem ..\QuestDiary\KEY.ini <$USERNAME> 内容 S3
SENDMSG 6 你已经把你输入的内容写到配置文件中KEY.ini

[@读配置项]
#IF
#ACT
ReadConfigFileItem ..\QuestDiary\KEY.ini <$USERNAME> 内容 S$配置项内容
SENDMSG 6 你已经把配置文件KEY.ini中的内容获取出
GOTO @main

2.2 缓存模式战力数据保存案例（无手动干预场景）

角色战力数据由引擎自动计算，无手动修改需求，适配高速缓存读写命令，提升运行效率。

[@检测玩家战力]
#IF
#ACT
;缓存写入玩家当前战力数据
WriteCacheConfigFileItem ..\QuestDiary\Power.ini <$USERNAME> 当前战力 <$POWER>
;缓存读取已保存战力数据
ReadCacheConfigFileItem ..\QuestDiary\Power.ini <$USERNAME> 当前战力 S$玩家战力
SENDMSG 6 你的当前战力已缓存保存，读取战力：<$STR(S$玩家战力)>

2.3 配置项删除清理案例（数据重置场景）

支持删除单条配置项、整个配置分区，适用于数据重置、记录清理等实操场景。

[@重置玩家配置]
#IF
#ACT
;删除指定分区内的单条配置项
DelConfigFileItem ..\QuestDiary\KEY.ini <$USERNAME> 内容
;删除玩家整个配置分区
;DelConfigFileSection ..\QuestDiary\KEY.ini <$USERNAME>
SENDMSG 6 你的配置数据已成功重置清理！

三、分步式实操使用教程

3.1 脚本添加步骤

第一步：打开996引擎版本服务端，找到QuestDiary文件夹，可新建自定义INI文件（如KEY.ini、Power.ini），也可使用现有配置文件。

第二步：打开游戏脚本编辑器，新建或打开已有Quest脚本文件，将上述对应场景的脚本代码复制粘贴到脚本空白位置。

第三步：根据自身需求，修改脚本中的文件路径、配置分区、字段名称，无需修改核心命令格式。

3.2 参数修改技巧

1. 路径修改：新手优先使用相对路径 ..\QuestDiary\自定义文件名.ini，避免绝对路径出错，熟悉后可使用完整绝对路径。

2. 分区修改：推荐使用 <$USERNAME> 玩家用户名作为分区，实现每个玩家独立配置数据，互不干扰。

3. 变量修改：读取命令变量严格遵循996引擎规则，不添加$STR()，写入内容可自定义文本、游戏变量、数值等。

3.3 保存与生效触发

第一步：脚本修改完成后，点击脚本编辑器保存按钮，保存脚本文件。

第二步：在996引擎M2控制台，执行重新加载脚本命令，无需重启引擎。

第三步：进入游戏，触发对应脚本功能（点击按钮、输入命令等），即可完成INI数据读写、删除操作。

四、高频报错与不生效排错方案

4.1 脚本执行无反应、数据不保存

问题成因：文件路径填写错误、INI文件未创建、读取命令变量添加了$STR()、脚本未重新加载。

修复方案：核对文件路径大小写及拼写，手动新建对应INI空文件，删除读取变量的$STR()，重新加载引擎脚本。

4.2 缓存模式修改INI文件不生效

问题成因：缓存模式数据仅留存内存中，引擎运行期间手动修改本地INI文件，无法同步内存数据。

修复方案：运行期间仅通过脚本修改数据，需手动改配置时，切换为普通读写命令，或关闭引擎后再修改INI文件。

4.3 删除配置项无效、数据残留

问题成因：混淆删除分区和删除单条配置命令，分区名称、字段名称拼写不匹配。

修复方案：精准核对参数名称，删除单条数据用DelConfigFileItem，删除整个分区用DelConfigFileSection，严格对应INI文件内容。

五、新手实操避坑注意事项

1. 模式选择禁忌：需要手动修改、后台干预的配置场景（如提现记录、管理员配置），禁止使用缓存模式；纯引擎内部运算、无手动操作场景（战力统计、次数记录）优先用缓存模式，提升效率。

2. 996引擎专属禁忌：ReadConfigFileItem读取命令第四个参数变量，绝对不能添加<$STR()>包裹，这是996引擎最核心的报错点。

3. 路径适配要求：相对路径适配所有996引擎版本，绝对路径需根据服务端实际存放位置填写，路径含中文时需保证服务端编码统一。

4. 缓存模式核心限制：缓存数据仅在引擎运行期间留存内存，引擎异常关闭未保存时，临时缓存数据会丢失，重要数据不建议单独使用缓存模式。

5. 数据区分规范：不同功能的配置数据，建议新建独立INI文件或独立分区，避免多组数据覆盖冲突。

六、高频实操FAQ问答

Q1：缓存模式和普通模式到底该怎么选？

A1：需要手动修改INI文件、后台调整数据、核心记录数据选普通模式；纯游戏内部自动运算、无需人工干预、追求运行速度的功能，全部选缓存模式。

Q2：INI文件不存在，脚本会自动创建吗？

A2：996引擎中，使用读写命令执行后，若指定路径无对应INI文件，系统会自动生成空文件，无需手动提前创建，仅需保证路径文件夹存在。

Q3：为什么读取出来的内容是空值？

A3：大概率是变量添加了$STR()、参数名称拼写错误、分区/字段不匹配、脚本未加载成功，逐一核对参数格式和脚本状态即可修复。

Q4：重启引擎后缓存数据消失怎么办？

A4：缓存模式仅在引擎关闭时自动保存数据，正常重启引擎会留存数据，异常闪退会丢失，重要数据可搭配普通模式双重保存。

Q5：多个玩家使用同一INI文件会数据互通吗？

A5：不会，只要以<$USERNAME>玩家名作为配置分区，每个玩家独立分区存储数据，完全隔离，不会出现数据互通、覆盖问题。

七、全文总结

本文完整讲解了996引擎INI配置项读写删除脚本的全部实操内容，区分普通模式与缓存模式的功能差异、适用场景，详解核心参数、多场景案例、分步实操流程，同时汇总了高频报错问题与避坑要点。新手可直接复制脚本套用，根据功能需求选择对应操作模式，快速实现游戏数据永久保存、读取与清理，完美适配传奇版本搭建各类数据配置场景。