Skip to content

Commit

Permalink
Reformatted issues qna
Browse files Browse the repository at this point in the history
  • Loading branch information
@art-from-the-machine
art-from-the-machine committed Sep 2, 2024
1 parent 874af17 commit dead454
Showing 1 changed file with 33 additions and 27 deletions.
60 changes: 33 additions & 27 deletions docs/pages/issues_qna.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,9 @@
### [Discord](https://discord.gg/Q4BJAdtGUE)
<br>

#### SKYRIM : NPCs keep repeating the same line of dialogue
#### Skyrim

##### NPCs keep repeating the same line of dialogue
<details>
<summary>Details</summary>

Expand All @@ -15,7 +17,7 @@ If this only happens occasionally, it is likely because the next voiceline is be
</details>
<br>

#### SKYRIM : Mantella spells have not been added to my inventory
##### Mantella spells have not been added to my inventory
<details>
<summary>Details</summary>

Expand All @@ -25,7 +27,7 @@ Open Skyrim, end all Mantella conversations and unequip the Mantella spell, and
</details>
<br>

#### SKYRIM : Voicelines are being displayed in Mantella.exe but are not being said in-game
##### Voicelines are being displayed in Mantella.exe but are not being said in-game
<details>
<summary>Details</summary>

Expand All @@ -35,7 +37,9 @@ If the above fails, a more unlikely reason for voicelines not playing is if you
</details>
<br>

#### FALLOUT 4 : "Warning: Could not find _mantella__fallout4_folder.txt" in Mantella.exe
#### Fallout 4

##### "Warning: Could not find _mantella__fallout4_folder.txt" in Mantella.exe
<details>
<summary>Details</summary>

Expand All @@ -47,7 +51,7 @@ If you have the required mods installed, then this issue might instead be caused
</details>
<br>

#### FALLOUT 4 : On game load the following message is displayed : "F4SE or SUP_F4SE not properly installed, Mantella will not work correctly"
##### On game load the following message is displayed : "F4SE or SUP_F4SE not properly installed, Mantella will not work correctly"
<details>
<summary>Details</summary>

Expand All @@ -66,23 +70,23 @@ Multiples reasons can cause this issue:
</details>
<br>

#### FALLOUT 4 : Lip sync isn't working at all after adding a new NPC
##### Lip sync isn't working at all after adding a new NPC
<details>
<summary>Details</summary>

Lip files need to be present at launch for the game to register it. Restarting Fallout 4 should correct the issue. The Mantella Mod on the Mod Nexus will cover all the base game and all the main DLCs but any other NPC will need to have a lip file named 00001ED2_1.lip present at launch in its voice type folder in data\Sound\Voice\Mantella.esp
</details>
<br>

#### FALLOUT 4 : The NPC is lip syncing a different line than the one said in game
##### The NPC is lip syncing a different line than the one said in game
<details>
<summary>Details</summary>

This might be caused by an invalid mod file path (ex: a file path pointing to for another game's data folder). Double check the file paths. Please note that there is a known issue in Fallout 4 that causes lip sync to be cut short for longer lines.
</details>
<br>

#### FALLOUT 4 : Every time a conversation is started the notification is : "NPC not added. Please try again after your next response."
##### Every time a conversation is started the notification is : "NPC not added. Please try again after your next response."
<details>
<summary>Details</summary>

Expand All @@ -99,7 +103,7 @@ Multiples reasons can cause this issue:
</details>
<br>

#### FALLOUT 4 : After trying to start a conversation, the notification says "Starting a conversation with NPCNAME", but nothing happens in Fallout 4 or the Mantella console
##### After trying to start a conversation, the notification says "Starting a conversation with NPCNAME", but nothing happens in Fallout 4 or the Mantella console
<details>
<summary>Details</summary>

Expand All @@ -112,7 +116,7 @@ Multiples reasons can cause this issue:
</details>
<br>

#### FALLOUT 4 : The text input menu isn't showing up when the hotkey is pressed after the notification "Awaiting user input for X seconds"
##### The text input menu isn't showing up when the hotkey is pressed after the notification "Awaiting user input for X seconds"
<details>
<summary>Details</summary>

Expand All @@ -125,23 +129,23 @@ Multiples reasons can cause this issue:
</details>
<br>

#### FALLOUT 4 : The Mantella gun & holotape do not get added on load and are not available at the Chem Station in UTILITY
##### The Mantella gun & holotape do not get added on load and are not available at the Chem Station in UTILITY
<details>
<summary>Details</summary>

This is an issue with the way the Mantella esp mod itself has been installed. Please check your Fallout 4 version by right-clicking its exe file in your Fallout 4 folder and going to Properties -> Details . The "File version" should be listed here and it should be 1.10.163.0 (for Fallout 4 desktop) or 1.2.72.0 (for Fallout 4 VR). If you are using VR, there are separate versions of the required mods for SUP_F4SE : [SUP F4SEVR](https://www.nexusmods.com/fallout4/mods/64420). If you are running the mod via the GOG version of Fallout 4, you might encounter issue getting F4Se to load, see [this workaround](https://github.com/ModOrganizer2/modorganizer/issues/1856#issuecomment-1685925528).
</details>
<br>

#### FALLOUT 4 : The NPC subtitles play in-game but no audio can be heard.
##### The NPC subtitles play in-game but no audio can be heard.
<details>
<summary>Details</summary>

Double check the config ini to make sure that the value of `FO4_NPC_response_volume = ` is high enough to be audible. Make sure that the volume of python in Windows Volume mixer is set to an audible level.
</details>
<br>

#### FALLOUT 4 : The mod is enabled but the gun doesn't appear in game at game load
##### The mod is enabled but the gun doesn't appear in game at game load
<details>
<summary>Details</summary>

Expand All @@ -154,15 +158,17 @@ This might be caused by multiple reasons:
</details>
<br>

#### ALL GAMES : 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>
<summary>Details</summary>

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.
</details>
<br>

#### ALL GAMES : RuntimeError('PytorchStreamReader failed reading zip archive: failed finding central directory')
##### RuntimeError('PytorchStreamReader failed reading zip archive: failed finding central directory')
<details>
<summary>Details</summary>

Expand All @@ -172,7 +178,7 @@ A way to check for other corrupted voice models, is to compare the file sizes wi
</details>
<br>

#### ALL GAMES : Loading voice model... xVASynth Error: ('Connection aborted.', RemoteDisconnected('Remote end closed connection without response'))
##### Loading voice model... xVASynth Error: ('Connection aborted.', RemoteDisconnected('Remote end closed connection without response'))
<details>
<summary>Details</summary>

Expand All @@ -182,79 +188,79 @@ If this does not resolve your issue, please share the text found in your xVASynt
</details>
<br>

#### ALL GAMES : NPC 'XYZ' could not be found in skyrim_characters.csv or fallout4_characters.csv
##### NPC 'XYZ' could not be found in skyrim_characters.csv or fallout4_characters.csv
<details>
<summary>Details</summary>

This means that the NPC's name exactly as written in the error message could not be found in the characters.csv. If you are running your game in another language, sometimes the NPC's name in this language does not match up to the English name, causing this error. It might also mean that the character is missing from characters.csv. Please reach out on the Discord's issues channel if this is the case
</details>
<br>

#### ALL GAMES : NPCs only respond with "I can't find the right words at the moment."
##### NPCs only respond with "I can't find the right words at the moment."
<details>
<summary>Details</summary>

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.
</details>
<br>

#### ALL GAMES : Microphone is not picking up sound / exe stuck on "Listening..."
##### Microphone is not picking up sound / exe stuck on "Listening..."
<details>
<summary>Details</summary>

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!
</details>
<br>

#### ALL GAMES : 'NoneType' object has no attribute 'close'
##### 'NoneType' object has no attribute 'close'
<details>
<summary>Details</summary>

This error means that Whisper is unable to find a connected microphone. Please ensure that you have a working microphone plugged in and enabled.
</details>
<br>

#### ALL GAMES : "Invalid start byte" error
##### "Invalid start byte" error
<details>
<summary>Details</summary>

This error occurs when you introduce character symbols that can't be recognized either in MantellaSoftware/config.ini, skyrim_characters.csv or fallout4_characters.csv. Please try re-downloading these files. Note that if you are using Excel to edit the CSV, Excel often likes to corrupt CSVs when saving these files. If you are experiencing issues with Excel, there are free CSV editors available such as [LibreOffice](https://www.libreoffice.org/).
</details>
<br>

#### ALL GAMES : Mantella.exe closes after "VAD filter removed 00:00.000 of audio" statement
##### Mantella.exe closes after "VAD filter removed 00:00.000 of audio" statement
<details>
<summary>Details</summary>

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).
</details>
<br>

#### ALL GAMES : Mantella.exe opens, but does not display any text
##### Mantella.exe opens, but does not display any text
<details>
<summary>Details</summary>

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.
</details>
<br>

#### ALL GAMES : ERROR: xVASynth Error: [WinError 5] Access is denied
##### ERROR: xVASynth Error: [WinError 5] Access is denied
<details>
<summary>Details</summary>

This happens when your antivirus is blocking Mantella.exe from working. Please add Mantella.exe to your safe list or try running as administrator.
</details>
<br>

#### ALL GAMES : Cannot start new conversation after ending previous conversation (conversation ended message)
##### Cannot start new conversation after ending previous conversation (conversation ended message)
<details>
<summary>Details</summary>

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.
</details>
<br>

#### ALL GAMES : RuntimeWarning: Couldn't find ffmpeg or avconv - defaulting to ffmpeg, but may not work
##### RuntimeWarning: Couldn't find ffmpeg or avconv - defaulting to ffmpeg, but may not work
<details>
<summary>Details</summary>

Expand All @@ -264,7 +270,7 @@ You can also download [ffmpeg](https://ffmpeg.org/download.html) and put a copy
</details>
<br>

#### ALL GAMES : Error: [Errno 2] No such file or directory: 'data/skyrim_characters.csv' or 'data/fallout4_characters.csv'
##### Error: [Errno 2] No such file or directory: 'data/skyrim_characters.csv' or 'data/fallout4_characters.csv'
<details>
<summary>Details</summary>

Expand Down

0 comments on commit dead454

Please sign in to comment.