SetFactionRank
From GECK
A function included in the GECK for Fallout 3.
Contents
Description
Sets the actor's rank in the specified faction. If the actor is not a member of the faction, adds them to the faction at the new rank.
Syntax
Actor.SetFactionRank FactionID:faction newRank:int
Example
KarenSchenzyREF.SetFactionRank ArefuFaction 1
Sets Karen to rank one in the ArefuFaction faction.
Player.SetFactionRank ArefuFaction -1
This will remove the player from the ArefuFaction faction.
Notes
The faction rank is set on the actor's base object as well as on the actor (reference) itself. Any actor spawned from the same base object (by a leveled list, by PlaceAtMe and so on) will have this faction, at the same rank, already set. This is not a problem for named characters (of which there is usually just one in the world), but can be a problem for random, unnamed characters or creatures.