Skip to main content

Troubleshooting

The first thing that you should do if Mannequin completely breaks is of course contacting us either via Steam Community Forum, itch.io Community Forum, Mannequin's Discord Server, our Twitter account, or our e-mail. However, below are some easy-to-do fixes that often helps (these solutions usually apply to problems that is not reproducible by us developers):

Verify Integrity of Software Files (Steam)​

To do this, right-click Mannequin Character Generator in your Steam library, click Properties, open Local Files tab, and then click Verify integrity of software files button. Steam will verify if there are missing/corrupt files present, and try to re-download those files again.

Delete User Preferences​

To do this, close Mannequin Character Generator and delete these folders:

  • C:\Users\[Your User Name]\AppData\Roaming\Mannequin on Windows.
  • ~/.config/Mannequin on Linux.
  • ~/Library/Application Support/Mannequin on macOS.

After that, launch Mannequin Character Generator again.

Reinstall​

It might seem stupid but it has proven to work multiple times.

Getting More Error Details​

We try our best to display any errors on-screen with the option to copy the error message for easier reporting. However, sometimes the displayed error message is not enough for us to determine the exact problem so here's some additional steps to get more error details:

  • Right-click Mannequin Character Generator in your Steam Library View, choose Properties, and in the window that shows up, look for Launch Options. Fill the input field with --debug-mode, and then launch Mannequin Character Generator again. The Developer Tools section will show up alongside the app, and in this section you can switch to Console tab to find any error messages (colored in red).
  • Even better, if you are familiar with the use of command line (Command Prompt/PowerShell/Terminal), you can navigate to Mannequin Character Generator's installation directory and run Mannequin Character Generator from the command line with these arguments: --debug-mode --trace-warnings. The Developer Tools will be enabled, and other errors might also shows up in the command line.

Linux: Fixing Save Dialog Bugs​

We have identified a bug that affects all save dialogs (both saving file and exporting file) in some distro. What happens: When you click the 'Save' button at the bottom of the dialog window, nothing happened as if 'Cancel' button is pressed instead. For now it appears that this issue happens with Debian-based distros (first reported by Q4OS user, then tested on base Debian). Fedora and Arch seems to be unaffected (tested on Fedora 44 KDE and CachyOS Handheld Edition).

As a temporary workaround, you can head to Preferences and enable Don't Use OS Save Dialog toggle. When this is enabled, all save operations will use folder select dialog instead, and the filename will be what's displayed on the corresponding tab in Mannequin (i.e. New Character 1 will be saved as New Character 1.mqn and exported to PNG as New Character 1.png).