PlaceAtMe
From GECK
Link to TES4 Construction Set Wiki: PlaceAtMe.
A function included in the GECK for Fallout 3.
Contents
Description
Places a given number of the specified object in the world at the location of the calling reference. Two optional parameters allow the object to be offset from this location. When used with Leveled Actors the second optional parameter is a level modifer that works the same as a Leveled Actor spawn marker.
Syntax
[Reference].PlaceAtMe ObjectID:ref Count:int Distance:float Direction:int{0, 1, 2, 3}
Example
PlaceAtMe Apple 1 Player.PlaceAtMe Apple 3
Parameters
Direction options:
| Direction Value | Location relative to calling reference |
|---|---|
| 0 | In front of |
| 1 | Behind |
| 2 | To the left of |
| 3 | To the right of |
Getting the Created Object's Reference
Often, you may want to use the object you've created in a script. Use the following syntax:
ref placedObject set placedObject to Player.PlaceAtMe objectToPlace 1
- The placedObject variable will now have a reference to the new objectToPlace.
- This reference is only reliable for objects that can't be picked up (when they're picked up the reference is destroyed). Accessing the reference of an inventory-item after someone picked it up can cause a CTD.
- Note that GetSelf won't return the correct reference when used on PlaceAtMe objects.
Caution
- Using the PlaceAtMe function in scripts without cleaning them up later is considered bad modding etiquette. This is because too many calls to PlaceAtMe leaves objects in the game and will lead to bloated save-games after a while, which impacts game performance and loading times.
- To avoid this problem, clean up unneeded references using MarkForDelete:
placedObject.Disable placedObject.MarkForDelete
- Actor references created using this function are *not* removed upon cell reset unless killed and in that case will be fully removed after 3 days and not bloat saves (Unless flagged as a quest item on the actor baseform).
- Projectile references created using this function are *not* removed upon cell reset.
- Misc. items, weapons, armor, and possibly other playable items created using this function are also unloaded/destroyed if picked up.
- Explosion references created using this function are unloaded after their animation plays once.
Notes
- Any variables declared in an object or actor script which has been created with PlaceAtMe is non persistent, and any variables in that object or actor script will be reset to 0 any time the object is reloaded or on game load.
- Trying to run script commands on objects created in the same frame may not work, since it takes some time to place the object in the world. It is advised to wait a few frames or use a timed pause before attempting to manipulate these objects through scripts.
- The placed object gets the same XYZ angle values as the calling object. Note that world objects placed at the player will be tilted if the player is looking up or down (player X angle not zero ... object X angle not zero).
- This function can be used with leveled creature lists.
- This function can NOT be used with leveled items. Leveled items are not supposed to be placed into the world - you can use them exclusively inside containers. Trying to create an item from a leveled list this way will just cause the yellow exclamation mark (Marker_Error.NIF) to appear.
- The Distance and Direction parameters do not work. No matter what is specified for them, the created reference will be placed in safe location nearby the calling reference.
- If used to spawn a dead body (An actor with 0 health) the actor will spawn alive, use Kill to prevent this.
