删除/整理堆叠物品

页面ID: 656

‘ 【删除/整理堆叠物品】 必须拥有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个