传奇装备部位万分比属性加成脚本教程

本文详解传奇引擎装备部位万分比属性加成脚本，解析SETEQUIPADDVALUE、GETEQUIPADDVALUE核心指令语法，提供可直接复制的衣服属性加成完整脚本案例，说明倍率存储、加成触发逻辑及配置注意事项，帮助开发者快速定制人物装备属性加权功能。…

一、脚本功能概述

本文详解传奇服务端中装备部位万分比属性加成脚本功能，该功能可针对指定装备位置设置属性倍率，穿戴对应装备后自动按配置倍数给人物叠加基础属性，倍率数据永久保存，脱穿装备实时生效，是定制高爆版本、专属装备属性的核心常用脚本。

整套功能分为三大核心模块：部位属性设置、部位属性获取、全局属性常量调用，无需复杂插件，原生引擎指令即可实现，适配传奇996引擎。

二、核心指令语法详解

2.1 部位属性设置指令

该指令用于自定义指定装备部位的属性加成倍率，数据写入服务端配置，修改后永久生效，核心语法结构如下：

SETEQUIPADDVALUE 部位(装备位置) 控制符(+-=) 倍数(万分比)

参数说明：

部位：传奇引擎内置装备位置ID，0代表衣服、1代表武器、2代表头盔等，按引擎默认编号填写；

控制符：+为叠加倍率、-为扣除倍率、=为重置固定倍率；

倍数：采用万分比计算，10000等于基础1倍，15000代表基础属性1.5倍。

2.2 部位属性获取指令

该指令用于读取已配置的装备部位倍率，将数值存入自定义变量，可用于弹窗提示、属性判断、条件触发等场景，语法结构如下：

GETEQUIPADDVALUE 部位(装备位置) 变量(倍数存入到变量)

参数说明：

部位：与设置指令一致，对应装备位置ID；

变量：引擎自定义字符串变量，如S1、S2，用于临时存储倍率数值，支持后续调用展示。

2.3 全局部位属性常量

引擎内置全局常量，可直接在弹窗、脚本文本中调用，快速读取指定部位当前倍率，无需额外执行获取指令，调用格式如下：

<$GETEQUIPADDVALUE(部位ID)>

该常量可直接嵌入发送消息、装备描述、NPC对话等场景，实时展示当前部位属性加成倍数。

三、完整可直接使用脚本案例

以下为衣服部位属性加成完整测试脚本，包含倍率设置、倍率获取、弹窗提示功能，复制到服务端QFunction-0.txt即可直接生效。

3.1 设置装备部位加成倍率脚本

[@设置部位属性]

#ACT

; 对衣服部位(ID=0)设置1.5倍万分比属性加成

SETEQUIPADDVALUE 0 + 15000

; 向玩家发送生效提示

sendmsg 6 衣服的基础属性1.5倍增加到人物上！

3.2 获取装备部位加成倍率脚本

[@获取部位属性倍数]

#ACT

; 读取衣服部位倍率存入变量S1

GETEQUIPADDVALUE 0 S1

; 调用变量向玩家展示当前倍率

SendMsg 6 获取衣服属性加成倍数是：<$str(S1)>

四、功能运行逻辑说明

1. 倍率存储：通过SETEQUIPADDVALUE指令设置的万分比倍数，会自动保存至人物角色数据，永久留存，下线重新登录不重置；

2. 加成触发：玩家穿戴对应ID位置的装备后，引擎自动读取已保存倍率，对人物全部基础属性进行加权计算；

3. 数值读取：可通过GETEQUIPADDVALUE指令或全局常量，随时调取当前部位倍率，用于脚本逻辑判断和前端展示。

五、常见使用注意事项

1. 倍率基准固定为万分比，切勿直接填写1.5、2.0等小数，标准1倍必须填写10000；

2. 装备部位ID需严格匹配引擎规范，不同引擎头盔、手镯、戒指的编号存在细微差异，配置前请核对引擎说明书；

3. 控制符优先使用+=实现叠加加成，重复执行设置指令可累加倍率，使用=会直接覆盖原有数值；

4. 变量建议使用S系列全局变量，避免局部变量导致倍率读取失败，弹窗展示时需通过<$str(变量)>格式化输出。