传奇脚本数组赋值教程 全套数组命令用法与实战代码示例

本文详解传奇脚本数组基础赋值、下标取值、元素修改方法，汇总996引擎全部内置数组命令，附带可直接复制的实战代码示例，标注命令使用限制与等价指令，帮助零基础开发者快速掌握传奇脚本数组开发技巧。…

在传奇996引擎脚本开发中，数组是批量管理游戏数据的核心工具。常用于玩家属性批量赋值、道具清单存储、行会数据筛选、掉落列表排序等场景。掌握传奇脚本数组赋值、下标取值、元素修改及全套内置数组命令，可大幅精简脚本代码，避免重复写变量判断，提升脚本运行效率与稳定性。本文为零基础开发者整理可直接复制的实战教程，所有代码适配主流传奇引擎。

一、传奇脚本数组基础赋值与取值

传奇脚本通过MOV指令定义列表型数组（标识L$），分为字符型、数值型两类，支持直接赋值、游戏内输出，是数组所有进阶操作的基础。

1.1 数组基础赋值语法

核心规则：使用MOV指令声明L$列表数组，中括号内录入多组数据，支持数字、字符两种数据类型；搭配SENDMSG指令可在游戏聊天框输出数组内容。

// 字符型数组赋值（存储文字、名称类数据）

MOV L$数组 [字符1,字符2,字符3,字符4]

// 数值型数组赋值（存储属性、数量类数据）

MOV L$数组1 [1,2,3,4]

// 游戏内全局输出数组内容（6为公屏频道）

SENDMSG 6 数组的值为:<$STR(L$数组)>，<$STR(L$数组1)>

1.2 数组下标取值规则

数组中括号内的数字为下标，传奇脚本数组下标固定从0开始排序，0对应第一个元素、1对应第二个元素。支持固定下标直接取值、变量动态传参取值两种方式。

// 定义基础数组

MOV L$数组3 [字符1,字符2,字符3,字符4]

// 固定下标取值调用元素

MOV S$数组第一个值 <$STR(L$数组3[0])>  // 输出：字符1

MOV S$数组第二个值 <$STR(L$数组3[1])>  // 输出：字符2

// 变量动态传入下标取值

MOV N$数组下标3 2

MOV S$数组第三个值 <$STR(L$数组3[<$STR(N$数组下标3)>])>  // 输出：字符3

1.3 数组元素修改实操

引擎支持下标定向替换、内容追加、内容删除、变量控制修改等多种方式，适配不同脚本编辑场景，所有示例可直接复制测试。

// 初始化测试数组

MOV L$数组4 [字符1,字符2,字符3,字符4]

// 1.下标直接替换元素

MOV L$数组4[0] 张三  // 结果：[张三,字符2,字符3,字符4]

// 2.指定下标元素后追加内容

INC L$数组4[1] 李四  // 结果：[张三,字符2李四,字符3,字符4]

// 3.删除下标元素后缀内容

DEC L$数组4[1] 李四  // 结果：[张三,字符2,字符3,字符4]

// 4.删除数组首个匹配内容元素

DEC L$数组4 张三  // 结果：[字符2,字符3,字符4]

// 5.变量控制下标替换元素

MOV N$数组下标1 1

MOV L$数组4[<$STR(N$数组下标1)>] 王五  // 结果：[字符2,王五,字符3,字符4]

二、传奇脚本全套内置数组功能命令

主流传奇引擎内置完整数组命令库，覆盖查询、判断、排序、增删、切片全功能，所有命令兼容996引擎，下文按功能分类整理，标注使用限制与等价指令。

2.1 数组查询类命令

用于获取数组元素位置、元素总数，常用于遍历数组、校验数据范围场景。

获取值位置：查询指定元素在数组中的下标位置 语法：GetListVarIndex 数组变量 值 接收变量

获取数组值数量：统计数组内有效元素总个数 语法：GetListVarCount 数组变量 接收变量

2.2 数组判断类命令

搭配IF条件语句使用，校验数组元素属性，实现脚本分支逻辑判断。

检查值是否存在数组：判断目标内容是否包含在指定数组中 语法：CheckVarInList 数组变量 值

检查全元素为数字：校验数组所有元素是否为纯数字格式 语法：CheckListAllDigit 数组变量

2.3 数组极值与排序命令

重要限制：此类命令仅支持纯数值数组，元素格式混杂会返回error报错。

获取数组最大值：提取数值数组中的最大数字值 语法：GetListMaxVar 数组变量 接收变量

获取数组最小值：提取数值数组中的最小数字值 语法：GetListMinVar 数组变量 接收变量

数组自定义排序：支持数值/文本、升序/降序排列 语法：SortList 待排序数组变量 接收变量 排序方式(0升序/1降序) 排序依据(0数值/1文本) 补充：数组元素需统一为纯数字或纯字符，格式混杂报错

2.4 数组结构调整命令

用于调整数组整体元素排布顺序，快速重构数组结构。

数组元素翻转：将数组元素首尾颠倒重排 语法：ReverseList 待翻转数组 接收变量

2.5 数组元素新增命令

向数组尾部或指定下标位置插入新元素，拓展数组数据。

尾部追加元素：在数组末尾新增数据 语法：AddToList 数组变量 值 等价指令：INC 数组变量 值

指定位置插入元素：在目标下标前插入数据，-1代表末尾 语法：InsertToList 数组变量 值 插入位置(-1为末尾)

2.6 数组元素替换命令

支持按下标、按内容两种方式替换数组元素，精准修改指定数据。

按下标替换元素：通过指定下标覆盖原有元素 语法：ReplaceListByIndex 数组变量 替换值 数组下标 等价指令：MOV 数组[下标] 值

按内容替换元素：匹配旧值替换为新值，支持大小写区分 语法：ReplaceListByContent 数组变量 旧值 新值 区分大小写(0不区分/1区分)

2.7 数组元素删除命令

精准删除指定下标或指定内容的元素，精简数组数据。

按下标删除元素：删除对应下标位置的元素 语法：RemoveListByIndex 数组变量 数组下标

按内容删除元素：删除匹配到的目标元素 语法：RemoveListByContent 数组变量 元素内容 区分大小写(0不区分/1区分) 补充：DEC 数组变量 元素内容 也可删除元素，仅删除首个匹配值

2.8 数组切片命令

截取数组指定区间元素，生成新的子数组，适用于批量筛选数据。

数组切片截取：按索引范围提取元素，支持步长跳过 语法：ExtractList 数组变量 保存变量 起点索引 终点索引 步长(默认1，可空置)

三、脚本开发实操总结

传奇脚本数组核心逻辑以MOV赋值、下标调用为基础，结合查询、判断、排序、增删命令，可实现绝大多数批量数据处理需求。开发中需注意：数值型数组禁止混入字符、排序命令需统一数据格式、下标从0开始计数，规避error报错。所有本文代码均可直接复制到996引擎脚本中调试使用，大幅降低开发难度。