BLUE引擎说明书
BLUE引擎说明书
文本与文件

写入文本行

将指定内容追加写入文本列表，可选实时落盘，适用于名单记录、领奖记录和简单文本池维护。

命令用途

AddLineList 用于把一段文本追加写入指定文件。常见用途包括记录角色名、机器码、领奖名单、排行结果或其它简单文本列表。

它属于文本操作命令。当前引擎已经把这类操作优先放到内存中处理，因此这个命令既可以只改内存中的文本列表，也可以配合 HardDisk 立即写入物理文件。

命令名

AddLineList

调用格式

AddLineList <文件路径> <写入内容> [HardDisk]

参数说明

参数必填说明
文件路径是目标文本文件路径。
写入内容是需要追加到文件中的文本，可直接写固定字符串，也可以写变量标签，如 <$USERNAME>、<$HWID>、<$STR(A14)>。
HardDisk否实时写入物理硬盘。省略时先在内存中操作，引擎会按当前机制定时保存到本地文件。

返回或影响

  • 该命令会把一行内容追加到目标文本列表末尾。
  • 该命令不是检查型命令，不直接返回成功或失败分支结果。
  • 不带 HardDisk 时，修改先进入内存，不会立刻反映到硬盘文件中。
  • 带 HardDisk 时，会立即把结果写入物理文件，行为更接近旧版本文本命令。

示例

基础用法

#ACT
AddLineList ..\QuestDiary\rolelist.txt <$USERNAME>

这会把当前角色名追加到 rolelist.txt。这一写法先修改内存中的文本列表，适合频率较高、但不要求立即落盘的记录场景。

常见变体

#ACT
AddLineList ..\QuestDiary\领奖记录.txt <$HWID> HardDisk

这会把当前机器码立即写入 领奖记录.txt。适合领奖校验、外部程序联动或脚本执行后需要马上可见的文件记录。

注意事项

  • 当前文本操作命令的路径基准应按 NPC 当前脚本路径处理，不要继续使用旧写法 QuestDiary\... 或 .\QuestDiary\...。
  • 文本操作命令本身比较消耗资源，文本较大、执行频繁或循环写入时，容易引发明显卡顿。
  • 只有确实需要立即落盘的文件才建议加 HardDisk，否则会放大 I/O 压力。
  • AddLineList 只负责追加文本，不负责去重；如果业务要求"同一角色只能记录一次"，应先配合检查类命令控制流程。
相关资源

相关命令

打开宝石镶嵌界面

在 NPC 脚本中开启宝石镶嵌功能界面，进行打孔、镶嵌与拆卸操作。

添加使用日期列表

向指定文本文件写入使用日期列表，适用于领取冷却、周期资格和日期型名单维护。