Difference between revisions of "CloneForm"

From the Oblivion ConstructionSet Wiki
Jump to navigation Jump to search
imported>Haama
(Cloned NPCs are unscripted)
imported>DragoonWraith
 
(6 intermediate revisions by 5 users not shown)
Line 6: Line 6:
This function creates an exact duplicate of the referenced base object supplied in objectID and returns the new objectID.
This function creates an exact duplicate of the referenced base object supplied in objectID and returns the new objectID.


'''Example:'''
<pre>
<pre>
ref clone
ref clone
Line 17: Line 18:
==Notes==
==Notes==
*Cloned forms are saved in the save game.
*Cloned forms are saved in the save game.
*Cloning an object allows you to then make changes to the clone without affecting the original object.  
*Cloning an object allows you to then make changes to the clone without affecting the original object. Changes to cloned base objects are also saved, which they usually are not.
*This function works for any game type (objects, spells, enchantments, NPCs).
*This function works for any game type (objects, spells, enchantments, NPCs).
*If called on an Inventory Object (weapon, armor, light, potion, book, ingredient etc.) you may pass the CS EditorID directly into the function.  
*If called on an Inventory Object (weapon, armor, light, potion, book, ingredient etc.) you may pass the CS EditorID directly into the function.  
*For any other type you must first set a ref variable to the appropriate objectID before calling CloneForm.
*For any other type you must first set a ref variable to the appropriate objectID before calling CloneForm.
* Cloned NPCs have no items in their inventories and are unscripted.
* Cloned NPCs have no items in their inventories and are unscripted.
* It appears that an NPC can only be cloned once.
* Cloned books will not have text.
==See Also==
*[[IsClonedForm]]


<!--[[Category: OBSE Functions]]
<!--[[Category: OBSE Functions]]

Latest revision as of 14:30, 30 September 2011

A command for Oblivion Script Extender

Syntax:

[nuObjectID] CloneForm [objectID]

This function creates an exact duplicate of the referenced base object supplied in objectID and returns the new objectID.

Example:

ref clone
ref originalObject

set originalObject to myReference.GetBaseObject
set clone to CloneForm originalObject; clone the base object of myReference
player.placeAtMe clone 1 0 0 ; place a reference to the clone at the player's location

Notes[edit | edit source]

  • Cloned forms are saved in the save game.
  • Cloning an object allows you to then make changes to the clone without affecting the original object. Changes to cloned base objects are also saved, which they usually are not.
  • This function works for any game type (objects, spells, enchantments, NPCs).
  • If called on an Inventory Object (weapon, armor, light, potion, book, ingredient etc.) you may pass the CS EditorID directly into the function.
  • For any other type you must first set a ref variable to the appropriate objectID before calling CloneForm.
  • Cloned NPCs have no items in their inventories and are unscripted.
  • It appears that an NPC can only be cloned once.
  • Cloned books will not have text.

See Also[edit | edit source]