当前位置：首页 > M2 > 996引擎

传奇文本文件操作脚本大全人物列表读写删改实战教程

admin2026-07-17996引擎9

摘要：本文详细讲解传奇全套文本文件操作脚本、人物列表管理脚本，包含文件创建删除、读写取值、随机调取、内容检测、名单增删等全功能教程，附带大量可直接套用的实战脚本案例，适配传奇版本搭建、自定义玩法开发、数据管理等场景。…

[TOCM]

玩传奇版本搭建、私服定制、脚本修改的玩家都清楚，游戏内**数据存档、名单检测、道具统计、战力排行、账号权限管理**等核心功能，全部依赖文本文件脚本指令实现。传奇文本操作脚本是自定义游戏功能、优化版本玩法、实现自动化数据管理的核心基础，掌握各类读写删改、检测遍历脚本命令，能够快速搭建专属传奇玩法系统，解决版本数据留存、名单筛选、随机调取内容等常见问题。本文将全面详解传奇通用文本操作、人物数据操作全部脚本命令，附带可直接套用的实战案例，覆盖新手常用的文件创建、删除、读写、复制、随机取值、名单检测等全场景功能，适配各类传奇版本脚本开发需求。

## 一、传奇基础文本文件操作脚本（文件层级功能）

传奇基础文本文件操作主要针对QuestDiary目录下的自定义文本文件，支持文件新建、删除、行数统计、文件复制等基础操作，是搭建各类自定义数据系统的前置操作，常用于初始化游戏数据、清理冗余文件、备份游戏数据等场景，所有脚本均适配传奇通用脚本语法，可直接复制使用。

### 1.1 创建文本文件脚本

该脚本命令主要用于在游戏服务端指定目录中新建空白文本文件，适配版本初始化、新功能数据文件创建场景，避免因文件缺失导致脚本报错，是传奇自定义功能开发的基础指令。

**脚本格式**：CREATEFILE 文件名称

**实战可用案例**：

```legend
[@main]
#IF
#ACT
CreateFile ..QuestDiaryNewFile.txt
#SAY
系统提示：已在EnvirQuestDiary目录中成功创建数据文件！
```

**应用场景**：新手上线初始化专属数据文件、新功能上线自动生成存档文件、自定义排行榜数据文件初始化。

### 1.2 删除文本文件脚本

删除文件指令搭配文件检测功能使用，可精准清理服务端冗余文本文件，常用于版本更新清理旧数据、玩家重置数据、定期清理无效存档等场景，避免垃圾文件占用服务端资源。

**脚本格式**：DeleteFile 文件名称

**实战可用案例**：

```legend
[@main]
#if
FileExists ..QuestDiary数据.txt
;检测指定路径文本文件是否存在，避免无文件删除报错
#act
DeleteFile ..QuestDiary数据.txt 
#SAY
系统提示：旧数据文件已成功删除！
```

### 1.3 获取文本文件总行数脚本

该指令可快速统计指定文本文件的内容行数，常用于**统计存档数据总量、计算排行榜数据条数、检测文件内容是否为空**等场景，通过变量调取行数数据，可实现游戏内可视化数据展示。

**脚本格式**：GetTextLineCount 路径 保存变量

**实战可用案例**：

```legend
[@main]
#if
#act
GetTextLineCount ..QuestDiary装备回收.txt N$行数
Sendmsg 5 系统提示：装备回收记录文件共有【<$STR(N$行数)>】行存档内容
```

### 1.4 复制文件到指定目录脚本

文件复制指令主要用于游戏数据备份、模板文件复用、跨目录数据同步，可将指定目录的文本文件完整复制到新路径，保留原文件所有内容，适配传奇版本数据迁移、玩法模板复制等需求。

**脚本格式**：CopyFile 源文件路径 目标文件路径

**实战可用案例**：

```legend
[@复制文件]
#ACT
CopyFile ..QuestDiary战力排行战力数据.txt ..QuestDiary复制战力排行复制战力数据.txt 
#SAY
系统提示：战力数据文件备份复制完成！
```

## 二、传奇文本内容读写取值脚本（核心功能）

文本内容读写、随机取值、精准调取是传奇脚本开发的核心，绝大多数自定义玩法，比如**随机礼包领取、专属称号抽取、装备属性随机赋值、玩家数据存档读取**，都依赖此类指令。本节涵盖随机取文本、指定行写入、变量读取内容、字符串定位等高频功能，附带完整可落地脚本案例。

### 2.1 从文件中随机读取文本脚本

随机读取文本分为普通读取和缓存读取两种模式，是传奇随机玩法的核心指令，可实现随机抽取道具、随机刷新福利、随机匹配游戏内容等功能。缓存读取速度更快，适合高频触发的游戏功能。

**脚本格式**：GETRANDOMLINETEXT 文件路径 字符串变量 指定行（0或空为随机一行，大于0读取指定行）

**实战可用案例**：

```legend
[@Main]
#If 
#Act
GETRANDOMLINETEXT ..QuestDiary装备列表.txt S0
#Say
本次随机抽取装备：<$STR(S0)>
```

**功能区别**：GetCacheRandomLineText 写法一致，基于缓存读取，响应速度更快，但仅首次读取生效，后续文本修改不会自动更新数据，适合固定内容随机调取场景。

### 2.2 精准写入文本文件内容脚本

AddTextListEx指令支持自定义行数写入文本内容，可精准将玩家数据、游戏记录写入指定文件行，常用于**玩家昵称存档、充值记录留存、通关记录保存、战力数据更新**等场景，支持批量写入、指定行覆盖写入。

**脚本格式**：AddTextListEx 文件路径 写入字符串 行号（0-65535）

**实战可用案例**：

```legend
[@main] 
#IF
#ACT
AddTextListEx ..TestList.txt <$USERNAME> 0 1
#SAY
系统提示：你的角色信息已成功录入存档列表！
```

### 2.3 读取文本内容到变量脚本

该指令可读取文本文件指定行内容并赋值给游戏变量，支持单列、双列数据读取，适配**读取玩家存档数据、调取排行榜数值、获取账号权限参数**等场景，双列格式可匹配“名称:数值”的标准文本存档格式。

**脚本格式**：GetListString 文件路径 行号 变量1 变量2

**实战可用案例**：

```legend
[@main]
#IF
#ACT
GetListString ..QuestDiary测试.txt 5 A10 N10 
#SAY
读取数据成功：名称【<$STR(A10)>】数值【<$STR(N10)>】
```

### 2.4 字符串位置查询脚本

可精准检测指定字符串在文本列表中的行数位置，快速判断目标内容是否存在、定位数据存档位置，常用于**查重玩家数据、检索专属权限账号、筛选指定游戏记录**等场景。

**脚本格式**：GetStringPos 文件路径 目标字符串

**返回参数说明**：N0变量为返回值，9999999代表未找到目标字符串，其余数值为对应行数位置。

**实战可用案例**：

```legend
[@main]
#IF
#ACT
GetStringPos ..QuestDiary测试.txt 管理员
SendMsg 5 目标字符串在列表中的位置：<$STR(N0)> 
```

**功能区别**：GetCacheStringPos为缓存查询版本，检测速度更快，适合高频检索场景，仅单次读取生效。

### 2.5 多行随机读取精准取值脚本

GetRandomText指令支持无指定行随机取值、指定行数精准取值两种模式，适配更多游戏场景，既能实现随机福利、随机任务，也能固定调取指定行的固定游戏内容，兼容性极强。

**脚本格式**：GetRandomText 文件路径 变量 指定行(0-10000)

**随机取值实战案例**：

```legend
[@Main]
#IF
#ACT
GetRandomText ..QuestDiary测试.txt S10
SendMsg 5 随机获取内容：<$STR(S10)>
```

**指定行取值实战案例**：

```legend
[@Main]
#IF
#ACT
GetRandomText ..QuestDiary测试.txt S10 5
SendMsg 5 获取第5行固定内容：<$STR(S10)>
```

## 三、传奇文本内容清理与修改脚本

在传奇版本运营和脚本调试过程中，需要定期清理冗余数据、删除无效字符串、清空列表存档，此类修改类脚本可实现文本内容精细化管理，支持整表清空、单行删除、精准增删字符串等功能，适配数据重置、名单更新、内容纠错场景。

### 3.1 一键清空列表内容脚本

专为批量清空文本列表数据设计，可一键清空指定namelist文本所有内容，常用于**每日排行榜重置、限时活动名单清零、周期数据刷新**等场景，操作简单且执行效率高。

**脚本格式**：CLEARNAMELIST namelist.txt

**实战可用案例**：

```legend
[@Clearnamelist]
#IF
#ACT
CLEARNAMELIST namelist.txt
#SAY
系统提示：当前数据列表已全部清空！
```

### 3.2 文本指定行数删除脚本

支持精准删除文本文件指定行数内容，同时可选择是否保留空行，适配**单独删除某条玩家记录、剔除无效数据行、精准修改存档内容**等精细化操作场景。

**脚本格式**：DelText 文本路径 行数 删除模式（0=不保留空行 1=保留删除行为空行）

### 3.3 文本字符串增删通用脚本

兼容新老两种格式，支持单字符串、双字符串批量增删，是日常脚本开发中使用率最高的内容修改指令，可快速实现玩家信息录入、无效数据剔除、自定义内容更新。

**核心格式**：AddTextList 文件路径 字符串（新增）、DelTextList 文件路径 字符串（删除）

**新增字符串实战案例**：

```legend
[@Test老格式]
#IF
#ACT
AddTextList ..TestList.txt 您的名字

[@Test新格式]
#IF
#ACT
AddTextList ..TestList.txt 您的名字 您的性别
```

**删除字符串实战案例**：

```legend
[@Test老格式]
#IF
#ACT
DelTextList ..TestList.txt 您的名字

[@Test1新格式]
#IF
#ACT
DelTextList ..TestList.txt 您的名字 您的性别
```

### 3.4 文本单行多列读取脚本

针对单行多数据的复合文本内容设计，支持自定义分隔符拆分多列数据，完美适配**职业、属性、战力、等级**多维度共存的存档格式，可一次性读取多条关联数据。

**脚本格式**：GetListStringEx 文本路径 行号 写入变量 分隔符号

**实战可用案例**：

```legend
[@读文本多列]
#IF
#ACT
AddTextListEx ..QuestDiary测试.txt 战士*100*法师*200*道士*300 0
GetListStringEx ..QuestDiary测试.txt 0 S$读取列 *
SENDMSG 0 职业数据：<$STR(S$读取列0)> <$STR(S$读取列1)> <$STR(S$读取列2)>
```

## 四、传奇文本内容检测验证脚本

内容检测脚本是传奇权限验证、道具校验、名单筛选的核心，可精准判断字符串是否存在、内容是否包含匹配，广泛应用于**卡号密码验证、管理员权限检测、专属玩家名单校验、活动资格判定**等场景，区分大小写、模糊匹配双模式适配不同需求。

### 4.1 精准匹配文本检测脚本

分为不区分大小写、区分大小写两种检测模式，支持单参数、双参数校验，是传奇充值卡号验证、权限账号检测的主流用法，检测精准度高，适配严格匹配场景。

**不区分大小写实战案例**：

```legend
[@旧格式_不区分大小写]
#IF
CHECKTEXTLIST ..QuestDiary充值系统10元卡号.txt <$STR(S$2)>
#SAY
<$STR(S$2)>已匹配列表数据
#ELSESAY
<$STR(S$2)>未查询到对应数据
```

**区分大小写双参数实战案例**：

```legend
[@新格式_区分大小写]
#IF
CHECKTEXTLIST ..QuestDiary充值系统10元卡号.txt <$STR(S$2)> <$STR(S$3)>
#SAY
卡号密码验证正确
#ELSESAY
卡号密码验证错误
```

### 4.2 模糊包含检测脚本

支持模糊匹配检测，无需内容完全一致，只要文本行包含目标字符串即可判定匹配，适配**关键词检索、批量名单匹配、模糊权限识别**等场景，包含两种差异化检测指令。

**基础包含检测案例**：

```legend
[@CheckContainsTextList]
#IF
CheckContainsTextList ..QuestDiary充值系统10元卡号.txt <$STR(S2)>
#ACT
SENDMSG 6 列表中存在包含【<$STR(S2)>】的内容
#ELSEACT
SENDMSG 6 列表中无匹配内容
```

**反向包含检测案例**：

```legend
[@CheckContainsTextListEx]
#IF
CheckContainsTextListEx ..QuestDiary充值系统10元卡号.txt <$STR(S2)>
#ACT
SENDMSG 6 【<$STR(S2)>】包含列表中存档内容
#ELSEACT
SENDMSG 6 【<$STR(S2)>】无对应匹配内容
```

**指令区别解析**：CheckContainsTextList 检测列表是否包含目标字符；CheckContainsTextListEx 检测目标字符是否包含列表内容，可根据检索需求灵活选用。同时支持CheckCache缓存版本，提速高频检测场景。

## 五、传奇人物列表专属操作脚本

人物列表脚本专门用于**玩家昵称、账号ID、登录IP、行会名称**的名单管理，是传奇权限系统、黑名单系统、专属白名单、行会管理系统的核心脚本，支持检测、新增、删除全流程操作，所有指令适配传奇人物数据逻辑。

### 5.1 玩家名字名单检测脚本

快速检测当前玩家昵称是否存在于指定文本名单，适配白名单权限、黑名单封禁、专属福利限定等场景。

```legend
[@检测名字在文本]
#IF
CHECKNAMELIST ..QuestDiary测试.txt
#ACT
SendMsg 0 恭喜！你的角色名在权限名单内
#ELSEACT
SendMsg 0 提示：你的角色名无对应权限
```

### 5.2 账号ID增删检测脚本

针对玩家登录账号ID进行管理，支持检测账号是否备案、新增账号白名单、剔除无效账号，适配账号权限分级、专属账号福利系统。

```legend
;账号检测
#IF
CHECKACCOUNTLIST ..QUESTDIARY测试.TXT
#act
SENDMSG 0 账号已备案
#ELSEACT
SENDMSG 0 账号未备案

;新增账号到列表
#IF
#Act
ADDACCOUNTLIST ..QUESTDIARY测试.TXT

;删除账号列表数据
[@DelAccountList]
#IF
#Act
DELACCOUNTLIST AccountList.txt
```

### 5.3 角色名称批量管理脚本