PlaceAtMe - ObjectReference

Revision as of 17:23, 18 November 2015 by imported>Plplecuyer (→‎Parameters)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Member of: ObjectReference Script

Makes X new references of the passed in form, optionally forcing them to persist, and places them at our reference's location, returning the last one it created.

SyntaxEdit

ObjectReference Function PlaceAtMe(Form akFormToPlace, int aiCount = 1,
   bool abForcePersist = false, bool abInitiallyDisabled = false, bool abDeleteWhenAble = true) native

ParametersEdit

  • akFormToPlace: The base form to create references of.
    • Note: the akFormToPlace can be things such as MiscObject, ActorBase, etc...
  • aiCount: How many references to make at once.
    • Default: 1
    • Caution: Only the last reference created is returned.
  • abForcePersist: True to force the created reference to be persistent.
    • Default: False
  • abInitiallyDisabled: True to force the reference to be initially disabled
    • Default False
  • abDeleteWhenAble: True to force the reference to be deleted as soon as it is no longer persisted by a property or quest and is no longer in the loaded area.
    • Default True

Return ValueEdit

The last ObjectReference that was created. Or None if no references could be created for some reason.

ExamplesEdit

; Place a new box at the target marker
ObjectReference newBox = TargetMarker.PlaceAtMe(BoxBase)


; Place a two new boxes at the target marker
ObjectReference oneOfTheBoxes = TargetMarker.PlaceAtMe(BoxBase, 2)

NotesEdit

If you want to place a leveled actor, you probably want PlaceActorAtMe - ObjectReference.

See AlsoEdit