Editing Arcane University:Implementation Troubleshooting Reference

{{Trail|Implementation}}

This page can be used to troubleshoot any kinds of issues that you encounter during implementation.

Usually there are various different aspects that can cause certain issues, which is why a list of possible solutions to check for are presented.

= Before you do anything else =

'''If you are making a quest, check that your quest is actually running.''' You can achieve this with the <code>sqv</code> console command, which takes the editor ID of the quest as a parameter. For example, the Bendu Olo tutorial on the Creation Kit wiki names the quest <code>GSQ01</code>, so ''for that quest'' the command would be <code>sqv gsq01</code>. You will need to replace <code>gsq01</code> with the editor ID of your quest, if it is different.

'''Start Game Enabled quests have unusual behavior with this command.''' For most quests, if the output of <code>sqv</code> says the quest is running, then it is running. However, Start Game Enabled quests ''always'' say they are running, even if they actually aren't.

* If the quest is Start Game Enabled...
**If at least one of the quest aliases is filled, or '''all''' of the aliases are optional, then the quest is running
**If all of the aliases are unfilled (they say <code>NONE</code> beside their name), and any of the aliases is required, the quest is '''not''' running. Proceed to [[#Quest doesn't start|Quest doesn't start]] for troubleshooting.
* If the quest is ''not'' Start Game Enabled...
**If the output of the <code>sqv</code> command says the quest is running, then it is running.
**If the output of the <code>sqv</code> command says <code>Stopped</code>, proceed to [[#Quest doesn't start|Quest doesn't start]] for troubleshooting.


=Quest=

===Quest doesn't start===
* Check that your aliases fill correctly (using the sqv console command to check which aliases are filled & temporarily flagging all aliases as optional in case the quest doesn’t start to confirm which aliases don’t fill exactly)
** <div id="AliasNotFilling"></div>The alias that doesn’t fill is filled via...
*** '''Specific Reference:''' Make sure the reference isn’t disabled, use “Allow Disabled” in this case
*** '''Unique Actor:''' Make sure the placed actor ref has a persistence location
** Make sure the aliases are not reserved elsewhere, use the “Allow Reserved” flag in this case
** Make sure your alias doesn’t reference aliases in its “Fill Type” that are listed down below your alias in the quest
* If the quest is a start game enabled, try pressing F5 for quicksave and F9 for quickload and see if it works now. This means the [[Arcane_University:Seq_Guide|SEQ]] file needs to be updated.
* If your quest is a story manager event quest:
** Make sure your quest is considered to start, there might be other quests in the story manager tree that don’t use “Shares Event” and consume the whole event without giving your quest even the opportunity to start
** Enable the SM log via ini tweaks and check if your quest shows up there
** Remove the event from the quest and check if it starts via the startgame command

==Quest Objective shows [...] for Text Replacement==
* If your text is supposed to show an alias
** Make sure the alias and the text replacement bit have the same name
** Make sure the alias is filled using sqv (If it doesn’t fill, check [[#AliasNotFilling|here]])
** Make sure the alias uses the “Stores Text” and "Uses Stored Text" flags
* If your text is supposed to show a Global Variable
** Make sure the name of the global matches the reference in the objective
** Make sure the global is added to the quest global list on the “Quest Data” tab

=Dialogue=

==Dialogue doesn’t show up==
* Check the quest with your dialogue is running (see section Quest doesn’t start [[Arcane_University:Implementation_Troubleshooting_Reference#Quest_doesn.27t_start|here]], especially the part about start game enabled quests)
* Ensure the conditions on your starting topic are valid (Temporarily remove all conditions but the speaker condition to be sure)
* Does the actor show up as speaker in any one of the responses? If not, the conditions are not valid.
* Does the actor who should speak have a voice type assigned?
* Is other dialogue playing instead? Maybe the other dialogue is blocking your dialogue due to higher dialogue and/or quest priority


=Package=

==Package doesn’t work==
* Make sure the package is actually running (Use [https://www.nexusmods.com/skyrimspecialedition/mods/19250 More Informative Console] to check)
* Make sure navmesh is available where the package is running, you can use the navmesh test tool for that
* If the package is attached to a quest alias, makes sure the quest is running
* If the quest has an “owning quest” set - make sure you only use it in scenes or on quest aliases in that quest.
* Make sure the NPC is persistent where it should run the package (via quest alias or persistence location)

==UseWeapon doesn’t work / NPC doesn’t hit==
* Check if the NPC has an attack race set. It should usually be equivalent to the race of the NPC itself. You may want to check in xEdit to be sure.

=NPC=

==Merchant doesn’t sell==
* Ensure they are in the main JobMerchantFaction and in a specialized Job faction
* Do they have a Services faction that has the vendor feature enabled?
** Is it currently inside the start and end hours? Is the start hour smaller than the end hour?
** Are they in the location and radius of their vendor location?
* Do they have a default voice type assigned?


=Book=

==Book shows [...] for Text Replacement==
* If your text is supposed to show an alias
** Make sure you’ve at least once filled this book to an alias with the flags “Stores Text” and "Uses Stored Text". You can do this either by:
*** Creating the book object in the alias
*** [https://ck.uesp.net/wiki/ForceRefTo_-_ReferenceAlias Force] the book reference to an alias


=Misc=

==Player is always trespassing in interior==
* Make sure the package they use has an unlock door procedure and the variable “Unlock on arrival” is set to true (usually that's part of a sandbox package)
* Make sure the cell has a lock list and owner faction and is not set to “Off Limits”
* Make sure the cell door is locked