删除/整理堆叠物品
‘ 【删除/整理堆叠物品】 必须拥有User对象。【015版本以及以上才可用】
‘ ——————-如: sys_delItemPile 1000000 10 100
‘ ——————-参数1:物品ID。必须是可堆叠的物品,不是堆叠的物品请用脚本系统自带的脚本命令
‘ ——————-参数2:删除数量
‘ ——————-参数3:物品堆叠上限 (当删除失败时,用于自动整理堆叠物品,必须与数据库里的一致)
‘ ——————————返回值:删除成功走 next - 删除失败走 nextfail
‘ ——————————如果成功:%iter_var_str9 = 删除的数量
‘ ——————————如果失败:%iter_var_str9 = 堆叠物品的总和。分散的小堆会全部相加后返回。
本方法存在的意义:堆叠物品的处理一直是一个痛点。比如有4组49个的物品,由于任务要删除50个,脚本系统原有的命令删除50个时会执行失败!本方法能够很好的处理多个小堆物品的使用问题。
本方法自带的整理功能:当删除物品失败时,会对物品堆进行自动整理。将多个分散的堆整理成完整数量的堆。当你想用这个方法【整理物品】时,那么可以将【删除数量】设置为一个极大的值。由于所有同类物品堆叠后的总和不满足【删除数量】,会导致删除失败。该方法内部会对物品进行堆叠重新整理。【同时也会返回背包中同类物品的总和】
注意:本方法未处理【赠】物品的情况。请悉知。如有同类型的赠物品会将其变成非赠品
示例
| id | id_next | id_nextfail | type | data | param |
|---|---|---|---|---|---|
| 100000100 | 100000101 | 100000102 | 2003 | 0 | sys_delItemPile 1000000 10 100 |
| 100000101 | 0 | 0 | 126 | 0 | 成功删除了%iter_var_data9个 |
| 100000102 | 0 | 0 | 126 | 0 | 删除失败!背包里总共有%iter_var_data9个 |