GetSelf

From GECK
Jump to: navigation, search

Link to TES4 Construction Set Wiki: GetSelf.

A function included in the GECK for Fallout 3.

Description

Returns the RefID of the calling reference. GetSelf is only useful when this information is accessed externally, or when the scripted reference's RefID needs to be passed as a parameter to a function like PushActorAway

Returns null if there is no valid calling reference, OR if the calling reference happens to be a non-Persistent Item. This latter property can cause issues with scripts that run on items; see GetSelfAlt for a safer alternative.

Syntax

[help]
GetSelf 

Or:

this

Example

ref rSelf
set rSelf to GetSelf
player.PushActorAway rSelf 5 

Notes

  • GetSelf shouldn't be used in object scripts on an item that is or can be in inventory.
  • While functions that take an implied reference can be cast without needing a variable or call to getself, like so:
    CIOS someSpell

    Doing so may not be clear, and makes the code less portable if moved to a different script that does not support the implied reference. For this reason, modders should prefer the more expressive syntax:

    ref rSelf
    set rSelf to GetSelf
    rSelf.CIOS someSpell

    Not only for CIOS, but for all "reference methods" that require a reference, like CIOS.

  • GetSelf will return 0 if called on a reference that has been created dynamically (for example, created via PlaceAtMe, or dropped from an inventory into the game world).
  • Using "GetSelf" in scripts rather than "this" will result in GECKPU throwing errors.

See Also