Difference between revisions of "CreateFullActorCopy"
Jump to navigation
Jump to search
imported>DragoonWraith (CS 1.0, and not Misc (it's in Actor Functions)) |
imported>QQuix m (Fixed a couple of internal links) |
||
(12 intermediate revisions by 9 users not shown) | |||
Line 5: | Line 5: | ||
player.CreateFullActorCopy | player.CreateFullActorCopy | ||
Creates a copy of the specified actor and its base. | Creates a copy of the specified actor and its base. The copy will have its own base. | ||
Line 16: | Line 16: | ||
In both cases the copy will be an exact duplicate of the original actor, including inventory, with the following exceptions: | In both cases the copy will be an exact duplicate of the original actor, including inventory, with the following exceptions: | ||
* Inventory items are duplicated in the same manner as [[DuplicateAllItems]] | * Inventory items are duplicated in the same manner as [[DuplicateAllItems]], Such items are treated by the game in a way that is not dissimilar to [[PlaceAtMe]] items in that their Base Records cannot be destroyed. | ||
* The copy will not have any AI packages or factions | ** Like [[DuplicateAllItems]], any scripted item will be given a new FormID. See [[DuplicateAllItems]] for more details. | ||
* The copy will not have any AI packages, and there may be discrepancies on the [[Aggression]], [[Confidence]], [[AI Button|Energy Level]], [[Responsibility]] and Attack Damage values between the Original and the Copy. | |||
* Factions will be duplicated but aren't persistent on the copy | |||
==Notes== | |||
* Using this command does not clear factions when called on the player. Attacking or stealing from a player clone without first removing the clone from these factions may cause the player to be expelled from those factions. | |||
**Therefore it is suggested to remove player guild factions from the clone when created (see discussion for method). | |||
* Using this command on a creature will create a copy that rampages wildly, even if the original actor has an aggression value of 5 or less and/or is part of a faction that isn't considered evil. | |||
* If used on an actor who has leveled item lists in his inventory, those lists will be copied to the new actor along with the other items. There they will display as <Missing Name> and as a missing mesh if you drop them on the ground. Note that clearing the actor's inventory before you use CreateFullActorCopy does not help, as you can not remove leveled item lists with RemoveAllItems or RemoveItem. | |||
==See Also== | ==See Also== | ||
[[DeleteFullActorCopy]] | [[DeleteFullActorCopy]] | ||
[[Category: Functions]] | [[Category: Functions]] | ||
[[Category:Functions (CS)]] | |||
[[Category: Functions (CS 1.0)]] | [[Category: Functions (CS 1.0)]] | ||
[[Category: Actor Functions]] | [[Category: Actor Functions]] | ||
[[Category: Actor Functions (CS 1.0)]] | [[Category: Actor Functions (CS 1.0)]] | ||
<!-- Begin Search Terms | |||
Create | |||
Full | |||
Actor | |||
Copy | |||
End Search Terms --> |
Latest revision as of 08:00, 15 November 2011
Syntax:
[ActorID.]CreateFullActorCopy
Example:
player.CreateFullActorCopy
Creates a copy of the specified actor and its base. The copy will have its own base.
Example:
set newRef to player.CreateFullActorCopy
Creates a copy of the actor and returns the ID of the new copy, so it can be used to set a reference variable.
In both cases the copy will be an exact duplicate of the original actor, including inventory, with the following exceptions:
- Inventory items are duplicated in the same manner as DuplicateAllItems, Such items are treated by the game in a way that is not dissimilar to PlaceAtMe items in that their Base Records cannot be destroyed.
- Like DuplicateAllItems, any scripted item will be given a new FormID. See DuplicateAllItems for more details.
- The copy will not have any AI packages, and there may be discrepancies on the Aggression, Confidence, Energy Level, Responsibility and Attack Damage values between the Original and the Copy.
- Factions will be duplicated but aren't persistent on the copy
Notes[edit | edit source]
- Using this command does not clear factions when called on the player. Attacking or stealing from a player clone without first removing the clone from these factions may cause the player to be expelled from those factions.
- Therefore it is suggested to remove player guild factions from the clone when created (see discussion for method).
- Using this command on a creature will create a copy that rampages wildly, even if the original actor has an aggression value of 5 or less and/or is part of a faction that isn't considered evil.
- If used on an actor who has leveled item lists in his inventory, those lists will be copied to the new actor along with the other items. There they will display as <Missing Name> and as a missing mesh if you drop them on the ground. Note that clearing the actor's inventory before you use CreateFullActorCopy does not help, as you can not remove leveled item lists with RemoveAllItems or RemoveItem.
See Also[edit | edit source]