diff --git a/docs/pages/issues_qna.md b/docs/pages/issues_qna.md index 28ac820d..513a8a0b 100644 --- a/docs/pages/issues_qna.md +++ b/docs/pages/issues_qna.md @@ -5,69 +5,23 @@ ### [Discord](https://discord.gg/Q4BJAdtGUE)
-#### SKYRIM : NPC not added. Please try again after your next response / [Errno 2] No such file or directory: 'path\to\Skyrim Special Edition/some_text_file.txt' -
-Details - -This is either an issue with the path set for `skyrim_folder` in MantellaSoftware/config.ini, an issue with your Skyrim folder being in Program Files, an issue with the installation of PapyrusUtil, an issue with an incompatible mod, or you are not running Skyrim via SKSE (please see the included readme.txt file in SKSE's downloaded folder for instructions on how to use it). - -Some VR users miss that there is a separate VR version of PapyrusUtil, double check that you have downloaded this version of the mod if you are a VR user (it should be under the Miscellaneous Files section of the Nexus download page). To put it another way, if you have `PapyrusUtil AE SE - Scripting Utility Function` in your modlist, you have the wrong version. - -If you are an SE user, please double check your Skyrim version by right-clicking its exe file in your Skyrim folder and going to Properties -> Details. The "File version" should be listed here. If it is 1.6 or above, you actually have Skyrim AE, not SE (its confusing I know), so please download the AE versions of the required mods. You can tell if PapyrusUtil is working by checking if you have a file called `_mantella__skyrim_folder.txt` in your `skyrim_folder` path. - -If you have the required mods installed, then this issue might instead be caused by the `skyrim_folder` being set incorrectly. This only seems to be an issue for Mod Organizer 2 / Wabbajack modlist users. Some Mod Organizer 2 setups move the text files created by the Mantella spell to another folder. Try searching for a folder called overwrite/root or "Stock Game" in your Mod Organizer 2 / Wabbajack installation path to try to find these Mantella text files, specifically a file called `_mantella__skyrim_folder.txt`. If you find this file, then please set its folder as your `skyrim_folder` path. Specifically for FUS players, there is an odd bug which means you may need to set `skyrim_folder` to your actual Skyrim folder and cast Mantella in-game -> set `skyrim_folder` to your root folder and cast Mantella in-game -> set `skyrim_folder` back to your actual Skyrim folder and the spell should work. - -Note that some versions of the "Campfire" mod that came bundled with an old version of PapyrusUtil.dll. Please ensure Campfire is not overwriting the version of PapyrusUtil you have installed. -
-
- -#### SKYRIM : "Warning: Could not find _mantella__skyrim_folder.txt" in Mantella.exe +#### SKYRIM : NPCs keep repeating the same line of dialogue
Details -This is either an issue with the path set for `skyrim_folder` in MantellaSoftware/config.ini, an issue with the installation of PapyrusUtil, or you are not running Skyrim via SKSE (please see the included readme.txt file in SKSE's downloaded folder for instructions on how to use it). If it is either of the latter two issues an error should display in-game when you cast the spell. - -Some VR users miss that there is a separate VR version of PapyrusUtil, double check that you have downloaded this version of the mod if you are a VR user (it should be under the Miscellaneous Files section of the Nexus download page). To put it another way, if you have `PapyrusUtil AE SE - Scripting Utility Function` in your modlist, you have the wrong version. - -If you are an SE user, please double check your Skyrim version by right-clicking its exe file in your Skyrim folder and going to Properties -> Details. The "File version" should be listed here. If it is 1.6 or above, you actually have Skyrim AE, not SE (its confusing I know), so please download the AE versions of the required mods. You can tell if PapyrusUtil is working by checking if you have a file called `_mantella__skyrim_folder.txt` in your `skyrim_folder` path. +If you are experiencing this issue with no changes in dialogue than this is likely a permissions issue with Mantella accessing your Skyrim folder. If your Skyrim folder is installed in Program Files, please move it to a [different folder](https://art-from-the-machine.github.io/Mantella/pages/installation.html#skyrim). -If you have the required mods installed, then this issue might instead be caused by the `skyrim_folder` being set incorrectly. This only seems to be an issue for Mod Organizer 2 / Wabbajack modlist users. Some Mod Organizer 2 setups move the text files created by the Mantella spell to another folder. Try searching for a folder called overwrite/root or "Stock Game" in your Mod Organizer 2 / Wabbajack installation path to try to find these Mantella text files, specifically a file called `_mantella__skyrim_folder.txt`. If you find this file, then please set its folder as your `skyrim_folder` path. +If this only happens occasionally, it is likely because the next voiceline is being activated before the voiceline file is ready. You can mitigate this by increasing the value of `Wait Time Buffer` in the `Large Language Model -> Advanced` tab in the [Mantella UI](https://art-from-the-machine.github.io/Mantella/pages/installation.html#mantella-ui).

-#### SKYRIM : "There is an error with your PapyrusUtil installation" when spell is cast +#### SKYRIM : Mantella spells have not been added to my inventory
Details -This is either an issue with the installation of PapyrusUtil, or you are not running Skyrim via SKSE (please see the included readme.txt file in SKSE's downloaded folder for instructions on how to use it). - -Some VR users miss that there is a separate VR version of PapyrusUtil, double check that you have downloaded this version of the mod if you are a VR user (it should be under the Miscellaneous Files section of the Nexus download page). To put it another way, if you have `PapyrusUtil AE SE - Scripting Utility Function` in your modlist, you have the wrong version. - -If you are an SE user, please double check your Skyrim version by right-clicking its exe file in your Skyrim folder and going to Properties -> Details. The "File version" should be listed here. If it is 1.6 or above, you actually have Skyrim AE, not SE (its confusing I know), so please download the AE versions of the required mods. You can tell if PapyrusUtil is working by checking if you have a file called `_mantella__skyrim_folder.txt` in your `skyrim_folder` path. -
-
- -#### SKYRIM : "There is an error with your installation of Mantella (or one of its dependent mods)" when spell is cast -
-Details +This is an issue with the way the Mantella mod has been installed. Please ensure any previous versions of Mantella have been completely removed before installing the new version: -Please double check your Skyrim version by right-clicking its exe file in your Skyrim folder and going to Properties -> Details. The "File version" should be listed here. Mantella's required mods must match your Skyrim version, or else they won't work. Note that there have recently (end of 2023) been updates to Skyrim, which either requires new versions of many mods to be installed. You can also downgrade your Skyrim version (it is best to search online on how to do so). -
-
- -#### SKYRIM : NPCs keep repeating the same line of dialogue -
-Details - -This is an issue with `mod_folder` not being set to the correct path in MantellaSoftware/config.ini. If you are using Mod Organizer 2, you can find the correct path by right-clicking the Mantella mod in the Mod Organizer 2 UI and selecting "Open in Explorer". If you are using Vortex, you should instead set this `mod_folder` path to your Skyrim/Data folder. -
-
- -#### SKYRIM : No message box displayed to say spell has been added / Mantella spell is not in spell inventory -
-Details - -This is an issue with the way the spell mod itself has been installed. Please check your Skyrim version by right-clicking its exe file in your Skyrim folder and going to Properties -> Details. The "File version" should be listed here. If it is 1.6 or above, you have Skyrim AE. If it is below 1.6, you have Skyrim SE. If you are using VR, there are separate versions of the required mods for VR (PapyrusUtil tends to catch out a lot of VR users, the VR version of this file is under "Miscellaneous Files" on the download page). If you are running the mod via the GOG version of Skyrim, there are slight differences in setting up a mod manager as discussed in [this tutorial](https://www.youtube.com/watch?v=EJYddISZdeo). +Open Skyrim, end all Mantella conversations and unequip the Mantella spell, and create a save. In your mod manager, disable the old Mantella mod. Open your newly created save and create another save (now with no Mantella mod). Finally, in your mod manager enable the new Mantella mod. This should effectively "reset" the mod. When you next open your recent save, you should see a notification that the Mantella spell has been added to your inventory.

@@ -77,16 +31,7 @@ This is an issue with the way the spell mod itself has been installed. Please ch Try creating a save and then reloading that save. This ensures that the Mantella voice files get registered correctly. -If the above fails, a more unlikely reason for voicelines not playing is if you have updated the Mantella spell with a more recent version by replacing files in the mod's folder. If this is the case, open Skyrim, end all Mantella conversations and unequip the Mantella spell, and create a save. In your mod organizer, disable the Mantella spell plugin. Open your newly created save and create another save (now with no Mantella mod). Finally, in your mod organizer re-enable the Mantella spell plugin. This should effectively "reset" the mod. When you next open your recent save, you should see a notification that the Mantella spell has been added to your inventory. - -
- -#### SKYRIM : 'Starting conversation with' without the NPC name is displayed in game and nothing happens after -
-Details - -Make sure Skyrim Script Extender (SKSE) is started before Skyrim itself. -[SKSE ReadME](https://skse.silverlock.org/skse_readme.txt) +If the above fails, a more unlikely reason for voicelines not playing is if you have updated the Mantella mod with a more recent version by replacing files in the mod's folder. If this is the case, open Skyrim, end all Mantella conversations and unequip the Mantella spell, and create a save. In your mod manager, disable the old Mantella mod. Open your newly created save and create another save (now with no Mantella mod). Finally, in your mod manager enable the new Mantella mod. This should effectively "reset" the mod. When you next open your recent save, you should see a notification that the Mantella spell has been added to your inventory.

@@ -209,11 +154,11 @@ This might be caused by multiple reasons:
-#### ALL GAMES : ChatGPT API Error: cannot access local variable 'audio_file' where it is not associated with a value +#### ALL GAMES : API Error: cannot access local variable 'audio_file' where it is not associated with a value
Details -This error occurs when something has failed in a previous step (likely an issue with xVASynth / not having FaceFXWrapper installed). Please check your MantellaSoftware/logging.log file to see the error which occurred before this, which should provide more clarification. If you are still ensure, please share your logging.log file to the Discord's issues channel. +This error occurs when something has failed in a previous step (likely an issue with xVASynth / not having FaceFXWrapper installed). Please check your Documents/My Games/Mantella/logging.log file to see the error which occurred before this, which should provide more clarification. If you are still ensure, please share your logging.log file to the Discord's issues channel.

@@ -221,7 +166,7 @@ This error occurs when something has failed in a previous step (likely an issue
Details -If an xVASynth voice model is corrupted, this error will display in MantellaSoftware/logging.log. Please re-download the voice model in this case. You may alternatively need to redownload xVASynth. +If an xVASynth voice model is corrupted, this error will display in Documents/My Games/Mantella/logging.log. Please re-download the voice model in this case. You may alternatively need to redownload xVASynth. A way to check for other corrupted voice models, is to compare the file sizes within /models/skyrim/ folder of xVASynth. If they diverge from the norms, redownload **just** those. The norms for voice model sizes are **~54 MB** and/or **~90 MB** (v2 voice models) & **~220 MB** or **~260 MB** (v3 voice models).
@@ -231,7 +176,7 @@ A way to check for other corrupted voice models, is to compare the file sizes wi
Details -If this xVASynth Error occurs after the "Loading voice model..." message (as can be seen in your MantellaSoftware/logging.log file), this is likely an issue with a corrupted voice model. Please try redownloading the model from [here](https://www.nexusmods.com/skyrimspecialedition/mods/44184) for Skyrim or [here](https://www.nexusmods.com/fallout4/mods/49340) for Fallout 4. If you have `use_cleanup` enabled, try setting this value to 0 in MantellaSoftware/config.ini. +If this xVASynth Error occurs after the "Loading voice model..." message (as can be seen in your Documents/My Games/Mantella/logging.log file), this is likely an issue with a corrupted voice model. Please try redownloading the model from [here](https://www.nexusmods.com/skyrimspecialedition/mods/44184) for Skyrim or [here](https://www.nexusmods.com/fallout4/mods/49340) for Fallout 4. If you have `use_cleanup` enabled, try setting this value to 0 in MantellaSoftware/config.ini. If this does not resolve your issue, please share the text found in your xVASynth/server.log file on the [Discord's #issues channel](https://discord.gg/Q4BJAdtGUE) for further support.
@@ -249,7 +194,7 @@ This means that the NPC's name exactly as written in the error message could not
Details -This either means the ChatGPT servers are currently down or the API key has not been set up correctly / is missing payment information. If it is the latter issue, please check MantellaSoftware/logging.log to see the exact error. +This either means the LLM servers you have connected to are currently down or the API key has not been set up correctly / is missing payment information. If it is the latter issue, please check Documents/My Games/Mantella/logging.log to see the exact error.

@@ -257,7 +202,7 @@ This either means the ChatGPT servers are currently down or the API key has not
Details -Make sure that your mic is picking up correctly on other software and that it is set as your default. For example, you can go to User Settings -> Voice & Video on Discord to test your mic. Otherwise, try adjusting the `audio_threshold` setting in MantellaSoftware/config.ini (instructions on how to do so are included in config.ini). If all else fails, make sure that no other microphones are plugged in except the one you want to use. There may be a rogue microphone such as a webcam picking up as your default! +Make sure that your mic is picking up correctly on other software and that it is set as your default. For example, you can go to User Settings -> Voice & Video on Discord to test your mic. Otherwise, try adjusting the `Audio Threshold` setting under the `Speech-to-Text` tab of the [Mantella UI](https://art-from-the-machine.github.io/Mantella/pages/installation.html#mantella-ui) (following the instructions provided for that setting). If all else fails, make sure that no other microphones are plugged in except the one you want to use. There may be a rogue microphone such as a webcam picking up as your default!

@@ -281,7 +226,7 @@ This error occurs when you introduce character symbols that can't be recognized
Details -This is an issue related to CUDA. Please try setting `process_device` to "cpu". +This is an issue related to CUDA. Please try setting `Process Device` to "cpu" under the `Speech-to-Text -> Advanced` tab of the [Mantella UI](https://art-from-the-machine.github.io/Mantella/pages/installation.html#mantella-ui).

@@ -289,7 +234,7 @@ This is an issue related to CUDA. Please try setting `process_device` to "cpu".
Details -Ensure that you are not running Mantella.exe via a Vortex / Mod Organizer 2 shortcut, as this does not start the program properly. +Ensure that you are not running Mantella.exe via a Vortex / Mod Organizer 2 shortcut, as this does not start the program properly. Otherwise, it may take some time to start when running for the first time.

@@ -301,11 +246,11 @@ This happens when your antivirus is blocking Mantella.exe from working. Please a
-#### ALL GAMES :Cannot start new conversation after ending previous conversation (conversation ended message) +#### ALL GAMES : Cannot start new conversation after ending previous conversation (conversation ended message)
Details -You might need to say something in the mic for Mantella.exe to realize that the conversation has ended (while it is on "Listening..." it does not look out for the conversation ending). The exe will check if the conversation has ended after 30 seconds by default. You can change this via the `listen_timeout`` setting in MantellaSoftware/config.ini, but just keep in mind if it is too short this will effect conversations as the exe will occasionally stop listening for mic input to check if the conversation has ended +You might need to say something in the mic / type something in the text box for Mantella to realize that the conversation has ended (while it is on "Listening..." / "Waiting for player input..." it does not actively look out for the conversation ending). It is best to end conversations by simply saying / typing "goodbye" to avoid this issue.

@@ -321,6 +266,6 @@ xVASynth related warning when started by Mantella. Thus far has not impacted Man
Details -This may be caused by `Mantella.exe` being ran through MO2 or Vortex. `Mantella.exe` must be started through Windows explorer like any other executable file. +This may be caused by `Mantella.exe` being ran through MO2 or Vortex. `Mantella.exe` will start itself automatically when you start the game.

\ No newline at end of file