从文件随机读取一行到变量是传奇脚本中最常用的文本操作之一。无论是随机公告、随机奖励、随机装备，还是合成系统的成败判定，底层都依赖这个操作。不同引擎的命令名称和参数格式存在差异，下面按引擎分类逐一说明。
核心变量体系
存储读取结果需要用到字符串变量。传奇脚本中常用的字符串变量分为两类：S0至S99为私人字符变量，下线不保存，小退归零。A0至A499为全局字符变量，所有玩家共享。绝大多数随机读取场景使用S系列变量即可，多个玩家各自独立读取时不会互相干扰。变量的调用格式统一为`<$STR(S编号)>`，例如读取结果存入S0后，在脚本中用`<$STR(S0)>`引用。
GOM引擎命令格式
GOM引擎使用GETRANDOMLINETEXT命令，格式为：GETRANDOMLINETEXT文件路径字符串变量。
命令的参数含义：文件路径为相对路径或绝对路径，相对路径以`..\QuestDiary\`开头，相对于Mir200\Envir目录；字符串变量填入S0至S99中的任意一个。
基础用法示例：
```
[@Main]
#If
#Act
GETRANDOMLINETEXT..\QuestDiary\装备列表.txt<$STR(S0)>
#Say
取回的文本是：<$STR(S0)>
```
这段脚本从装备列表.txt中随机读取一行，存入S0变量，然后在对话框显示读取结果。文件内容每行一条记录，例如：
```
倚天剑
屠龙刀
开天
镇天
玄天
```
引擎随机命中其中一行，每次执行结果可能不同。
GOM引擎的GETRANDOMLINETEXT还支持第三个参数指定行数。参数为0或空时随机读取一行，参数大于0时读取指定行。例如`GETRANDOMLINETEXT..\QuestDiary\装备列表.txt<$STR(S0)>3`读取第3行内容。
GetRandomLineText是GOM引擎中另一个等效命令，格式为GetRandomLineText文件路径保存变量，功能与GETRANDOMLINETEXT一致。GOM引擎同时兼容GetRandomText命令，用法与GETRANDOMLINETEXT相同。
GEE引擎命令格式
GEE引擎的命令与GOM基本一致，使用GETRANDOMLINETEXT或GetRandomText。GEE引擎在2.1.0.10以上版本支持该命令，格式为：GETRANDOMLINETEXT文件字符串变量。
GEE引擎的典型应用场景是假人系统。假人登录时从配置列表中随机抽取一个配置文件：
```
[@Login]
#IF
ISDUMMY
#ACT
GETRANDOMLINETEXT..\QuestDiary\智能陪练\假人配置文件列表.txt<$STR(S10)>
SETDUMMYCONFIGFILENAME<$STR(S10)>
LOADDUMMYCONFIGFILE
```
这段脚本检测到假人登录后，从假人配置文件列表.txt中随机抽取一个文件名存入S10，然后通过SETDUMMYCONFIGFILENAME设置假人的配置文件名并加载。
GEE引擎的GETRANDOMLINETEXT支持绝对路径参数。在命令末尾追加参数1表示使用绝对路径，留空或填0表示相对路径。例如`GETRANDOMLINETEXTE:\数据文件\装备列表.txt<$STR(S0)>1`。
GEE引擎的GetRandomText命令同样可用，格式为GetRandomText文件变量，示例为`GetRandomText.\QuestDiary\装备列表.txtS10`，之后用`<$STR(S10)>`引用读取结果。
HERO引擎命令格式
HERO引擎使用GetRandomText命令，格式为：GetRandomText文件路径变量(S0-S99)指定行(1-10000)。
不指定行数时随机读取一行。指定行数时读取该行内容。变量可使用S0至S99或A0至A499。
随机读取示例：
```
[@Main]
#IF
#ACT
GetRandomText.\QuestDiary\测试.txtS10
SendMsg5取出的字符串是:<$STR(S10)>
```
指定行读取示例：
```
[@Main]
#IF
#ACT
GetRandomText.\QuestDiary\测试.txtS105
SendMsg5取出的字符串是:<$STR(S10)>
```
第二个示例固定读取第5行内容。
HGE引擎命令格式
HGE引擎使用GetRandomName命令，格式为：GetRandomName文本文件路径字符串变量指定行是否绝对路径。
参数说明：指定行参数存在时读取指定行数，为0时使用随机行数模式。是否绝对路径参数中，0表示相对路径，1表示绝对路径。该命令不支持M变量，只支持个人S变量和临时S变量。
基础随机读取示例：
```
[@Main]
#If
#Act
GetRandomName..\QuestDiary\物品.txtS81
#Say
取回的文本是：<$S81>
```
这段脚本从物品.txt中随机读取一行存入S81变量，然后在对话框中显示。
概率型随机命令：READRANDOMSTR
BLUE引擎、188引擎等支持READRANDOMSTR概率型命令，格式为：READRANDOMSTR文件路径变量。
与普通随机读取的区别在于，文本文件中的每一行后面可以附加一个数字作为权重，数字越大命中该行的概率越小。文件格式示例：
```
字符111
文字288
```
上述文件中“字符1”的权重为11，“文字2”的权重为88，前者被命中的概率约为后者的8倍。脚本写法：
```
[@delskill]
#IF
#ACT
READRANDOMSTR.\QuestDiary\变量\颜色.txtS15
#SAY
你所获得的颜色是：$STR(S15)
```
对应的纯随机版本使用ReadRandomLine命令，格式相同，但文本文件中不带权重数字，每行被命中的概率完全相等。使用ReadRandomLine时，颜色.txt文件内容简化为：
```
字符1
文字2
```
合成系统中随机取行的完整应用
结合随机取行命令与条件判断，可实现随机概率合成系统。在`Mir200\Envir\QuestDiary\几率控制\`目录下创建两个文本文件。
合成几率.txt内容如下：
```
成功
失败
失败
失败
失败
失败
失败
失败
失败
失败
```
十条数据中一条“成功”九条“失败”，对应10%的成功概率。调整成功率只需改这个比例。
合成品.txt内容如下：
```
倚天剑
屠龙刀
开天
镇天
玄天
```
合成成功后从这五行中随机抽取一件产出。
脚本代码：
```
[@开始合成]
#IF
checkgamegold>4999
checkitem黑铁剑1
#ACT
GetRandomLineText..\QuestDiary\几率控制\合成几率.txt<$STR(N1)>
GetRandomLineText..\QuestDiary\几率控制\合成品.txt<$STR(S0)>
#IF
EQUAL<$STR(N1)>成功
#ACT
gamegold-5000
take黑铁剑1
give<$STR(S0)>1
sendmsg0恭喜玩家〖%s〗通过合成系统获得〖<$STR(S0)>〗！
#ELSEACT
gamegold-5000
take黑铁剑1
SENDMSG6很遗憾，合成失败了！
give黑铁矿5
goto@main
```
脚本先随机读取合成几率.txt的结果存入N1，同时随机读取合成品.txt的产出物品存入S0。然后判断N1的值是否为“成功”，是则扣除货币和材料，给予S0中记录的物品；否则扣除材料并给予保底奖励。
路径写法与注意事项
相对路径统一以`..\QuestDiary\`开头，相对于Mir200\Envir目录。写入`..\QuestDiary\装备列表.txt`时，引擎自动解析为`Mir200\Envir\QuestDiary\装备列表.txt`。绝对路径直接从盘符开始，例如`D:\MirServer\Mir200\Envir\QuestDiary\装备列表.txt`，部分引擎在绝对路径后需追加参数1。
文本文件需使用ANSI编码保存，UTF-8编码的中文内容在部分引擎中会显示为乱码。文件内每行只放一条完整记录，不要有空白行或多余空格，空白行被随机命中时变量内容为空。
S0至S99为私人字符变量，关闭对话框或小退后自动重置为默认值。如果在同一次对话中多次使用随机读取命令，每次都覆盖前一次的结果。若需要跨对话保留读取内容，需使用SAVETEXT命令写入文件持久化。
变量类型需与命令匹配。GetRandomText和GETRANDOMLINETEXT要求填入字符串变量（S或A系列），填入数字型变量如N1或M1时部分引擎可自动转换，但建议直接用S系列避免兼容问题。
GOM引擎在2023年后的版本中，GETRANDOMLINETEXT支持老模式参数，参数3等于0为随机抽取，等于1为指定行，参数4支持OLDMODE以兼容老版本的绝对路径写法。使用旧版引擎时需确认命令参数是否完整支持。
核心变量体系
存储读取结果需要用到字符串变量。传奇脚本中常用的字符串变量分为两类：S0至S99为私人字符变量，下线不保存，小退归零。A0至A499为全局字符变量，所有玩家共享。绝大多数随机读取场景使用S系列变量即可，多个玩家各自独立读取时不会互相干扰。变量的调用格式统一为`<$STR(S编号)>`，例如读取结果存入S0后，在脚本中用`<$STR(S0)>`引用。
GOM引擎命令格式
GOM引擎使用GETRANDOMLINETEXT命令，格式为：GETRANDOMLINETEXT文件路径字符串变量。
命令的参数含义：文件路径为相对路径或绝对路径，相对路径以`..\QuestDiary\`开头，相对于Mir200\Envir目录；字符串变量填入S0至S99中的任意一个。
基础用法示例：
```
[@Main]
#If
#Act
GETRANDOMLINETEXT..\QuestDiary\装备列表.txt<$STR(S0)>
#Say
取回的文本是：<$STR(S0)>
```
这段脚本从装备列表.txt中随机读取一行，存入S0变量，然后在对话框显示读取结果。文件内容每行一条记录，例如：
```
倚天剑
屠龙刀
开天
镇天
玄天
```
引擎随机命中其中一行，每次执行结果可能不同。
GOM引擎的GETRANDOMLINETEXT还支持第三个参数指定行数。参数为0或空时随机读取一行，参数大于0时读取指定行。例如`GETRANDOMLINETEXT..\QuestDiary\装备列表.txt<$STR(S0)>3`读取第3行内容。
GetRandomLineText是GOM引擎中另一个等效命令，格式为GetRandomLineText文件路径保存变量，功能与GETRANDOMLINETEXT一致。GOM引擎同时兼容GetRandomText命令，用法与GETRANDOMLINETEXT相同。
GEE引擎命令格式
GEE引擎的命令与GOM基本一致，使用GETRANDOMLINETEXT或GetRandomText。GEE引擎在2.1.0.10以上版本支持该命令，格式为：GETRANDOMLINETEXT文件字符串变量。
GEE引擎的典型应用场景是假人系统。假人登录时从配置列表中随机抽取一个配置文件：
```
[@Login]
#IF
ISDUMMY
#ACT
GETRANDOMLINETEXT..\QuestDiary\智能陪练\假人配置文件列表.txt<$STR(S10)>
SETDUMMYCONFIGFILENAME<$STR(S10)>
LOADDUMMYCONFIGFILE
```
这段脚本检测到假人登录后，从假人配置文件列表.txt中随机抽取一个文件名存入S10，然后通过SETDUMMYCONFIGFILENAME设置假人的配置文件名并加载。
GEE引擎的GETRANDOMLINETEXT支持绝对路径参数。在命令末尾追加参数1表示使用绝对路径，留空或填0表示相对路径。例如`GETRANDOMLINETEXTE:\数据文件\装备列表.txt<$STR(S0)>1`。
GEE引擎的GetRandomText命令同样可用，格式为GetRandomText文件变量，示例为`GetRandomText.\QuestDiary\装备列表.txtS10`，之后用`<$STR(S10)>`引用读取结果。
HERO引擎命令格式
HERO引擎使用GetRandomText命令，格式为：GetRandomText文件路径变量(S0-S99)指定行(1-10000)。
不指定行数时随机读取一行。指定行数时读取该行内容。变量可使用S0至S99或A0至A499。
随机读取示例：
```
[@Main]
#IF
#ACT
GetRandomText.\QuestDiary\测试.txtS10
SendMsg5取出的字符串是:<$STR(S10)>
```
指定行读取示例：
```
[@Main]
#IF
#ACT
GetRandomText.\QuestDiary\测试.txtS105
SendMsg5取出的字符串是:<$STR(S10)>
```
第二个示例固定读取第5行内容。
HGE引擎命令格式
HGE引擎使用GetRandomName命令，格式为：GetRandomName文本文件路径字符串变量指定行是否绝对路径。
参数说明：指定行参数存在时读取指定行数，为0时使用随机行数模式。是否绝对路径参数中，0表示相对路径，1表示绝对路径。该命令不支持M变量，只支持个人S变量和临时S变量。
基础随机读取示例：
```
[@Main]
#If
#Act
GetRandomName..\QuestDiary\物品.txtS81
#Say
取回的文本是：<$S81>
```
这段脚本从物品.txt中随机读取一行存入S81变量，然后在对话框中显示。
概率型随机命令：READRANDOMSTR
BLUE引擎、188引擎等支持READRANDOMSTR概率型命令，格式为：READRANDOMSTR文件路径变量。
与普通随机读取的区别在于，文本文件中的每一行后面可以附加一个数字作为权重，数字越大命中该行的概率越小。文件格式示例：
```
字符111
文字288
```
上述文件中“字符1”的权重为11，“文字2”的权重为88，前者被命中的概率约为后者的8倍。脚本写法：
```
[@delskill]
#IF
#ACT
READRANDOMSTR.\QuestDiary\变量\颜色.txtS15
#SAY
你所获得的颜色是：$STR(S15)
```
对应的纯随机版本使用ReadRandomLine命令，格式相同，但文本文件中不带权重数字，每行被命中的概率完全相等。使用ReadRandomLine时，颜色.txt文件内容简化为：
```
字符1
文字2
```
合成系统中随机取行的完整应用
结合随机取行命令与条件判断，可实现随机概率合成系统。在`Mir200\Envir\QuestDiary\几率控制\`目录下创建两个文本文件。
合成几率.txt内容如下：
```
成功
失败
失败
失败
失败
失败
失败
失败
失败
失败
```
十条数据中一条“成功”九条“失败”，对应10%的成功概率。调整成功率只需改这个比例。
合成品.txt内容如下：
```
倚天剑
屠龙刀
开天
镇天
玄天
```
合成成功后从这五行中随机抽取一件产出。
脚本代码：
```
[@开始合成]
#IF
checkgamegold>4999
checkitem黑铁剑1
#ACT
GetRandomLineText..\QuestDiary\几率控制\合成几率.txt<$STR(N1)>
GetRandomLineText..\QuestDiary\几率控制\合成品.txt<$STR(S0)>
#IF
EQUAL<$STR(N1)>成功
#ACT
gamegold-5000
take黑铁剑1
give<$STR(S0)>1
sendmsg0恭喜玩家〖%s〗通过合成系统获得〖<$STR(S0)>〗！
#ELSEACT
gamegold-5000
take黑铁剑1
SENDMSG6很遗憾，合成失败了！
give黑铁矿5
goto@main
```
脚本先随机读取合成几率.txt的结果存入N1，同时随机读取合成品.txt的产出物品存入S0。然后判断N1的值是否为“成功”，是则扣除货币和材料，给予S0中记录的物品；否则扣除材料并给予保底奖励。
路径写法与注意事项
相对路径统一以`..\QuestDiary\`开头，相对于Mir200\Envir目录。写入`..\QuestDiary\装备列表.txt`时，引擎自动解析为`Mir200\Envir\QuestDiary\装备列表.txt`。绝对路径直接从盘符开始，例如`D:\MirServer\Mir200\Envir\QuestDiary\装备列表.txt`，部分引擎在绝对路径后需追加参数1。
文本文件需使用ANSI编码保存，UTF-8编码的中文内容在部分引擎中会显示为乱码。文件内每行只放一条完整记录，不要有空白行或多余空格，空白行被随机命中时变量内容为空。
S0至S99为私人字符变量，关闭对话框或小退后自动重置为默认值。如果在同一次对话中多次使用随机读取命令，每次都覆盖前一次的结果。若需要跨对话保留读取内容，需使用SAVETEXT命令写入文件持久化。
变量类型需与命令匹配。GetRandomText和GETRANDOMLINETEXT要求填入字符串变量（S或A系列），填入数字型变量如N1或M1时部分引擎可自动转换，但建议直接用S系列避免兼容问题。
GOM引擎在2023年后的版本中，GETRANDOMLINETEXT支持老模式参数，参数3等于0为随机抽取，等于1为指定行，参数4支持OLDMODE以兼容老版本的绝对路径写法。使用旧版引擎时需确认命令参数是否完整支持。