SetFactionRank
From The Elder Scrolls Construction Set Wiki
Syntax:
[ActorID.]SetFactionRank FactionID, newRank
Examples:
SetFactionRank FightersGuild, 0 CaranyaRef.SetFactionRank MagesGuild, -1
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.
SetFactionRank FactionID, -1 will remove an actor from the faction.
[edit] 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.
