Difference between revisions of "SetStage"

From the Oblivion ConstructionSet Wiki
Jump to navigation Jump to search
imported>Morris
(Corrected my comment)
imported>Vswe
m (Added Search Terms)
 
(2 intermediate revisions by one other user not shown)
Line 6: Line 6:
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).  
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==
'''Notes:'''


*If this is the first stage of the quest to be added to the journal, the player will receive a "Quest Added" message on screen.  
*If this is the first stage of the quest to be added to the journal, the player will receive a "Quest Added" message on screen.  
Line 18: Line 17:


*It is NOT possible to define variables inside a stage result script! The script will compile, but the variables will always be 0.
*It is NOT possible to define variables inside a stage result script! The script will compile, but the variables will always be 0.
*But it is very useful to set them here.  If there is an invalid reference involved, the stage result script will be entirely ignored, but the stage will be set w/o an error.  This allows you to see if something is installed / available.  Better explanation: [[Combine your SI and non-SI mods into one (OBSE, Patch v1.1, Other mods too)]]


==See Also==  
==See Also==  
[[GetStage]]
*[[GetStage]]
 
*[[GetStageDone]]  
[[GetStageDone]]  
   
   


Line 31: Line 28:
[[Category: Quest Functions]]
[[Category: Quest Functions]]
[[Category: Quest Functions (CS 1.0)]]
[[Category: Quest Functions (CS 1.0)]]
<!-- Begin Search Terms
Set
Stage
End Search Terms -->

Latest revision as of 15:55, 20 June 2008

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 this is the first stage of the quest to be added to the journal, the player will receive a "Quest Added" message on screen.
  • If the quest is not currently running, SetStage will automatically start it.
  • Always remember that Setstage only accepts stages that are defined in the quest's "Quest Stages" tab. When you try to set a quest stage that isn't defined, the stage-index doesn't change at all.
  • 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).
  • It is NOT possible to define variables inside a stage result script! The script will compile, but the variables will always be 0.

See Also[edit | edit source]