Quest 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