传奇脚本截取字符串指令CopyText完整使用教程
一、CopyText指令核心功能介绍在传奇NPC脚本、功能脚本开发过程中，字符串截取是高频常用的基础操作，CopyText作为传奇引擎内置的专属截取字符串指令，兼容性强、调用简单，是传奇脚本制作中处理文本、数字、字符拆分的核心指令。该指令支持中文、英文、数字全类型字符解析，适配所有主流传奇版本引擎，…
一、CopyText指令核心功能介绍
在传奇NPC脚本、功能脚本开发过程中，字符串截取是高频常用的基础操作，CopyText作为传奇引擎内置的专属截取字符串指令，兼容性强、调用简单，是传奇脚本制作中处理文本、数字、字符拆分的核心指令。该指令支持中文、英文、数字全类型字符解析，适配所有主流传奇版本引擎，NPC排版、变量赋值、文本筛选场景中均可便捷使用。
二、CopyText指令语法参数详解
该指令采用固定参数调用格式，共设置4个必填参数，参数顺序不可调换，所有参数之间以空格分隔，适配传奇标准脚本编码规范，具体参数定义如下：
参数1：待处理字符串
原生需要进行截取操作的原始字符内容，支持混合录入，可直接填写中文、英文字母、阿拉伯数字，也可调用已定义的脚本变量。
参数2：待拷贝字符初始位置
字符截取的起始点位，传奇脚本中该位置为从1开始的顺位计数，而非0起始，录入正整数即可指定截取起点。
参数3：拷贝字符数量
从初始位置开始，需要提取的字符个数，根据实际脚本需求录入对应正整数，超出原始字符串长度时仅截取至末尾字符。
参数4：保存的变量
截取完成后字符数据的存储载体，传奇脚本中常用S开头字符串变量（S0、S1、S2等），用于后续脚本调用、NPC弹窗展示、数据判定。
三、指令通用使用注意事项
1、全域字符通用：CopyText指令无字符类型限制，中文汉字、大小写英文字母、0-9阿拉伯数字均可正常识别截取，无需额外转义编码；
2、位置计数规则：初始位置参数按自然顺位计算，首个字符位置为1，第二个字符位置为2，依次类推；
3、脚本格式规范：所有调用代码需嵌套#ACT执行区块内，注释内容以分号开头，单独成行，不影响指令运行；
4、变量复用规则：同一个变量可重复赋值，后执行的截取结果会覆盖变量原有存储内容。
四、实战脚本案例演示
以下为传奇脚本可直接运行的标准化案例，覆盖中文、英文、数字三种常用场景，代码可直接复制导入NPC脚本或功能脚本中使用。
4.1 中文字符串截取案例
#ACT
;定义变量S0，截取原始字符串第2位开始的2个中文字符
;执行后变量S0存储内容：木土
CopyText 金木土水火 2 2 S0
4.2 英文字符串截取案例
#ACT
;定义变量S0，截取原始字符串第2位开始的2个英文字符
;执行后变量S0存储内容：BC
CopyText ABCDE 2 2 S0
4.3 数字字符串截取案例
#ACT
;定义变量S0，截取原始字符串第2位开始的2个数字字符
;执行后变量S0存储内容：23
CopyText 12345 2 2 S0
五、NPC排版场景应用技巧
在传奇NPC界面排版开发中，CopyText指令实用性极高。开发者可通过该指令拆分长文本、提取关键字段，拆分装备名称、玩家昵称、属性数值等内容，实现NPC界面文字分行排版、属性分段展示，解决长文本溢出、排版错乱等问题。结合字符串变量联动，还可实现动态NPC文本更新，提升传奇服务端脚本的展示效果与交互体验。
