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 in your Steam library, click
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 and delete these folders:
C:\Users\[Your User Name]\AppData\Roaming\Mannequinon Windows.
~/Library/Application Support/Mannequinon macOS.
After that, launch Mannequin again.
It might seems 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 in your Steam Library View, choose
Properties, and in the window that shows up, look for
Launch Options. Fill the input field with
--debug, and then launch Mannequin again. The
Developer Toolssection will show up alongside the app, and in this section you can switch to
Consoletab 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's installation directory and run Mannequin from the command line with these arguments:
--debug --trace-warnings. The
Developer Toolswill be enabled, and other errors might also shows up in the command line.
We usually won't ask for this unless we somehow cannot replicate the reported bug in our test systems. Currently we have multiple Windows test systems (a desktop, a laptop, and a VM), Linux test systems (Fedora 36-based VMs) and a macOS test sytem (2018 Mac Mini running Monterey). Your help with additional informations regarding bugs that you are experiencing is very useful and greatly appreciated.