Difference between revisions of "Quest Alias Tab"

Added clarification about "Allow Reuse in Quest". The way the docs were written was confusing and sounded like the first alias filled with a reference needed the option checked, when it's actually the *reusing* alias that needs it checked.
(→‎Checkboxes:: There was contradictory information about the behavior of "Allow Reserved" and Start Game Enabled quests. The notes at the "Allow Reserved" checkbox were correct. Aliases on Start Game Enabled quests that don't explicitly have their "Allow Reserved" checkbox checked with one of the methods listed will not fill with a reserved reference when added to a game in progress. This is arguably a bug in the game, but it is the way it behaves nonetheless.)
(Added clarification about "Allow Reuse in Quest". The way the docs were written was confusing and sounded like the first alias filled with a reference needed the option checked, when it's actually the *reusing* alias that needs it checked.)
 
(One intermediate revision by the same user not shown)
Line 32: Line 32:
*'''Additional Valid Voice Types for Export''': This is used in cases where the alias's Fill Type (see below) does not give the editor enough information to determine what voice types are valid (for example, Location Alias Reference). Select a form list of voice types which the editor uses to limit any dialogue assigned to this alias (on scenes or through the [[GetIsAliasRef]] condition).
*'''Additional Valid Voice Types for Export''': This is used in cases where the alias's Fill Type (see below) does not give the editor enough information to determine what voice types are valid (for example, Location Alias Reference). Select a form list of voice types which the editor uses to limit any dialogue assigned to this alias (on scenes or through the [[GetIsAliasRef]] condition).
===Checkboxes:===
===Checkboxes:===
*'''Reserves Reference''': Once a reference is assigned to a "Reserved" alias, the Story Manager will not fill any other alias with this reference unless:
*'''Reserves Reference''': Once a reference is assigned to a "Reserved" alias by a quest, the game will not fill any other alias with this reference unless:
** A) The new alias is marked "Allow Reserved", or
** A) The new alias is marked "Allow Reserved", or
** B) The new alias is a "From External" fill type.
** B) The new alias is a "From External" fill type.
** C) "Start Game Enabled" quests - all their aliases are treated as if "Allow Reserved" were checked (in order to avoid "race conditions" where the order that the "game start" quests actually fill their aliases matters). However, this may not be true for Start Game Enabled quests that are added to a saved game in progress. See the notes for the "Allow Reserved" checkbox.
** C) "Start Game Enabled" quests - all their aliases are treated as if "Allow Reserved" were checked (in order to avoid "race conditions" where the order that the "game start" quests actually fill their aliases matters). However, this may not be true for Start Game Enabled quests that are added to a saved game in progress. See the notes for the "Allow Reserved" checkbox.
*'''Optional''': If checked, the quest is not required to fill this in order to start. If unchecked, the quest will fail to start if the Story Manager fails to fill this alias.
*'''Optional''': If checked, the quest is not required to fill this in order to start. If unchecked, the quest will fail to start if it cannot fill this alias.
*'''Essential''': Make the actor in this alias Essential while in the alias.
*'''Essential''': Make the actor in this alias Essential while in the alias.
*'''Protected''': Make the actor in this alias Protected while in the alias.
*'''Protected''': Make the actor in this alias Protected while in the alias.
Line 42: Line 42:
** Cannot be dropped or sold by the player. EXCEPTION: Player can place Quest Objects into a container in an alias on the same quest which is ALSO marked as a Quest Object.
** Cannot be dropped or sold by the player. EXCEPTION: Player can place Quest Objects into a container in an alias on the same quest which is ALSO marked as a Quest Object.
** Any container containing a Quest Object cannot be cleaned up (deleted) by the game.
** Any container containing a Quest Object cannot be cleaned up (deleted) by the game.
*'''Allow Reuse in Quest''': Normally, the Story Manager will not fill two aliases on the same quest with the same reference. If "Allow Reuse in Quest", the reference in this alias CAN be placed into another alias on this quest during the startup process.
*'''Allow Reuse in Quest''': Normally, the game will not fill two aliases on the same quest with the same reference. If "Allow Reuse in Quest" is checked, the reference in this alias CAN be placed into another alias on this quest during the startup process.
*'''Allow Dead''': The Story Manager will skip dead actors unless this is checked.
{{WarningBox|This option must be checked on any alias that can be filled with a reference that has already been used, not on the first alias that uses the reference. This option is not required for all [[#Fill type|fill types]]. For example, a Unique Actor fill can target a reference that's already been used even if this option isn't checked.}}
*'''Allow Disabled''': Allows the alias to be filled with a disabled reference.
*'''Allow Dead''': Allows this alias to be filled with a dead actor. If unchecked, the alias will not fill if there are no living actors that match the fill requirements.
*'''Allow Disabled''': Allows the alias to be filled with a disabled reference. If unchecked, the alias will not fill if there are no enabled references that match the fill requirements.
*'''Allow Reserved''': Allows the alias to be filled with a reference which is already in a Reserved alias on another quest. Checking this will resolve some issues with quests failing to initialize because aliases could not be filled.
*'''Allow Reserved''': Allows the alias to be filled with a reference which is already in a Reserved alias on another quest. Checking this will resolve some issues with quests failing to initialize because aliases could not be filled.
**This option is greyed out for Start Game Enabled quests, which consider their aliases to "Allow Reserved" by default when initialized at the beginning of a new game. However, ticking "Allow Reserved" may be required to avoid problems if the Start Game Enabled quest is added to a pre-existing save. To select this option on a Start Game Enabled quest:
**This option is greyed out for Start Game Enabled quests, which consider their aliases to "Allow Reserved" by default when initialized at the beginning of a new game. However, ticking "Allow Reserved" may be required to avoid problems if the Start Game Enabled quest is added to a pre-existing save. To select this option on a Start Game Enabled quest:
56

edits