Difference between revisions of "SetStage"

From the Fallout3 GECK Wiki
Jump to navigation Jump to search
imported>Geckbot
m (Robot: Automated text replacement (-\[\[Category:(.*?)Functions\]\] +Category:\1Functions\nCategory:\1Functions (GECK 1.0)))
imported>Yukichigai
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Incomplete}}
'''Syntax:'''
SetStage ''QuestID StageIndex''
'''Example:'''
SetStage MS27 30


Link to TES4 Construction Set Wiki: [http://cs.elderscrolls.com/constwiki/index.php/SetStage SetStage].
Sets the specified quest stage to "Completed", and resolves any of the attached stage items that pass their conditions (runs results, adds to quest log, completes the quest if it should).
 
==Notes==
 
*If the quest is not currently running, SetStage will automatically start it.
 
*If this is the first stage of the quest to be added to the Pip-Boy, the player will receive a "Quest Added" message on screen.
 
*SetStage has no effect if called with a StageIndex that doesn't exist in the specified quest.
 
*When called as part of the quest activated by the "New Game" menu option (CG00 in ''Fallout 3'', VCG00 in ''Fallout: New Vegas'') SetStage automatically exits the player from the Main Menu, transitioning them from [[MenuMode]] to [[GameMode]].
 
*The stage result script will be processed immediately after the SetStage call. The main script containing the SetStage call will be halted until the result script is finished. It is even possible to use the SetStage command inside a stage result script. In this case the new stage result script will run in place of the SetStage command and the old stage result script will continue after the new one has finished. Unlike [[Activate]], it seems that any number of recursive SetStages are allowed (at least 250, tested from the same quest, are possible).


=='''See Also'''==
=='''See Also'''==
Line 8: Line 23:


[[Category:Functions]]
[[Category:Functions]]
[[Category:Functions (GECK 1.0)]]
[[Category:Functions (GECK 1.1)]]
[[Category:Quest Functions]]
[[Category:Quest Functions]]
[[Category:Quest Functions (GECK 1.0)]]
[[Category:Quest Functions (GECK 1.1)]]

Latest revision as of 18:33, 30 September 2011

Syntax:

SetStage QuestID StageIndex 

Example:

SetStage MS27 30 

Sets the specified quest stage to "Completed", and resolves any of the attached stage items that pass their conditions (runs results, adds to quest log, completes the quest if it should).

Notes[edit | edit source]

  • If the quest is not currently running, SetStage will automatically start it.
  • If this is the first stage of the quest to be added to the Pip-Boy, the player will receive a "Quest Added" message on screen.
  • SetStage has no effect if called with a StageIndex that doesn't exist in the specified quest.
  • When called as part of the quest activated by the "New Game" menu option (CG00 in Fallout 3, VCG00 in Fallout: New Vegas) SetStage automatically exits the player from the Main Menu, transitioning them from MenuMode to GameMode.
  • The stage result script will be processed immediately after the SetStage call. The main script containing the SetStage call will be halted until the result script is finished. It is even possible to use the SetStage command inside a stage result script. In this case the new stage result script will run in place of the SetStage command and the old stage result script will continue after the new one has finished. Unlike Activate, it seems that any number of recursive SetStages are allowed (at least 250, tested from the same quest, are possible).

See Also[edit | edit source]

GetStage
GetStageDone