Quest Script

Extends: Form Script

Script for the manipulation of quests.

Definition

ScriptName Quest extends Form

Properties

None

Global Functions

None

Member Functions

Function CompleteAllObjectives()

• Completes all a quests objectives.

Function CompleteQuest()

• Flags this quest as completed.

Function FailAllObjectives()

• Flags all quest objects as failed.

Alias Function GetAlias(int aiAliasID)

• Obtains the Alias attached to this quest associated with the specified ID.

int Function GetCurrentStageID()

• Obtains the highest completed stage on this quest.

int Function GetStage()

• Alias for GetCurrentStageID().

bool Function GetStageDone(int aiStage)

• Alias for IsStageDone().

bool Function IsActive()

• Is this quest "active"? (Tracked by the player).

bool Function IsCompleted()

• Returns whether this quest is completed or not.

bool Function IsObjectiveCompleted(int aiObjective)

• Obtains whether the specified objective is completed or not.

bool Function IsObjectiveDisplayed(int aiObjective)

• Obtains whether the specified objective is displayed or not.

bool Function IsObjectiveFailed(int aiObjective)

• Obtains whether the specified objective is failed or not.

bool Function IsRunning()

• Returns whether this quest is currently running or not.

bool Function IsStageDone(int aiStage)

• Checks to see if the specified stage is done or not.

bool Function IsStarting()

• Returns whether this quest is currently enabled but not running yet.

bool Function IsStopping()

• Returns whether this quest is currently not enabled anymore but still shutting down.

bool Function IsStopped()

• Returns whether this quest is currently fully stopped.

bool Function 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.

Function Reset()

• Resets this quest.

Function SetActive(bool abActive)

• Sets or clears this quest as "active". (Tracked by the player)

bool Function SetCurrentStageID(int aiStageID)

• Sets the quest to the requested stage, returning true if it succeeded.

Function SetObjectiveCompleted(int aiObjective, bool abCompleted)

• Sets whether the specified objective is completed or not.

Function SetObjectiveDisplayed(int aiObjective, bool abDisplayed)

• Sets whether the specified objective is displayed or not.

Function SetObjectiveFailed(int aiObjective, bool abFailed)

• Sets whether the specified objective is failed or not.

bool Function SetStage(int aiStage)

• Alias of SetCurrentStageID().

bool Function Start()

• Starts this quest.

Function Stop()

• Stops the quest.

bool Function UpdateCurrentInstanceGlobal(GlobalVariable aUpdateGlobal)

• Updates the value for the given global for the quest's current instance.

Events

• Event 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!).

These events are fired in parallel with the quest's startup stage, and are only fired if this quest is started by a story manager event.

• Event OnStoryActivateActor(Location akLocation, ObjectReference akActor)
  • Sent when this quest is started by an activate actor story manager event.
• 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.
• Event OnStoryArrest(ObjectReference akArrestingGuard, ObjectReference akCriminal, Location akLocation, int aiCrime)
  • Sent when this quest is started by an arrest story manager event.
• Event OnStoryAssaultActor(ObjectReference akVictim, ObjectReference akAttacker, Location akLocation, int aiCrime)
  • Sent when this quest is started by an assault actor story manager event.
• Event OnStoryBribeNPC(ObjectReference akActor)
  • Sent when this quest is started by a bribe NPC story manager event.
• Event OnStoryCastMagic(ObjectReference akCastingActor, ObjectReference akSpellTarget, Location akLocation, Form akSpell)
  • Sent when this quest is started by a cast magic story manager event.
• Event OnStoryChangeLocation(ObjectReference akActor, Location akOldLocation, Location akNewLocation)
  • Sent when this quest is started by a change location story manager event.
• Event OnStoryCraftItem(ObjectReference akBench, Location akLocation, Form akCreatedItem)
  • Sent when this quest is started by a craft item story manager event.
• 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.
• Event OnStoryCure(Form akInfection)
  • Sent when this quest is started by a cure story manager event.
• Event OnStoryDialogue(Location akLocation, ObjectReference akActor1, ObjectReference akActor2)
  • Sent when this quest is started by a dialogue story manager event.
• Event OnStoryDiscoverDeadBody(ObjectReference akActor, ObjectReference akDeadActor, Location akLocation)
  • Sent when this quest is started by a discover dead body story manager event.
• Event OnStoryEscapeJail(Location akLocation, Form akCrimeGroup)
  • Sent when this quest is started by an escape jail story manager event.
• Event OnStoryFlatterNPC(ObjectReference akActor)
  • Sent when this quest is started by a flatter NPC story manager event.
• Event OnStoryHello(Location akLocation, ObjectReference akActor1, ObjectReference akActor2)
  • Sent when this quest is started by a hello story manager event.
• Event OnStoryIncreaseLevel(int aiNewLevel)
  • Sent when this quest is started by an increase level story manager event.
• Event OnStoryIncreaseSkill(string asSkill)
  • Sent when this quest is started by an increase skill story manager event.
• Event OnStoryInfection(ObjectReference akTransmittingActor, Form akInfection)
  • Sent when this quest is started by an infection story manager event.
• Event OnStoryIntimidateNPC(ObjectReference akActor)
  • Sent when this quest is started by an intimidate NPC story manager event.
• Event OnStoryJail(ObjectReference akGuard, Form akCrimeGroup, Location akLocation, int aiCrimeGold)
  • Sent when this quest is started by a jail story manager event.
• 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.
• Event OnStoryNewVoicePower(ObjectReference akActor, Form akVoicePower)
  • Sent when this quest is started by a new voice power story manager event.
• Event OnStoryPickLock(ObjectReference akActor, ObjectReference akLock)
  • Sent when this quest is started by a pick lock story manager event.
• Event OnStoryPayFine(ObjectReference akCriminal, ObjectReference akGuard, Form akCrimeGroup, int aiCrimeGold)
  • Sent when this quest is started by a pay fine story manager event.
• Event OnStoryPlayerGetsFavor(ObjectReference akActor)
  • Sent when this quest is started by a player gets favor story manager event.
• Event OnStoryRelationshipChange(ObjectReference akActor1, ObjectReference akActor2, int aiOldRelationship, int aiNewRelationship)
  • Sent when this quest is started by a relationship change story manager event.
• 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.
• 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.
• Event OnStoryServedTime(Location akLocation, Form akCrimeGroup, int aiCrimeGold, int aiDaysJail)
  • Sent when this quest is started by a served time story manager event.
• Event OnStoryTrespass(ObjectReference akVictim, ObjectReference akTrespasser, Location akLocation, int aiCrime)
  • Sent when this quest is started by a trespass story manager event.

Related Fragments

• Quest Stage Fragments