传奇脚本TextSplit分割指令用法详解
在传奇游戏脚本编写过程中，字符串分割是高频实用的基础功能，能够高效拆分多组数据、批量赋值脚本变量，大幅简化传奇脚本的编写逻辑。其中TextSplit作为专属分割指令，适配绝大多数传奇版本脚本引擎，操作简单、兼容性强，是传奇脚本制作、功能修改的核心常用指令。下面为大家详细讲解该指令的完整参数、语法规则…
在传奇游戏脚本编写过程中，字符串分割是高频实用的基础功能，能够高效拆分多组数据、批量赋值脚本变量，大幅简化传奇脚本的编写逻辑。其中TextSplit作为专属分割指令，适配绝大多数传奇版本脚本引擎，操作简单、兼容性强，是传奇脚本制作、功能修改的核心常用指令。下面为大家详细讲解该指令的完整参数、语法规则及实战用法案例。
一、TextSplit指令基础概述
TextSplit是传奇脚本中专用的字符串分割指令，核心作用是通过指定分割符，将一段完整的源字符串拆分为多个独立变量，支持自定义变量递增、设置分割数量，完美适配传奇脚本批量传参、数据拆分、文本分类等各类场景，广泛应用于NPC对话、礼包发放、属性判定、道具批量处理等脚本功能中。
二、TextSplit指令完整参数说明
该指令共包含5项核心参数，参数顺序固定、各司其职，精准掌握参数用法可避免脚本报错，保障传奇脚本稳定运行，具体参数解析如下：
参数1：分割符——用于拆分字符串的专属符号，常用竖线、逗号、空格等自定义符号，需和源字符串内的分隔符号保持一致。
参数2：源字符串——需要被拆分的原始文本内容，可包含多组自定义数据，是指令处理的核心对象。
参数3：保存变量——变量起始标识，仅需指定第一个变量名，后续变量会自动递增生成，无需手动逐一命名。
参数4：递增数量——可选参数，用于自定义生成变量的总数量，填写0时默认跟随源字符串分割结果数量生成变量。
参数5：返回分割数量——可选参数，自定义变量用于接收最终分割完成的字符串总数量，方便脚本后续判定调用。
三、TextSplit指令实战案例详解
结合传奇脚本常用场景，整理三组经典实战案例，覆盖基础分割、自定义递增数量、返回分割总数三种核心用法，所有案例均可直接复制到传奇脚本中测试使用。
案例一：基础字符串分割用法
该案例为最基础的分割操作，无需自定义递增数量，系统自动根据源字符串分割结果生成对应变量，适配常规少量数据拆分场景。
[@main]
#ACT
TextSplit | aaa|bbb|ccc|ddddd|eeeeee s1
SENDMSG 6 <$STR(s1)>,<$STR(s2)>,<$STR(s3)>,<$STR(s4)>,<$STR(s5)>
案例解析：以竖线为分割符，拆分多组字符串，自动生成s1至s5五个变量，通过SENDMSG指令在游戏内输出所有分割结果，变量数量与分割后的字符串组数完全一致。
案例二：自定义变量递增数量用法
适用于需要固定变量数量的传奇脚本场景，可自定义生成变量总数，当分割结果数量少于设定递增数量时，多余变量自动清空，不影响脚本正常运行。
#ACT
TextSplit | aaa|bbb|ccc|ddddd|eeeeee s1 6
SENDMSG 6 <$STR(s1)>,<$STR(s2)>,<$STR(s3)>,<$STR(s4)>,<$STR(s5)>,<$STR(s6)>
案例解析：本次设置递增数量为6，而源字符串仅可分割出5组内容，最终s1-s5正常赋值，s6自动清空为空值。该用法可固定脚本变量位数，避免变量缺失导致的脚本报错，适配标准化脚本编写需求。
案例三：返回分割总数用法
用于需要统计数据组数的脚本场景，可精准返回字符串分割后的总数量，方便后续脚本进行条件判断、数值统计等二次操作。
[@main]
#ACT
TextSplit | aaa|bbb|ccc|ddddd|eeeeee s1 0 N$数量
SENDMSG 6 <$STR(s1)>,<$STR(s2)>,<$STR(s3)>,<$STR(s4)>,<$STR(s5)>，分成了<$STR(N$数量)>个变量
案例解析：递增数量设置为0，代表默认跟随分割结果生成变量，同时通过N$数量变量接收分割总组数，运行脚本后可在游戏内直观查看分割后的变量总数，适配批量数据统计类脚本功能。
四、传奇脚本TextSplit指令使用注意事项
1、分割符必须与源字符串内部间隔符号完全一致，符号不匹配会导致分割失败、变量为空，是脚本最常见的报错原因。
2、变量递增遵循顺序规则，首个变量命名规范即可，后续变量无需手动定义，系统自动按数字顺序递增。
3、自定义递增数量大于实际分割组数时，多余变量自动清空，不会出现脚本报错，可放心用于固定变量场景。
4、该指令适配全版本传奇服务端，复古、微变、超变等各类传奇版本均可兼容使用，无版本限制。
