传奇脚本读写INI配置项教程 高速模式使用方法
在传奇脚本制作中，INI配置项读写是常用的基础功能，可实现数据永久保存、变量留存、参数配置等核心操作，广泛应用于玩家数据记录、假人配置、活动验证、微信校验等各类传奇游戏场景。本文详细讲解传奇脚本各类INI配置项操作命令、使用方法以及高速Fast模式实操案例，助力传奇脚本开发者快速上手配置文件操作。一…
在传奇脚本制作中，INI配置项读写是常用的基础功能，可实现数据永久保存、变量留存、参数配置等核心操作，广泛应用于玩家数据记录、假人配置、活动验证、微信校验等各类传奇游戏场景。本文详细讲解传奇脚本各类INI配置项操作命令、使用方法以及高速Fast模式实操案例，助力传奇脚本开发者快速上手配置文件操作。
一、INI配置项功能整体说明
传奇脚本支持完整的INI配置文件读写、删除行、删除区段等操作，同时兼容普通通区模式与Fast高速模式。高速模式主打实时读写，针对小型配置文件运行速度更快，适配微信验证、假人配置、临时数据记录等轻量化场景，是传奇精简脚本开发的常用功能。
核心配置命令分为写入配置、读取配置、删除配置行、删除配置区段四大类，多个命令相互配合，可完整实现传奇脚本中变量永久保存与修改的全套操作。
二、核心读写配置命令详解
1、WriteConfigFileItem 写配置项
功能说明：该命令是传奇脚本核心写入命令，主要用于将自定义数据保存到INI配置文件中，可替代临时变量，实现数据长期留存，重启游戏、重进服务器后数据不会丢失，常用于保存玩家自定义数据、游戏配置参数等内容。
2、ReadConfigFileItem 读配置项
功能说明：专属配置文件读取命令，可精准提取INI配置文件中指定区段、指定配置名的内容，并将读取的数据赋值给脚本变量，供游戏脚本调用执行。
组合用法：写配置项与读配置项命令配合使用，完美实现传奇脚本变量的保存与调取操作，是传奇自定义数据存储的核心组合功能。
三、配置文件删除命令详解
1、DelConfigFileItem 删除配置行
命令格式：DelConfigFileItem 文件名 区段 配置名
功能说明：精准删除INI配置文件中指定区段下的单条配置内容，仅删除对应单行数据，不影响文件内其他配置参数，适合局部数据修改清理。
2、DelConfigFileSection 删除配置区
命令格式：DelConfigFileSection 文件名 区段
功能说明：批量删除INI配置文件中的整个指定区段，区段内所有配置内容会全部清除，适合批量重置游戏配置、清空玩家历史数据等场景。
四、常规模式完整脚本示例
常规通区模式适配绝大多数传奇配置场景，稳定性强，适合大中型配置文件读写操作，完整可直接套用的脚本代码如下：
[@main]
<写配置项> <请输入你要写入配置项的内容/@@InPutString3>\
<读配置项内容/@读配置项> <$STR(S$配置项内容)>\
<删除配置文件中的一行/@删除配置文件中的一行>\
<删除配置文件中的一个区段/@删除配置文件中的一个区段>\
[@InPutString3]
#IF
#ACT
;写配置项
WriteConfigFileItem ..\QuestDiary\KEY.txt <$USERNAME> 内容 <$STR(S3)>
SENDMSG 6 你已经把你输入的内容写到配置文件中KEY.txt
[@读配置项]
#IF
#ACT
;读配置项
ReadConfigFileItem ..\QuestDiary\KEY.txt <$USERNAME> 内容 <$STR(S$配置项内容)>
SENDMSG 6 你已经把配置文件KEY.txt中的内容获取出
GOTO @main
[@删除配置文件中的一行]
#IF
#ACT
; 删除配置文件中的一行：
DelConfigFileItem ..\QuestDiary\KEY.txt <$USERNAME> 内容
[@删除配置文件中的一个区段]
#IF
#ACT
; 删除配置文件中的一个区：
DelConfigFileSection ..\QuestDiary\KEY.txt <$USERNAME>
五、Fast高速模式使用教程及示例
2024年8月2日传奇脚本新增Fast高速模式，针对小型配置文件优化读写逻辑，支持实时读写，运行速度远超普通模式，特别适配微信验证、假人配置、临时参数记录等轻量化高频操作场景。
同时，WriteConfigFileItem、ReadConfigFileItem 两大核心命令支持绝对路径调用，使用绝对路径时需保证参数完整无误，避免配置读取失败。
Fast高速模式完整可运行脚本示例：
[@main]
<写配置项> <请输入你要写入配置项的内容/@@InPutString3>\
<读配置项内容/@读配置项> <$STR(S$配置项内容)>\
<删除配置文件中的一行/@删除配置文件中的一行>\
<删除配置文件中的一个区段/@删除配置文件中的一个区段>\
[@InPutString3]
#IF
#ACT
;写配置项
WriteConfigFileItem ..\QuestDiary\KEY.txt <$USERNAME> 内容 <$STR(S3)> FAST
SENDMSG 6 你已经把你输入的内容写到配置文件中KEY.txt
[@读配置项]
#IF
#ACT
;读配置项
ReadConfigFileItem ..\QuestDiary\KEY.txt <$USERNAME> 内容 <$STR(S$配置项内容)> FAST
SENDMSG 6 你已经把配置文件KEY.txt中的内容获取出
GOTO @main
[@删除配置文件中的一行]
#IF
#ACT
; 删除配置文件中的一行：
DelConfigFileItem ..\QuestDiary\KEY.txt <$USERNAME> 内容 FAST
[@删除配置文件中的一个区段]
#IF
#ACT
;删除配置文件中的一个区段
DelConfigFileSection ..\QuestDiary\KEY.txt <$USERNAME> FAST
六、使用注意事项
1、 高速Fast模式仅适配小型配置文件，大型游戏配置文件建议使用普通通区模式，保障脚本运行稳定；
2、 调用绝对路径读写配置时，必须填写完整路径参数，路径缺失或错误会导致配置读写、删除功能失效；
3、 删除配置区段为批量清除操作，操作前需确认数据无需保留，避免误删游戏核心配置数据。
