传奇脚本CSV自定义常量使用教程 LOADCONLIST命令参数详解

在传奇脚本制作中，CSV自定义常量功能是拓展脚本数据、实现怪物、装备、自定义数据批量调用的核心功能，能够极大简化脚本编写流程，提升脚本通用性与规范性。该功能配套的CSV表格模板、实操参考实例，可通过下载压缩包获取查看完整素材。

一、核心调用命令：LOADCONLIST
LOADCONLIST是实现CSV自定义常量加载、读取的专属脚本命令，通过配置对应参数，可精准读取CSV表格中的行列数据，实现游戏怪物、装备、自定义工作表数据的快速调用。

命令参数详解
该命令包含三项核心参数，分别对应文件路径、表头列位、标签行位，支持默认参数配置，实操使用更加灵活。
参数1：文件路径
用于填写CSV表格文件的存放路径，支持相对路径调用，是脚本定位目标数据文件的核心参数。
参数2：表头所在列(A、B、C……)
自定义设置表格表头对应的列数，若留空不填写，默认默认读取A列作为索引列。
参数3：标签所在行(1、2、3……)
自定义设置表格标签名称对应的行数，若留空不填写，默认默认读取第1行作为索引行。

参数实操示例说明
以脚本配套的 Mon.csv 怪物数据表为例，脚本默认定义A列关键字作为行索引，第1行关键字作为列索引，精准定位表格内各项数据。
脚本调用格式：<$CL_Mon(白野猪.变量攻击2)>
该语句含义：读取 Mon.csv 表格中，白野猪所在行(第3行)、变量攻击2所在列(D列)对应的单元格数据内容。

重要使用注意事项
注意1：常量刷新规则
LOADCONLIST命令支持多次调用，二次及以上调用会自动刷新所有已加载的常量内容。为保证数据稳定性，建议将固定不变的常量内容，在QM启动时仅调用一次，避免数据频繁刷新出错。
注意2：文件命名规则(重中之重)
所有CSV数据文件名称绝对不能重复，即使不填写完整路径的同名文件，也禁止重复命名，否则会出现数据读取错乱、加载失败等问题。

二、完整实操脚本代码示例
以下为可直接复制使用的完整脚本代码，包含怪物常量、装备常量、自定义工作表格常量的加载与显示功能，适配常规传奇脚本引擎。

[@main]
#say
扩展常量\
<载入常量文件/@载入常量文件>    <显示怪物常量/@显示怪物常量>    <显示装备常量/@显示装备常量>\
扩展常量1\
<载入常量文件/@载入常量文件1>    <显示工作常量/@显示工作常量1>\
扩展常量2\
<载入常量文件/@载入常量文件2>    <显示工作常量/@显示工作常量2>\
扩展常量3\
<载入常量文件/@载入常量文件3>    <显示工作常量/@显示工作常量3>\

[@载入常量文件3]
#act
LOADCONLIST .\工作3.csv D 3
sendmsg 7 载入工作表3
break

[@显示工作常量3]
<返回/@main>\
<显示工作常量3>\
<$CL_工作3(1.3)>.序号=<$CL_工作3(1.4)>\
<$CL_工作3(1.3)>.班级=<$CL_工作3(1.1)>\
<$CL_工作3(1.3)>.宿舍=<$CL_工作3(1.2)>\

[@载入常量文件2]
#act
LOADCONLIST .\工作2.csv D 2
sendmsg 7 载入工作表2
break

[@显示工作常量2]
<返回/@main>\
<显示工作常量2>\
张爽.序号=<$CL_工作2(张爽.标签1)>\
张爽.班级=<$CL_工作2(张爽.标签2)>\
张爽.宿舍=<$CL_工作2(张爽.标签3)>\

[@载入常量文件1]
#act
LOADCONLIST .\工作1.csv D 1
sendmsg 7 载入工作表1
break

[@显示工作常量1]
<返回/@main>\
<显示工作常量1>\
张爽.序号=<$CL_工作1(张爽.序号)>\
张爽.班级=<$CL_工作1(张爽.班级)>\
张爽.宿舍=<$CL_工作1(张爽.宿舍)>\

[@载入常量文件]
#act
LOADCONLIST .\Mon.csv A 1
sendmsg 7 载入怪物常量表
LOADCONLIST .\item.csv A 1
sendmsg 7 载入装备常量表
break

[@显示怪物常量]
<返回/@main>\
白野猪血量=<$CL_Mon(白野猪.变量血量)>\
白野猪攻击1=<$CL_Mon(白野猪.变量攻击1)>\
白野猪攻击2=<$CL_Mon(白野猪.变量攻击2)>\
白野猪攻击3=<$CL_Mon(白野猪.变量攻击3)>\

[@显示装备常量]
<返回/@main>\
屠龙血量=<$CL_Item(屠龙.装备血量)>\
屠龙攻击1=<$CL_Item(屠龙.装备攻击1)>\
屠龙攻击2=<$CL_Item(屠龙.装备攻击2)>\
屠龙攻击3=<$CL_Item(屠龙.装备攻击3)>\

三、脚本功能说明
1、脚本支持批量加载怪物数据表(Mon.csv)、装备数据表(item.csv)以及3组自定义工作数据表，一键完成常量初始化加载。
2、支持自定义表格行列索引，可根据CSV表格排版，自由修改命令参数适配不同数据表格式。
3、内置可视化显示功能，可单独调取怪物属性、装备属性、自定义工作表数据，方便脚本调试与功能落地。