传奇聚灵珠经验检测回收脚本教程 完整DB配置说明
一、聚灵珠核心脚本功能介绍在传奇版本搭建与定制中，聚灵珠是玩家升级、提升内功的核心道具，聚灵珠经验检测、满经验回收、道具生成等脚本功能，是版本必备的基础模块。本文完整整理传奇聚灵珠全套脚本指令、触发机制、回收逻辑及DB数据库配置规范，适配各类传奇单机、开区版本使用，帮助开发者快速实现聚灵珠完整功能。…
一、聚灵珠核心脚本功能介绍
在传奇版本搭建与定制中，聚灵珠是玩家升级、提升内功的核心道具，聚灵珠经验检测、满经验回收、道具生成等脚本功能，是版本必备的基础模块。本文完整整理传奇聚灵珠全套脚本指令、触发机制、回收逻辑及DB数据库配置规范，适配各类传奇单机、开区版本使用，帮助开发者快速实现聚灵珠完整功能。
聚灵珠脚本主要实现两大核心功能，分别是聚灵珠经验已满检测和满经验聚灵珠回收，通过专属脚本指令精准判断道具持久状态、经验存储情况，完成道具校验与回收操作，适配普通经验、内功经验两类聚灵珠道具。
二、核心脚本指令详解
2.1 经验检测与道具移除指令
传奇引擎内置两大聚灵珠专属操作指令，为功能实现核心支撑，具体参数与用法如下：
CHECKITEMDURACOUNT：聚灵珠经验状态检测指令，核心作用为检测玩家背包内指定聚灵珠的持久填满数量，以此判断道具经验是否累积已满，适配所有带持久经验属性的聚灵珠道具。
TAKEDURAITEM：满状态道具移除指令，专门用于拿走玩家背包内满足满经验条件的聚灵珠，包含三个核心参数，分别为物品名称、经验状态、操作数量，精准筛选已满经验的聚灵珠完成移除。
2.2 聚灵珠使用触发机制
玩家使用聚灵珠时，会触发引擎专属QF脚本段，对应触发标识为[@ONUSEEXPBALL]、[@ONHEROUSEEXPBALL]，脚本自带三大参数，可直接调用：
<$PARAM(1)>：对应聚灵珠物品名称
<$PARAM(2)>：对应道具使用价格
<$PARAM(3)>：对应价格类型，支持0-4五种模式
2.3 GM聚灵珠生成指令
版本管理中可通过GM命令直接生成已满经验的聚灵珠，基础指令格式：GIVE 聚灵珠 1 满，可快速生成满状态聚灵珠道具，用于版本测试、福利发放等场景。
三、脚本标准格式与检测案例
3.1 CHECKITEMDURACOUNT标准格式
指令通用格式：CHECKITEMDURACOUNT 物品名是否聚满(0=未满，1=已满) <=> 数量
功能释义：检测玩家包裹内指定名称的聚灵珠，根据设定的满状态数值、数量阈值，判断是否满足对应条件，是聚灵珠批量检测的核心脚本格式。
3.2 聚灵珠满经验检测脚本示例
[@MAIN]
#IF
CHECKITEMDURACOUNT 聚灵珠(大) 1 > 9
#SAY
你的10个聚灵珠(大)已经都已经累积满了。
#ELSESAY
你没有足够已满经验的聚灵珠(大)。\
脚本逻辑：检测玩家背包中已满经验的大聚灵珠数量，若数量大于9个，提示玩家道具已满，反之提示无足够满经验道具，适配批量聚灵珠检测场景。
3.3 聚灵珠回收功能脚本示例
[@main]
#IF
CHECKITEMDURACOUNT 聚灵珠(大) 1 > 10
#ACT
TAKEDURAITEM 聚灵珠(大) 1 10
#SAY
回收聚灵珠(大)成功。
#ELSESAY
没有可以回收的聚灵珠(大)。
脚本逻辑：校验玩家满经验大聚灵珠数量，满足数量条件则自动移除对应满状态道具，触发回收成功提示，不满足则提示无可用回收道具，完美适配游戏内聚灵珠回收系统。
四、聚灵珠DB数据库配置规范
聚灵珠功能正常生效，需严格匹配传奇物品DB数据库参数，核心字段配置标准如下，所有参数直接决定聚灵珠经验类型、满状态生成、释放模式。
4.1 核心字段参数定义
STDMODE：固定取值2，为聚灵珠专属道具类型标识，不可修改。
SHAPE：决定聚灵珠经验类型，10为普通经验聚灵珠，11为内功经验聚灵珠，区分两大核心道具品类。
DURAMAX：聚灵珠累计经验上限设置，以万位为计算单位，数值越大，聚灵珠可累积经验越多。
NEED字段：聚灵珠经验释放付费模式，0为无限制免费释放，1为金币模式，2为元宝模式，3为金刚石模式，4为灵符模式。
4.2 满状态聚灵珠生成规则
当聚灵珠DB配置为STDMODE=2、SHAPE=10，同时满足ANICOUNT不等于0、SOURCE=0时，道具生成后直接为满持久满经验状态，不满足条件则道具持久为0，无累积经验。
4.3 满聚灵珠生成指令合集
除基础GM命令外，多种场景可生成满状态聚灵珠，适配不同版本需求：@MAKE 聚灵珠 1 满、GIVE 聚灵珠 1 满、GIVEEX 聚灵珠 1 满、SENDMAIL 聚灵珠&满。
五、全品类聚灵珠DB配置实例
下文为传奇全系列聚灵珠完整DB数据，包含普通、英雄、超级、内功四大品类，小、中、大三种规格，可直接复制导入物品数据库使用：
35;聚灵珠(小);2;10;1;1;0;0;820;20;0;0;0;0;0;0;0;0;0;0;1;0;50000;5;0;10;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;
36;聚灵珠(中);2;10;1;1;0;0;820;150;0;0;0;0;0;0;0;0;0;0;2;0;8;5;0;10;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;
37;聚灵珠(大);2;10;1;1;0;0;820;300;0;0;0;0;0;0;0;0;0;0;2;0;15;5;0;10;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;
38;英雄聚灵珠(小);2;10;1;1;0;0;1589;20;0;0;0;0;0;0;0;0;0;0;1;0;50000;5;0;10;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;
39;英雄聚灵珠(中);2;10;1;1;0;0;1589;150;0;0;0;0;0;0;0;0;0;0;2;0;8;5;0;10;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;
40;英雄聚灵珠(大);2;10;1;1;0;0;1589;300;0;0;0;0;0;0;0;0;0;0;2;0;15;5;0;10;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;
41;超级聚灵珠(小);2;10;1;0;0;0;820;100;0;0;0;0;0;0;0;0;0;0;1;0;50000;5;0;10;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;
42;超级聚灵珠(中);2;10;1;0;0;0;820;800;0;0;0;0;0;0;0;0;0;0;1;0;350000;5;0;10;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;
43;超级聚灵珠(大);2;10;1;0;0;0;820;5000;0;0;0;0;0;0;0;0;0;0;1;0;1500000;5;0;10;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;
44;内功聚灵珠(小);2;11;1;1;0;0;1785;20;0;0;0;0;0;0;0;0;0;0;1;0;50000;5;0;10;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;
45;内功聚灵珠(中);2;11;1;1;0;0;1785;150;0;0;0;0;0;0;0;0;0;0;2;0;8;5;0;10;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;
46;内功聚灵珠(大);2;11;1;1;0;0;1785;300;0;0;0;0;0;0;0;0;0;0;2;0;15;5;0;10;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;
