CopyItem(object, object)

Duplicates an item.

object CopyItem(
    object oItem,
    object oTargetInventory = OBJECT_INVALID
);

Parameters

oItem

Item to copy.

oTargetInventory

Create the item within this inventory (Default: OBJECT_INVALID)


Description

Duplicates an existing item and returns it. Returns OBJECT_INVALID for non-items. Can only copy empty item containers; will not copy and will return OBJECT_INVALID for item containers which contain items. If it is possible to merge the item with any others in the target location (into a stack), then it will do so and return the merged item.



Remarks

This function doesn't seem to be able to do anything that CopyObject can't do, but it leaves out the mandatory input of a location.

Can be used for custom treasure systems by finding an item in a treasureholder container, and then calling CopyItem to make a copy of the item in the container or creature calling the function.


Version

1.30

See Also

functions: CopyObject | CreateItemOnObject
categories: Item Creation Functions


 author: Charles Feduke, editor: Lilac Soul
 Send comments on this topic.