传奇引擎GETVALIDSTRSUPER分割命令使用教程

admin4小时前2

在传奇版本制作、NPC脚本编写、装备批量发放等场景中，字符串分割是高频刚需功能。GETVALIDSTRSUPER作为传奇引擎专用的高级字符分割指令，能够精准拆分自定义文本内容，适配装备读取、属性赋值、道具随机发放等核心玩法，是定制专属传奇版本不可或缺的脚本指令。本文详细讲解该指令的语法规则、参数详解…

在传奇版本制作、NPC脚本编写、装备批量发放等场景中，字符串分割是高频刚需功能。GETVALIDSTRSUPER作为传奇引擎专用的高级字符分割指令，能够精准拆分自定义文本内容，适配装备读取、属性赋值、道具随机发放等核心玩法，是定制专属传奇版本不可或缺的脚本指令。本文详细讲解该指令的语法规则、参数详解及实战案例，帮助版本制作者快速落地应用。

一、GETVALIDSTRSUPER指令基础语法

该指令为传奇M2引擎专属字符分割函数，用于将拼接的长字符串按照指定符号拆分，存入自定义临时变量，支持批量调取分割后的内容，标准语法结构如下：

GETVALIDSTRSUPER 参数1 参数2 参数3 参数4(可空)

二、四大参数详细解析

GETVALIDSTRSUPER共包含四个参数，前三个为必填项，第四个为可选项，所有参数仅支持引擎指定临时变量格式，兼容性强。

2.1 参数1：分割内容

待进行拆分的原始字符串，内容格式为【分割内容|分割内容|分割内容|】，可直接填写固定文本，也可调用已赋值的临时变量，常用于读取外部文本文件提取的装备列表、属性列表等数据。

2.2 参数2：分割符号

用于拆分原始字符串的界定符，常用符号包含冒号、竖线、逗号等，需与原始内容中的拼接符号保持一致，否则会出现分割失效、变量读取错乱等问题。

2.3 参数3：存入变量

分割后数据的存储临时变量，引擎仅支持N$XX、S$XX两类变量后缀，变量编号范围支持0-9999，分割后的内容会按顺序自动存入变量1、变量2、变量3等子变量中。

2.4 参数4：分割数量存入变量（可空）

非必填参数，用于将本次分割成功的内容总数量存入指定临时变量，可用于后续脚本判断，例如判定分割装备数量是否达标、是否触发补发逻辑等。

三、传奇装备批量发放脚本实战案例

下面以传奇战士专属装备随机发放为例，结合外部文本数据、性别职业判断、装备穿戴逻辑，完整演示GETVALIDSTRSUPER指令的实际应用，脚本可直接复制用于GOM、GE引擎版本。

3.1 外部数据文件配置

在版本QuestDiary目录下新建【装备列表.txt】，写入战士套装拼接数据，使用冒号作为分割界定符，文件内容如下：

战神盔甲(男):裁决之杖:绿色项链:黑铁头盔:骑士手镯:骑士手镯:力量戒指:力量戒指

3.2 完整NPC功能脚本

在NPC脚本文件中写入以下代码，实现男性战士触发功能后，自动读取文本装备、分割数据、发放并自动穿戴对应部位装备：

// 战士专属套装领取触发标签 [@分割] #IF gender man // 判断角色性别为男性 checkjob warrior // 判断角色职业为战士 #ACT GetRandomText ..\QuestDiary\装备列表.txt <$STR(S$装备数据)> 0 // 读取外部装备文本存入变量 GETVALIDSTRSUPER <$STR(S$装备数据)> : S$变量 // 按冒号分割装备数据，存入S$变量组 // 依次发放分割后的8件装备 GIVE <$STR(S$变量1)> 1 GIVE <$STR(S$变量2)> 1 GIVE <$STR(S$变量3)> 1 GIVE <$STR(S$变量4)> 1 GIVE <$STR(S$变量5)> 1 GIVE <$STR(S$变量6)> 1 GIVE <$STR(S$变量7)> 1 GIVE <$STR(S$变量8)> 1 // 按部位自动穿戴装备（编号对应引擎装备部位编码） TakeOn <$STR(S$变量1)> 0 TakeOn <$STR(S$变量2)> 1 TakeOn <$STR(S$变量3)> 3 TakeOn <$STR(S$变量4)> 4 TakeOn <$STR(S$变量5)> 5 TakeOn <$STR(S$变量6)> 6 TakeOn <$STR(S$变量7)> 7 TakeOn <$STR(S$变量8)> 8 BREAK