传奇自定义属性组脚本指令详解 套装属性增减与清除调用教程
本文详解传奇服务端三大自定义属性组核心脚本指令,涵盖ADDATTLIST、GETATTLIST、DELATTLIST语法参数,区分套装属性计算与固定值加成逻辑,附带可直接套用的实战脚本案例,规避版本开发常见报错问题,适配传奇套装、buff属性配置场景。…
一、核心指令概述
传奇服务端自定义属性组脚本,是调控人物套装属性、固定属性加成的核心功能,主要包含属性添加、数值获取、属性清除三大核心指令。相较于传统人物属性修改指令,该脚本支持批量绑定多类属性、区分套装结算逻辑,广泛应用于传奇版本套装赋能、装备专属属性、buff临时加成等场景,是版本开发中高频使用的基础脚本模块。
二、三大核心指令标准语法与参数说明
2.1 ADDATTLIST 属性添加指令
该指令用于给指定自定义属性组新增属性词条,支持区分套装属性计算逻辑与固定值加成,是配置装备套装效果的核心指令。
标准语法格式:ADDATTLIST 参数1 参数2 参数3 参数4
参数明细说明:
参数1:自定义属性组名称,自定义命名,用于区分不同套装、buff、装备专属属性组
参数2:操作符,仅支持+、-、=三种,分别对应属性增加、属性减少、属性赋值
参数3:属性字符串,固定格式为属性ID#子类型#数值,多属性用竖线分隔,示例:3#1#100|3#2#100|3#3#10|3#4#10
参数4:属性计算模式,0或为空=计算套装属性增量,支持百分比属性加成;1=增加固定值,不计算套装联动属性,百分比增幅属性无效
2.2 GETATTLIST 数值获取指令
该指令用于读取已创建的自定义属性组总数值,将数据存入脚本变量,可用于属性判定、数值弹窗展示、条件触发校验等场景。
标准语法格式:GETATTLIST 参数1 参数2
参数明细说明:
参数1:自定义属性组名称,需与ADDATTLIST创建的属性组名称完全一致
参数2:存储变量,传奇脚本通用变量(S0-S99、P0-P99等),用于存放读取后的属性数值
2.3 DELATTLIST 属性清除指令
该指令用于销毁指定或全部自定义属性组,清空对应属性加成,常用于装备脱下、buff过期、套装失效等场景。
标准语法格式:DELATTLIST 参数1
参数明细说明:
参数1:属性组定位参数,留空时清除服务端所有自定义属性组;填写指定名称时,仅清除对应单个属性组
三、实战可直接套用脚本案例
3.1 套装属性加成计算案例
适用于成套装备穿戴后,触发联动属性结算,支持百分比属性加成,为传奇版本最常用配置方案。
[@计算套装属性加成]
#IF
#ACT
ADDATTLIST 战神套装 + 3#1#100|3#2#100|3#3#10|3#4#10
3.2 固定值属性加成案例
适用于临时buff、单件装备固定加成,关闭套装联动计算,规避百分比属性异常增幅问题。
[@不计算套装属性]
#IF
#ACT
;参数4赋值1,禁用百分比属性增幅,仅生效固定数值
ADDATTLIST 狂暴buff + 3#1#100|3#2#100|3#3#10|3#4#10 1
3.3 属性组清除案例
适用于玩家脱下套装、buff时效结束、重置人物属性场景,精准清理指定属性组。
[@清除属性组]
#IF
#ACT
DELATTLIST 战神套装
3.4 属性数值获取案例
读取目标属性组数值存入全局变量,可后续用于属性对比、弹窗显示、触发隐藏剧情条件。
[@获取属性组数值]
#IF
#ACT
GETATTLIST 战神套装 S0
四、版本开发关键注意事项
第一,属性字符串必须严格遵循「ID#子类型#数值」格式,符号仅支持英文竖线分隔,中文符号会导致脚本加载失败;
第二,固定值模式下所有百分比属性词条直接失效,配置暴击、攻速等百分比属性时,参数4禁止赋值1;
第三,属性组名称区分大小写,获取、清除指令调用时,需与创建时名称完全匹配;
第四,全局清除指令慎用,会清空全服所有玩家自定义属性,仅推荐角色重置场景使用。


