Difference between revisions of "Quest Script"

From the CreationKit Wiki
Jump to navigation Jump to search
imported>CraftySentinel
m (→‎Member Functions: Fixed Typos)
imported>CraftySentinel
(Revert to List)
Line 1: Line 1:
[[Category:Scripting]]
[[Category:Papyrus]]
[[Category:Script Objects]]
'''Extends:''' [[Form Script]]
'''Extends:''' [[Form Script]]


Line 14: Line 10:
== Member Functions ==
== Member Functions ==


{|class="wikitable" width =100%
:'''[[CompleteAllObjectives - Quest|CompleteAllObjectives]]()'''
!style="text-align:left;"|Function
:*Completes all a quests objectives.
!style="text-align:left;"|Description
|-
|[[CompleteAllObjectives - Quest|'''CompleteAllObjectives'''()]]
|Completes all a quests objectives.
|-


|[[CompleteQuest - Quest|'''CompleteQuest'''()]]
:'''[[CompleteQuest - Quest|CompleteQuest]]()'''
|Flags this quest as completed.
:*Flags this quest as completed.
|-


|[[FailAllObjectives - Quest|'''FailAllObjectives'''()]]
:'''[[FailAllObjectives - Quest|FailAllObjectives]]()'''
|Flags all quest objects as failed.
:*Flags all quest objects as failed.
|-


|[[GetAlias - Quest|Alias '''GetAlias'''(Int ''aiAliasID'')]]
:'''Alias [[GetAlias - Quest|GetAlias]](Int ''aiAliasID'')'''
|Obtains the [[Alias Script|Alias]] attached to this quest associated with the specified ID.
:*Obtains the [[Alias Script|Alias]] attached to this quest associated with the specified ID.
|-


|[[GetCurrentStageID - Quest|Int '''GetCurrentStageID'''()]]
:'''Int [[GetCurrentStageID - Quest|GetCurrentStageID]]()'''
|Obtains the highest completed stage on this quest.
:*Obtains the highest completed stage on this quest.
|-


|[[GetStage - Quest|Int '''GetStage'''()]]
:'''Int [[GetStage - Quest|GetStage]]()'''
|Alias for GetCurrentStageID().
:*Alias for GetCurrentStageID().
|-


|[[GetStageDone - Quest|Bool '''GetStageDone'''(Int ''aiStage'')]]
:'''Bool [[GetStageDone - Quest|GetStageDone]](Int ''aiStage'')'''
|Alias for IsStageDone().
:*Alias for IsStageDone().
|-


|[[IsActive - Quest|Bool '''IsActive'''()]]
:'''Bool [[IsActive - Quest|IsActive]]()'''
|Is this quest "active"? (Tracked by the player).
:*Is this quest "active"? (Tracked by the player).
|-


|[[IsCompleted - Quest|Bool '''IsCompleted'''()]]
:'''Bool [[IsCompleted - Quest|IsCompleted]]()'''
|Returns whether this quest is completed or not.
:*Returns whether this quest is completed or not.
|-


|[[IsObjectiveCompleted - Quest|Bool '''IsObjectiveCompleted'''(Int ''aiObjective'')]]
:'''Bool [[IsObjectiveCompleted - Quest|IsObjectiveCompleted]](Int ''aiObjective'')'''
|Obtains whether the specified objective is completed or not.
:*Obtains whether the specified objective is completed or not.
|-


|[[IsObjectiveDisplayed - Quest|Bool '''IsObjectiveDisplayed'''(Int ''aiObjective'')]]
:'''Bool [[IsObjectiveDisplayed - Quest|IsObjectiveDisplayed]](Int ''aiObjective'')'''
|Obtains whether the specified objective is displayed or not.
:*Obtains whether the specified objective is displayed or not.
|-


|[[IsObjectiveFailed - Quest|Bool '''IsObjectiveFailed'''(Int ''aiObjective'')]]
:'''Bool [[IsObjectiveFailed - Quest|IsObjectiveFailed]](Int ''aiObjective'')'''
|Obtains whether the specified objective is failed or not.
:*Obtains whether the specified objective is failed or not.
|-


|[[IsRunning - Quest|Bool '''IsRunning'''()]]
:'''Bool [[IsRunning - Quest|IsRunning]]()'''
|Returns whether this quest is currently running or not.
:*Returns whether this quest is currently running or not.
|-


|[[IsStageDone - Quest|Bool '''IsStageDone'''(Int ''aiStage'')]]
:'''Bool [[IsStageDone - Quest|IsStageDone]](Int ''aiStage'')'''
|Checks to see if the specified stage is done or not.
:*Checks to see if the specified stage is done or not.
|-


|[[IsStarting - Quest|Bool '''IsStarting'''()]]
:'''Bool [[IsStarting - Quest|IsStarting]]()'''
|Returns whether this quest is currently enabled but not running yet.
:*Returns whether this quest is currently enabled but not running yet.
|-


|[[IsStopping- Quest|Bool '''IsStopping'''()]]
:'''Bool [[IsStopping- Quest|IsStopping]]()'''
|Returns whether this quest is currently not enabled anymore but still shutting down.
:*Returns whether this quest is currently not enabled anymore but still shutting down.
|-


|[[IsStopped- Quest|Bool '''IsStopped'''()]]
:'''Bool [[IsStopped- Quest|IsStopped]]()'''
|Returns whether this quest is currently fully stopped.
:*Returns whether this quest is currently fully stopped.
|-


|[[ModObjectiveGlobal - Quest|Bool '''ModObjectiveGlobal'''(Float ''afModValue'', GlobalVariable ''aModGlobal'', Int ''aiObjectiveID'', Float ''afTargetValue'', Bool ''abCountingUp'', Bool ''abCompleteObjective'', Bool ''abRedisplayObjective'')]]
:'''Bool [[ModObjectiveGlobal - Quest|ModObjectiveGlobal]](Float ''afModValue'', GlobalVariable ''aModGlobal'', Int ''aiObjectiveID'', Float ''afTargetValue'', Bool ''abCountingUp'', Bool ''abCompleteObjective'', Bool ''abRedisplayObjective'')'''
|Mods a global variable in a threadsafe way. Optional parameters allow automatic redisplay and completion (or failure) of a quest objective using this global variable.
:*Mods a global variable in a threadsafe way. Optional parameters allow automatic redisplay and completion (or failure) of a quest objective using this global variable.
|-


|[[Reset - Quest|'''Reset'''()]]
:'''[[Reset - Quest|Reset]]()'''
|Resets this quest.
:*Resets this quest.
|-


|[[SetActive - Quest|'''SetActive'''(Bool ''abActive'')]]
:'''[[SetActive - Quest|SetActive]](Bool ''abActive'')'''
|Sets or clears this quest as "active". (Tracked by the player)
:*Sets or clears this quest as "active". (Tracked by the player)
|-


|[[SetCurrentStageID - Quest|Bool '''SetCurrentStageID'''(Int ''aiStageID'')]]
:'''Bool [[SetCurrentStageID - Quest|SetCurrentStageID]](Int ''aiStageID'')'''
|Sets the quest to the requested stage, returning true if it succeeded.
:*Sets the quest to the requested stage, returning true if it succeeded.
|-


|[[SetObjectiveCompleted - Quest|'''SetObjectiveCompleted'''(Int ''aiObjective'', Bool ''abCompleted'')]]
:'''[[SetObjectiveCompleted - Quest|SetObjectiveCompleted]](Int ''aiObjective'', Bool ''abCompleted'')'''
|Sets whether the specified objective is completed or not.
:*Sets whether the specified objective is completed or not.
|-


|[[SetObjectiveDisplayed - Quest|'''SetObjectiveDisplayed'''(Int ''aiObjective'', Bool ''abDisplayed'')]]
:'''[[SetObjectiveDisplayed - Quest|SetObjectiveDisplayed]](Int ''aiObjective'', Bool ''abDisplayed'')'''
|Sets whether the specified objective is displayed or not.
:*Sets whether the specified objective is displayed or not.
|-


|[[SetObjectiveFailed - Quest|'''SetObjectiveFailed'''(Int ''aiObjective'', Bool ''abFailed'')]]
:'''[[SetObjectiveFailed - Quest|SetObjectiveFailed]](Int ''aiObjective'', Bool ''abFailed'')'''
|Sets whether the specified objective is failed or not.
:*Sets whether the specified objective is failed or not.
|-


|[[SetCurrentStageID - Quest|Bool '''SetStage'''(Int ''aiStage'')]]
:'''Bool [[SetCurrentStageID - Quest|SetStage]](Int ''aiStage'')'''
|Alias of SetCurrentStageID().
:*Alias of SetCurrentStageID().
|-


|[[Start - Quest|Bool '''Start'''()]]
:'''Bool [[Start - Quest|Start]]()'''
|Starts this quest.
:*Starts this quest.
|-


|[[Stop - Quest|'''Stop'''()]]
:'''[[Stop - Quest|Stop]]()'''
|Stops the quest.
:*Stops the quest.
|-


|[[UpdateCurrentInstanceGlobal - Quest|Bool '''UpdateCurrentInstanceGlobal'''(GlobalVariable ''aUpdateGlobal'')]]
:'''Bool [[UpdateCurrentInstanceGlobal - Quest|UpdateCurrentInstanceGlobal]](GlobalVariable ''aUpdateGlobal'')'''
|Updates the value for the given global for the quest's current instance.
:*Updates the value for the given global for the quest's current instance.
|-


|}


== SKSE Global Functions ==
== SKSE Global Functions ==


{|class="wikitable" width =100%
:'''Quest [[GetQuest - Quest|GetQuest]](String ''editorID'')'''
!style="text-align:left;"|Function
:*Returns the Quest with the specified editor id.
!style="text-align:left;"|Description
|-


|[[GetQuest - Quest|Quest '''GetQuest'''(String ''editorID'')]]
|Returns the Quest with the specified editor id.
|-
|}


== SKSE Functions ==
== SKSE Functions ==


{|class="wikitable" width =100%
:'''String [[GetID - Quest|GetID]]()'''
!style="text-align:left;"|Function
:*Returns the editor ID of the Quest.
!style="text-align:left;"|Description
|-


|[[GetID - Quest|String '''GetID'''()]]
:'''Int [[GetPriority - Quest|GetPriority]]()'''
|Returns the editor ID of the Quest.
:*Returns the priority of the Quest.
|-


|[[GetPriority - Quest|Int '''GetPriority'''()]]
:'''Int [[GetNumAliases - Quest|GetNumAliases]]()'''
|Returns the priority of the Quest.
:*Returns the number of aliases associated with the Quest.
|-


|[[GetNumAliases - Quest|Int '''GetNumAliases'''()]]
:'''Alias [[GetNthAlias - Quest|GetNthAlias]](Int ''index'')'''
|Returns the number of aliases associated with the Quest.
:*Returns the specified alias associated with the Quest.
|-


|[[GetNthAlias - Quest|Alias '''GetNthAlias'''(Int ''index'')]]
:'''Alias [[GetAliasByName - Quest|GetAliasByName]](String ''name'')'''
|Returns the specified alias associated with the Quest.
:*Returns the editor ID of the quest.
|-


|[[GetAliasByName - Quest|Alias '''GetAliasByName'''(String ''name'')]]
|Returns the editor ID of the quest.
|-
|}


== Events ==
== Events ==


{|class="wikitable" width =100%
:'''[[OnReset - ObjectReference|OnReset]]()'''
!style="text-align:left;"|Function
:*Event received when this quest is started up (either the first time or subsequent times - this will fire in parallel with your startup stage!).
!style="text-align:left;"|Description
|-
|[[OnReset - ObjectReference|'''OnReset'''()]]
|Event received when this quest is started up (either the first time or subsequent times - this will fire in parallel with your startup stage!).
|-


|[[OnStoryActivateActor - Quest|'''OnStoryActivateActor'''(Location ''akLocation'', ObjectReference ''akActor'')]]
:'''[[OnStoryActivateActor - Quest|OnStoryActivateActor]](Location ''akLocation'', ObjectReference ''akActor'')'''
|Sent when this quest is started by an activate actor story manager event.
:*Sent when this quest is started by an activate actor story manager event.
|-


|[[OnStoryAddToPlayer - Quest|'''OnStoryAddToPlayer'''(ObjectReference ''akOwner'', ObjectReference ''akContainer'', Location ''akLocation'', Form ''akItemBase'', Int ''aiAcquireType'')]]
:'''[[OnStoryAddToPlayer - Quest|OnStoryAddToPlayer]](ObjectReference ''akOwner'', ObjectReference ''akContainer'', Location ''akLocation'', Form ''akItemBase'', Int ''aiAcquireType'')'''
|Sent when this quest is started by an add to player story manager event.
:*Sent when this quest is started by an add to player story manager event.
|-


|[[OnStoryArrest - Quest|'''OnStoryArrest'''(ObjectReference ''akArrestingGuard'', ObjectReference ''akCriminal'', Location ''akLocation'', Int ''aiCrime'')]]
:'''[[OnStoryArrest - Quest|OnStoryArrest]](ObjectReference ''akArrestingGuard'', ObjectReference ''akCriminal'', Location ''akLocation'', Int ''aiCrime'')'''
|Sent when this quest is started by an arrest story manager event.
:*Sent when this quest is started by an arrest story manager event.
|-


|[[OnStoryAssaultActor - Quest|'''OnStoryAssaultActor'''(ObjectReference ''akVictim'', ObjectReference ''akAttacker'', Location ''akLocation'', Int ''aiCrime'')]]
:'''[[OnStoryAssaultActor - Quest|OnStoryAssaultActor]](ObjectReference ''akVictim'', ObjectReference ''akAttacker'', Location ''akLocation'', Int ''aiCrime'')'''
|Sent when this quest is started by an assault actor story manager event.
:*Sent when this quest is started by an assault actor story manager event.
|-


|[[OnStoryBribeNPC - Quest|'''OnStoryBribeNPC'''(ObjectReference ''akActor'')]]
:'''[[OnStoryBribeNPC - Quest|OnStoryBribeNPC]](ObjectReference ''akActor'')'''
|Sent when this quest is started by a bribe NPC story manager event.
:*Sent when this quest is started by a bribe NPC story manager event.
|-


|[[OnStoryCastMagic - Quest|'''OnStoryCastMagic'''(ObjectReference ''akCastingActor'', ObjectReference ''akSpellTarget'', Location ''akLocation'', Form ''akSpell'')]]
:'''[[OnStoryCastMagic - Quest|OnStoryCastMagic]](ObjectReference ''akCastingActor'', ObjectReference ''akSpellTarget'', Location ''akLocation'', Form ''akSpell'')'''
|Sent when this quest is started by a cast magic story manager event.
:*Sent when this quest is started by a cast magic story manager event.
|-


|[[OnStoryChangeLocation - Quest|'''OnStoryChangeLocation'''(ObjectReference ''akActor'', Location ''akOldLocation'', Location ''akNewLocation'')]]
:'''[[OnStoryChangeLocation - Quest|OnStoryChangeLocation]](ObjectReference ''akActor'', Location ''akOldLocation'', Location ''akNewLocation'')'''
|Sent when this quest is started by a change location story manager event.
:*Sent when this quest is started by a change location story manager event.
|-


|[[OnStoryCraftItem - Quest|'''OnStoryCraftItem'''(ObjectReference ''akBench'', Location ''akLocation'', Form ''akCreatedItem'')]]
:'''[[OnStoryCraftItem - Quest|OnStoryCraftItem]](ObjectReference ''akBench'', Location ''akLocation'', Form ''akCreatedItem'')'''
|Sent when this quest is started by a craft item story manager event.
:*Sent when this quest is started by a craft item story manager event.
|-


|[[OnStoryCrimeGold - Quest|'''OnStoryCrimeGold'''(ObjectReference ''akVictim'', ObjectReference ''akCriminal'', Faction ''akFaction'', Int ''aiGoldAmount'', Int ''aiCrime'')]]
:'''[[OnStoryCrimeGold - Quest|OnStoryCrimeGold]](ObjectReference ''akVictim'', ObjectReference ''akCriminal'', Faction ''akFaction'', Int ''aiGoldAmount'', Int ''aiCrime'')'''
|Sent when this quest is started by a crime gold story manager event.
:*Sent when this quest is started by a crime gold story manager event.
|-


|[[OnStoryCure - Quest|'''OnStoryCure'''(Form ''akInfection'')]]
:'''[[OnStoryCure - Quest|OnStoryCure]](Form ''akInfection'')'''
|Sent when this quest is started by a cure story manager event.
:*Sent when this quest is started by a cure story manager event.
|-


|[[OnStoryDialogue - Quest|'''OnStoryDialogue'''(Location ''akLocation'', ObjectReference ''akActor1'', ObjectReference ''akActor2'')]]
:'''[[OnStoryDialogue - Quest|OnStoryDialogue]](Location ''akLocation'', ObjectReference ''akActor1'', ObjectReference ''akActor2'')'''
|Sent when this quest is started by a dialogue story manager event.
:*Sent when this quest is started by a dialogue story manager event.
|-


|[[OnStoryDiscoverDeadBody - Quest|'''OnStoryDiscoverDeadBody'''(ObjectReference ''akActor'', ObjectReference ''akDeadActor'', Location ''akLocation'')]]
:'''[[OnStoryDiscoverDeadBody - Quest|OnStoryDiscoverDeadBody]](ObjectReference ''akActor'', ObjectReference ''akDeadActor'', Location ''akLocation'')'''
|Sent when this quest is started by a discover dead body story manager event.
:*Sent when this quest is started by a discover dead body story manager event.
|-


|[[OnStoryEscapeJail - Quest|'''OnStoryEscapeJail'''(Location ''akLocation'', Form ''akCrimeGroup'')]]
:'''[[OnStoryEscapeJail - Quest|OnStoryEscapeJail]](Location ''akLocation'', Form ''akCrimeGroup'')'''
|Sent when this quest is started by an escape jail story manager event.
:*Sent when this quest is started by an escape jail story manager event.
|-


|[[OnStoryFlatterNPC - Quest|'''OnStoryFlatterNPC'''(ObjectReference ''akActor'')]]
:'''[[OnStoryFlatterNPC - Quest|OnStoryFlatterNPC]](ObjectReference ''akActor'')'''
|Sent when this quest is started by a flatter NPC story manager event.
:*Sent when this quest is started by a flatter NPC story manager event.
|-


|[[OnStoryHello - Quest|'''OnStoryHello'''(Location ''akLocation'', ObjectReference ''akActor1'', ObjectReference ''akActor2'')]]
:'''[[OnStoryHello - Quest|OnStoryHello]](Location ''akLocation'', ObjectReference ''akActor1'', ObjectReference ''akActor2'')'''
|Sent when this quest is started by a hello story manager event.
:*Sent when this quest is started by a hello story manager event.
|-


|[[OnStoryIncreaseLevel - Quest|'''OnStoryIncreaseLevel'''(Int ''aiNewLevel'')]]
:'''[[OnStoryIncreaseLevel - Quest|OnStoryIncreaseLevel]](Int ''aiNewLevel'')'''
|Sent when this quest is started by an increase level story manager event.
:*Sent when this quest is started by an increase level story manager event.
|-


|[[OnStoryIncreaseSkill - Quest|'''OnStoryIncreaseSkill'''(String ''asSkill'')]]
:'''[[OnStoryIncreaseSkill - Quest|OnStoryIncreaseSkill]](String ''asSkill'')'''
|Sent when this quest is started by an increase skill story manager event.
:*Sent when this quest is started by an increase skill story manager event.
|-


|[[OnStoryInfection - Quest|'''OnStoryInfection'''(ObjectReference ''akTransmittingActor'', Form ''akInfection'')]]
:'''[[OnStoryInfection - Quest|OnStoryInfection]](ObjectReference ''akTransmittingActor'', Form ''akInfection'')'''
|Sent when this quest is started by an infection story manager event.
:*Sent when this quest is started by an infection story manager event.
|-


|[[OnStoryIntimidateNPC - Quest|'''OnStoryIntimidateNPC'''(ObjectReference ''akActor'')]]
:'''[[OnStoryIntimidateNPC - Quest|OnStoryIntimidateNPC]](ObjectReference ''akActor'')'''
|Sent when this quest is started by an intimidate NPC story manager event.
:*Sent when this quest is started by an intimidate NPC story manager event.
|-


|[[OnStoryJail - Quest|'''OnStoryJail'''(ObjectReference ''akGuard'', Form ''akCrimeGroup'', Location ''akLocation'', Int ''aiCrimeGold'')]]
:'''[[OnStoryJail - Quest|OnStoryJail]](ObjectReference ''akGuard'', Form ''akCrimeGroup'', Location ''akLocation'', Int ''aiCrimeGold'')'''
|Sent when this quest is started by a jail story manager event.
:*Sent when this quest is started by a jail story manager event.
|-


|[[OnStoryKillActor - Quest|'''OnStoryKillActor'''(ObjectReference ''akVictim'', ObjectReference ''akKiller'', Location ''akLocation'', Int ''aiCrimeStatus'', Int ''aiRelationshipRank'')]]
:'''[[OnStoryKillActor - Quest|OnStoryKillActor]](ObjectReference ''akVictim'', ObjectReference ''akKiller'', Location ''akLocation'', Int ''aiCrimeStatus'', Int ''aiRelationshipRank'')'''
|Sent when this quest is started by a kill actor story manager event.
:*Sent when this quest is started by a kill actor story manager event.
|-


|[[OnStoryNewVoicePower - Quest|'''OnStoryNewVoicePower'''(ObjectReference ''akActor'', Form ''akVoicePower'')]]
:'''[[OnStoryNewVoicePower - Quest|OnStoryNewVoicePower]](ObjectReference ''akActor'', Form ''akVoicePower'')'''
|Sent when this quest is started by a new voice power story manager event.
:*Sent when this quest is started by a new voice power story manager event.
|-


|[[OnStoryPickLock - Quest|'''OnStoryPickLock'''(ObjectReference ''akActor'', ObjectReference ''akLock'')]]
:'''[[OnStoryPickLock - Quest|OnStoryPickLock]](ObjectReference ''akActor'', ObjectReference ''akLock'')'''
|Sent when this quest is started by a pick lock story manager event.
:*Sent when this quest is started by a pick lock story manager event.
|-


|[[OnStoryPayFine - Quest|'''OnStoryPayFine'''(ObjectReference ''akCriminal'', ObjectReference ''akGuard'', Form ''akCrimeGroup'', Int ''aiCrimeGold'')]]
:'''[[OnStoryPayFine - Quest|OnStoryPayFine]](ObjectReference ''akCriminal'', ObjectReference ''akGuard'', Form ''akCrimeGroup'', Int ''aiCrimeGold'')'''
|Sent when this quest is started by a pay fine story manager event.
:*Sent when this quest is started by a pay fine story manager event.
|-


|[[OnStoryPlayerGetsFavor - Quest|'''OnStoryPlayerGetsFavor'''(ObjectReference ''akActor'')]]
:'''[[OnStoryPlayerGetsFavor - Quest|OnStoryPlayerGetsFavor]](ObjectReference ''akActor'')'''
|Sent when this quest is started by a player gets favor story manager event.
:*Sent when this quest is started by a player gets favor story manager event.
|-


|[[OnStoryRelationshipChange - Quest|'''OnStoryRelationshipChange'''(ObjectReference ''akActor1'', ObjectReference ''akActor2'', Int ''aiOldRelationship'', Int ''aiNewRelationship'')]]
:'''[[OnStoryRelationshipChange - Quest|OnStoryRelationshipChange]](ObjectReference ''akActor1'', ObjectReference ''akActor2'', Int ''aiOldRelationship'', Int ''aiNewRelationship'')'''
|Sent when this quest is started by a relationship change story manager event.
:*Sent when this quest is started by a relationship change story manager event.
|-


|[[OnStoryRemoveFromPlayer - Quest|'''OnStoryRemoveFromPlayer'''(ObjectReference ''akOwner'', ObjectReference ''akItem'', Location ''akLocation'', Form ''akItembase'', Int ''aiRemoveType'')]]
:'''[[OnStoryRemoveFromPlayer - Quest|OnStoryRemoveFromPlayer]](ObjectReference ''akOwner'', ObjectReference ''akItem'', Location ''akLocation'', Form ''akItembase'', Int ''aiRemoveType'')'''
|Sent when this quest is started by a remove from player story manager event.
:*Sent when this quest is started by a remove from player story manager event.
|-


|[[OnStoryScript - Quest|'''OnStoryScript'''(Keyword ''akKeyword'', Location ''akLocation'', ObjectReference ''akRef1'', ObjectReference ''akRef2'', Int ''aiValue1'', Int ''aiValue2'')]]
:'''[[OnStoryScript - Quest|OnStoryScript]](Keyword ''akKeyword'', Location ''akLocation'', ObjectReference ''akRef1'', ObjectReference ''akRef2'', Int ''aiValue1'', Int ''aiValue2'')'''
|Sent when this quest is started by a script story manager event.
:*Sent when this quest is started by a script story manager event.
|-


|[[OnStoryServedTime - Quest|'''OnStoryServedTime'''(Location ''akLocation'', Form ''akCrimeGroup'', Int ''aiCrimeGold'', Int ''aiDaysJail'')]]
:'''[[OnStoryServedTime - Quest|OnStoryServedTime]](Location ''akLocation'', Form ''akCrimeGroup'', Int ''aiCrimeGold'', Int ''aiDaysJail'')'''
|Sent when this quest is started by a served time story manager event.
:*Sent when this quest is started by a served time story manager event.
|-


|[[OnStoryTrespass - Quest|'''OnStoryTrespass'''(ObjectReference ''akVictim'', ObjectReference ''akTrespasser'', Location ''akLocation'', Int ''aiCrime'')]]
:'''[[OnStoryTrespass - Quest|OnStoryTrespass]](ObjectReference ''akVictim'', ObjectReference ''akTrespasser'', Location ''akLocation'', Int ''aiCrime'')'''
|Sent when this quest is started by a trespass story manager event.
:*Sent when this quest is started by a trespass story manager event.
|-


|}


== Related Fragments ==
== Related Fragments ==
*[[Quest Stage Fragments]]
*[[Quest Stage Fragments]]
[[Category:Scripting]]
[[Category:Papyrus]]
[[Category:Script Objects]]

Revision as of 21:42, 2 February 2014

Extends: Form Script

Script for the manipulation of quests.

Definition

ScriptName Quest extends Form

Member Functions

CompleteAllObjectives()
  • Completes all a quests objectives.
CompleteQuest()
  • Flags this quest as completed.
FailAllObjectives()
  • Flags all quest objects as failed.
Alias GetAlias(Int aiAliasID)
  • Obtains the Alias attached to this quest associated with the specified ID.
Int GetCurrentStageID()
  • Obtains the highest completed stage on this quest.
Int GetStage()
  • Alias for GetCurrentStageID().
Bool GetStageDone(Int aiStage)
  • Alias for IsStageDone().
Bool IsActive()
  • Is this quest "active"? (Tracked by the player).
Bool IsCompleted()
  • Returns whether this quest is completed or not.
Bool IsObjectiveCompleted(Int aiObjective)
  • Obtains whether the specified objective is completed or not.
Bool IsObjectiveDisplayed(Int aiObjective)
  • Obtains whether the specified objective is displayed or not.
Bool IsObjectiveFailed(Int aiObjective)
  • Obtains whether the specified objective is failed or not.
Bool IsRunning()
  • Returns whether this quest is currently running or not.
Bool IsStageDone(Int aiStage)
  • Checks to see if the specified stage is done or not.
Bool IsStarting()
  • Returns whether this quest is currently enabled but not running yet.
Bool IsStopping()
  • Returns whether this quest is currently not enabled anymore but still shutting down.
Bool IsStopped()
  • Returns whether this quest is currently fully stopped.
Bool ModObjectiveGlobal(Float afModValue, GlobalVariable aModGlobal, Int aiObjectiveID, Float afTargetValue, Bool abCountingUp, Bool abCompleteObjective, Bool abRedisplayObjective)
  • Mods a global variable in a threadsafe way. Optional parameters allow automatic redisplay and completion (or failure) of a quest objective using this global variable.
Reset()
  • Resets this quest.
SetActive(Bool abActive)
  • Sets or clears this quest as "active". (Tracked by the player)
Bool SetCurrentStageID(Int aiStageID)
  • Sets the quest to the requested stage, returning true if it succeeded.
SetObjectiveCompleted(Int aiObjective, Bool abCompleted)
  • Sets whether the specified objective is completed or not.
SetObjectiveDisplayed(Int aiObjective, Bool abDisplayed)
  • Sets whether the specified objective is displayed or not.
SetObjectiveFailed(Int aiObjective, Bool abFailed)
  • Sets whether the specified objective is failed or not.
Bool SetStage(Int aiStage)
  • Alias of SetCurrentStageID().
Bool Start()
  • Starts this quest.
Stop()
  • Stops the quest.
Bool UpdateCurrentInstanceGlobal(GlobalVariable aUpdateGlobal)
  • Updates the value for the given global for the quest's current instance.


SKSE Global Functions

Quest GetQuest(String editorID)
  • Returns the Quest with the specified editor id.


SKSE Functions

String GetID()
  • Returns the editor ID of the Quest.
Int GetPriority()
  • Returns the priority of the Quest.
Int GetNumAliases()
  • Returns the number of aliases associated with the Quest.
Alias GetNthAlias(Int index)
  • Returns the specified alias associated with the Quest.
Alias GetAliasByName(String name)
  • Returns the editor ID of the quest.


Events

OnReset()
  • Event received when this quest is started up (either the first time or subsequent times - this will fire in parallel with your startup stage!).
OnStoryActivateActor(Location akLocation, ObjectReference akActor)
  • Sent when this quest is started by an activate actor story manager event.
OnStoryAddToPlayer(ObjectReference akOwner, ObjectReference akContainer, Location akLocation, Form akItemBase, Int aiAcquireType)
  • Sent when this quest is started by an add to player story manager event.
OnStoryArrest(ObjectReference akArrestingGuard, ObjectReference akCriminal, Location akLocation, Int aiCrime)
  • Sent when this quest is started by an arrest story manager event.
OnStoryAssaultActor(ObjectReference akVictim, ObjectReference akAttacker, Location akLocation, Int aiCrime)
  • Sent when this quest is started by an assault actor story manager event.
OnStoryBribeNPC(ObjectReference akActor)
  • Sent when this quest is started by a bribe NPC story manager event.
OnStoryCastMagic(ObjectReference akCastingActor, ObjectReference akSpellTarget, Location akLocation, Form akSpell)
  • Sent when this quest is started by a cast magic story manager event.
OnStoryChangeLocation(ObjectReference akActor, Location akOldLocation, Location akNewLocation)
  • Sent when this quest is started by a change location story manager event.
OnStoryCraftItem(ObjectReference akBench, Location akLocation, Form akCreatedItem)
  • Sent when this quest is started by a craft item story manager event.
OnStoryCrimeGold(ObjectReference akVictim, ObjectReference akCriminal, Faction akFaction, Int aiGoldAmount, Int aiCrime)
  • Sent when this quest is started by a crime gold story manager event.
OnStoryCure(Form akInfection)
  • Sent when this quest is started by a cure story manager event.
OnStoryDialogue(Location akLocation, ObjectReference akActor1, ObjectReference akActor2)
  • Sent when this quest is started by a dialogue story manager event.
OnStoryDiscoverDeadBody(ObjectReference akActor, ObjectReference akDeadActor, Location akLocation)
  • Sent when this quest is started by a discover dead body story manager event.
OnStoryEscapeJail(Location akLocation, Form akCrimeGroup)
  • Sent when this quest is started by an escape jail story manager event.
OnStoryFlatterNPC(ObjectReference akActor)
  • Sent when this quest is started by a flatter NPC story manager event.
OnStoryHello(Location akLocation, ObjectReference akActor1, ObjectReference akActor2)
  • Sent when this quest is started by a hello story manager event.
OnStoryIncreaseLevel(Int aiNewLevel)
  • Sent when this quest is started by an increase level story manager event.
OnStoryIncreaseSkill(String asSkill)
  • Sent when this quest is started by an increase skill story manager event.
OnStoryInfection(ObjectReference akTransmittingActor, Form akInfection)
  • Sent when this quest is started by an infection story manager event.
OnStoryIntimidateNPC(ObjectReference akActor)
  • Sent when this quest is started by an intimidate NPC story manager event.
OnStoryJail(ObjectReference akGuard, Form akCrimeGroup, Location akLocation, Int aiCrimeGold)
  • Sent when this quest is started by a jail story manager event.
OnStoryKillActor(ObjectReference akVictim, ObjectReference akKiller, Location akLocation, Int aiCrimeStatus, Int aiRelationshipRank)
  • Sent when this quest is started by a kill actor story manager event.
OnStoryNewVoicePower(ObjectReference akActor, Form akVoicePower)
  • Sent when this quest is started by a new voice power story manager event.
OnStoryPickLock(ObjectReference akActor, ObjectReference akLock)
  • Sent when this quest is started by a pick lock story manager event.
OnStoryPayFine(ObjectReference akCriminal, ObjectReference akGuard, Form akCrimeGroup, Int aiCrimeGold)
  • Sent when this quest is started by a pay fine story manager event.
OnStoryPlayerGetsFavor(ObjectReference akActor)
  • Sent when this quest is started by a player gets favor story manager event.
OnStoryRelationshipChange(ObjectReference akActor1, ObjectReference akActor2, Int aiOldRelationship, Int aiNewRelationship)
  • Sent when this quest is started by a relationship change story manager event.
OnStoryRemoveFromPlayer(ObjectReference akOwner, ObjectReference akItem, Location akLocation, Form akItembase, Int aiRemoveType)
  • Sent when this quest is started by a remove from player story manager event.
OnStoryScript(Keyword akKeyword, Location akLocation, ObjectReference akRef1, ObjectReference akRef2, Int aiValue1, Int aiValue2)
  • Sent when this quest is started by a script story manager event.
OnStoryServedTime(Location akLocation, Form akCrimeGroup, Int aiCrimeGold, Int aiDaysJail)
  • Sent when this quest is started by a served time story manager event.
OnStoryTrespass(ObjectReference akVictim, ObjectReference akTrespasser, Location akLocation, Int aiCrime)
  • Sent when this quest is started by a trespass story manager event.


Related Fragments