Difference between revisions of "AddPerk"

From GECK

(Notes: Perk issue fixed in v1.5 of FO3)
Line 1: Line 1:
=='''Description'''==
+
{{Function
 
+
|origin = GECK1
Increments the rank of the specified perk on an Actor.  If the specified Actor doesn't already have the perk, then it will be added with rank 1.
+
|summary = Increments the rank of the specified perk on an Actor.  If the specified Actor doesn't already have the perk, then it will be added with rank 1.
 
+
|name = AddPerk
=='''Syntax'''==
+
|returnType = void
 
+
  |referenceType = [ActorRefID]
  ''[ActorID.]''AddPerk ''PerkID''
+
|arguments =
 
+
  {{FunctionArgument
=='''Examples'''==
+
  |Name = PerkID
 
+
  }}
  BuddyRef.AddPerk LittleSlugger
+
  |example = BuddyRef.AddPerk LittleSlugger
 
+
 
Buddy now has the benefits of the little slugger perk.
 
Buddy now has the benefits of the little slugger perk.
 +
}}
  
 
==Notes==
 
==Notes==
Line 25: Line 25:
  
 
==See Also==
 
==See Also==
[[RemovePerk]]
+
*[[RemovePerk]]
  
 
[[Category:Functions]]
 
[[Category:Functions]]

Revision as of 00:09, 13 January 2011

A function included in the GECK version 1.1.0.36.

Description

Increments the rank of the specified perk on an Actor. If the specified Actor doesn't already have the perk, then it will be added with rank 1.

Syntax

[ActorRefID].AddPerk PerkID

Example

BuddyRef.AddPerk LittleSlugger

Buddy now has the benefits of the little slugger perk.

Notes

  • With Fallout 3 version 1.4 or older: Loading a savegame in which the player has a mod-created perk, when the mod that created it is no longer installed, may crash the game. That issue was fixed in Fallout v1.5. If you know the FormId of the Perk, you can remove it from yourself using the console. Modders are also advised to provide an in-game means for players to remove perks, should they wish to uninstall while keeping older versions of FO3, or at least provide instructions on how to remove the perks.
  • One simple way is to provide an "uninstaller" esm file, that the user must install, load their game, and save it, before they remove the mod. The esm will do nothing but remove the perks, and contains one quest, called something like "MyPerkRemovalQuest", set to "start game enabled", with a Quest-type script:
   ScriptName MyPerkRemovalQuestScript
   
   Begin GameMode
       player.RemovePerk MyExamplePerk
       StopQuest MyPerkRemovalQuest
   End

See Also

Personal tools