Difference between revisions of "OnPlayerLoadGame - Actor"

From the CreationKit Wiki
Jump to navigation Jump to search
imported>DreamKing
(Created page with "Category:Scripting Category:Papyrus Category:Events '''Member of:''' Actor Script Event introduced by the 1.6 Skyrim update that is called when the player loa...")
 
imported>Antares
m (→‎Notes: Whoops, formatting)
 
(15 intermediate revisions by 4 users not shown)
Line 2: Line 2:
[[Category:Papyrus]]
[[Category:Papyrus]]
[[Category:Events]]
[[Category:Events]]
'''Member of:''' [[Actor Script]]
'''Member of:''' [[Actor Script]] ''(Requires 1.6)''


Event introduced by the 1.6 Skyrim update that is called when the player loads a saved game. Seems to only be called when actually attached to the player character (e.g., in a script attached to a [[Reference Alias]] set to be filled by the player). Is not called the first time a script is loaded, when a mod is first activated; only on subsequent loads.
Event called when the player loads a save game. This event is '''only''' sent to the player actor. If this is the first save game load where the event is being listened to, and the event is on an alias, and the alias didn't exist at the time the save was made, then the player won't be in the alias by the time the event is sent, and the alias script will not receive the event. It should then receive later events.


== Syntax ==
== Syntax ==
Line 10: Line 10:
Event OnPlayerLoadGame()
Event OnPlayerLoadGame()
</source>
</source>
== Parameters ==
None.


== Examples ==
== Examples ==
*Normal use
<source lang="papyrus">
<source lang="papyrus">
; Event is only sent to the player actor. This would probably be on a magic effect or alias script
Event OnPlayerLoadGame()
Event OnPlayerLoadGame()
   Debug.Trace("The player has loaded a saved game.")
   Debug.Trace("player loaded a save, do some fancy stuff")
endEvent
</source>
*Do something exactly once per save load
Say you need something to happen '''exactly''' once every time a save is loaded ''including'' the first and you're using a ReferenceAlias filled with the Player. In the below example with a quest flagged as "Start Game Enabled" and set to "Run Once" from within its [[Quest Data Tab]], we maintain a Float Property (valueless in editor) such that it will invariably reflect the version loaded. Use an [[OnInit]] event in the quest's script to catch the first save load...
<source lang="papyrus">ScriptName YourQuestScript extends Quest
Float Property fYourModVersion Auto
 
Event OnInit()
Maintenance()
EndEvent
EndEvent
</source>
Function Maintenance()
If fYourModVersion < 1.23 ; Current version
If fYourModVersion
Debug.Trace("Updating from version " + fYourModVersion)
Else
Debug.Trace("Initializing for the first time.")
EndIf
fYourModVersion = 1.23
EndIf
EndFunction</source>
...and use your player alias' OnPlayerLoadGame event to catch each consecutive save load.
<source lang="papyrus">ScriptName YourPlayerAliasScript extends ReferenceAlias
YourQuestScript Property QuestScript Auto
 
Event OnPlayerLoadGame()
QuestScript.Maintenance()
EndEvent</source>
 
== Notes ==
This event is only sent to the player actor. It is recommended that you handle this event via an alias the player is forced into, or a magic effect on the player.<BR>
This event will not be sent when starting a new game. See the discussion page for more information.


== See Also ==
== See Also ==
*[[Actor Script]]
*[[Actor Script]]

Latest revision as of 10:00, 26 December 2012

Member of: Actor Script (Requires 1.6)

Event called when the player loads a save game. This event is only sent to the player actor. If this is the first save game load where the event is being listened to, and the event is on an alias, and the alias didn't exist at the time the save was made, then the player won't be in the alias by the time the event is sent, and the alias script will not receive the event. It should then receive later events.

Syntax[edit | edit source]

Event OnPlayerLoadGame()

Parameters[edit | edit source]

None.

Examples[edit | edit source]

  • Normal use
; Event is only sent to the player actor. This would probably be on a magic effect or alias script
Event OnPlayerLoadGame()
  Debug.Trace("player loaded a save, do some fancy stuff")
endEvent
  • Do something exactly once per save load

Say you need something to happen exactly once every time a save is loaded including the first and you're using a ReferenceAlias filled with the Player. In the below example with a quest flagged as "Start Game Enabled" and set to "Run Once" from within its Quest Data Tab, we maintain a Float Property (valueless in editor) such that it will invariably reflect the version loaded. Use an OnInit event in the quest's script to catch the first save load...

ScriptName YourQuestScript extends Quest
 
Float Property fYourModVersion Auto

Event OnInit()
	Maintenance()
EndEvent
 
Function Maintenance()
	If fYourModVersion < 1.23 ; Current version
		If fYourModVersion
			Debug.Trace("Updating from version " + fYourModVersion)
		Else
			Debug.Trace("Initializing for the first time.")
		EndIf
		fYourModVersion = 1.23
	EndIf
EndFunction

...and use your player alias' OnPlayerLoadGame event to catch each consecutive save load.

ScriptName YourPlayerAliasScript extends ReferenceAlias
 
YourQuestScript Property QuestScript Auto

Event OnPlayerLoadGame()
	QuestScript.Maintenance()
EndEvent

Notes[edit | edit source]

This event is only sent to the player actor. It is recommended that you handle this event via an alias the player is forced into, or a magic effect on the player.
This event will not be sent when starting a new game. See the discussion page for more information.

See Also[edit | edit source]