传奇NPC脚本教程：获取文件行数命令使用方法
一、脚本功能介绍在传奇游戏NPC脚本开发过程中，经常需要读取本地文本文件的总行数，用于判断文件数据总量、校验配置文件内容、适配各类自定义玩法逻辑。本次讲解的获取文件行数命令，是传奇脚本中高频实用的基础指令，可快速读取指定路径txt文本文件的行数，并将数值存入自定义变量，适配装备回收、任务配置、道具统…
一、脚本功能介绍
在传奇游戏NPC脚本开发过程中，经常需要读取本地文本文件的总行数，用于判断文件数据总量、校验配置文件内容、适配各类自定义玩法逻辑。本次讲解的获取文件行数命令，是传奇脚本中高频实用的基础指令，可快速读取指定路径txt文本文件的行数，并将数值存入自定义变量，适配装备回收、任务配置、道具统计等各类游戏功能场景。
二、核心脚本命令格式
命令全称：GetTextLineCount
标准语法：GetTextLineCount 文件路径 保存变量
参数说明：
1. 文件路径：需要读取的游戏文本文件路径，支持传奇脚本相对路径写法，适配QuestDiary常规文件目录；
2. 保存变量：用于存储文件行数的自定义变量，通用N$自定义变量格式，可直接调用展示数值。
三、完整脚本示范代码
以下为可直接复制使用的传奇NPC完整脚本代码，以读取装备回收配置文件行数为例，代码格式规整、无语法错误，适配主流传奇引擎：
[@main]
#if
#act
GetTextLineCount ..\QuestDiary\装备回收.txt N$行数
Sendmsg 5 提示:装备回收.txt文件共有<$STR(N$行数)>行内容
四、脚本代码详解
1. 脚本触发入口：[@main] 为NPC脚本主触发端口，玩家对话NPC后即可执行后续命令，是传奇脚本通用触发格式。
2. 执行条件判断：#if 为条件判断指令，无额外限制时默认无条件执行，保障脚本稳定运行。
3. 核心执行指令：#act 后续绑定具体功能命令，通过GetTextLineCount读取QuestDiary目录下的装备回收.txt文件，将文件总行数存入变量N$行数。
4. 信息弹窗提示：Sendmsg 5 为游戏弹窗提示指令，可在游戏界面展示文件总行数信息，通过<$STR(变量)>格式调取存储的行数数据，实现数值可视化展示。
五、脚本使用注意事项
1. 路径规范：脚本文件路径需严格匹配游戏服务端目录结构，QuestDiary为传奇自定义脚本通用文件夹，路径书写错误会导致读取失败；
2. 文件格式：仅支持txt文本格式文件读取，不支持加密文件、文件夹及其他格式文件；
3. 变量规范：自定义变量需遵循传奇脚本变量规则，避免变量重名，防止数据读取错乱；
4. 适配场景：该命令可通用在装备回收、任务列表、充值记录、道具配置等所有需要统计文本数据行数的NPC脚本中。
