Skip to content

Bug reporting

Jump to bottom
Joel Ahlgren edited this page May 28, 2018 · 2 revisions

Before reporting a bug

Some things to check before you report the bug:

  • Is there a newer version of NMM available on the Github releases page? Please check if that version also has the same problem.
  • Has someone already reported the issue? Do a quick search to see if there's any (open or closed) issues before reporting yours.
  • Is the problem related to NMM? We can't help you with games crashing due to mod incompatibilities, lost passwords, etc. Please look to the Nexus Forums for those problems.

Also remember that since NMM isn't officially supported by Nexus anymore, no one is being paid to fix these bugs. Some people still want to help out, so be friendly and try to give as much information as you can so they can help you.

What information is needed in the bug report?

When trying to fix a problem, more information is (almost) always better. Here are some general hints at what you should provide when reporting a bug, and how to get that information.

The problem

You'll need to describe the problem you're seeing, as simply as possible. Even if it seems obvious to you, it could be hard to reproduce for someone else.

  • Problem description
  • Error message(s) shown
  • Steps to reproduce

NMM

  • What version of NMM are you using?
  • Which game are you modifying?
  • What mods are you adding/removing/modifying when the problem occurs? Links to their Nexus page are appreciated.
  • Attach a TraceLog from when the problem occurs.
  • If the game crashes to the desktop instantly, you can check for an error log in Windows' Event Viewer.

How to collect information

Trace Log

While NMM runs it will keep a log of what's being done in the current session. If it crashes it will try to write this log to %USERPROFILE%\Documents\Nexus Mod Manager in the form of a text file called TraceLog<timestamp>.txt. This file will be very useful (often critical) to solving your problem, so make sure to grab it and attach it to your issue.

If the problem you're having doesn't result in a crash, you can still generate the file by:

  • Starting Nexus Mod Manager (Trace Mode), which is a shortcut available in the start menu.
  • Starting NexusClient.exe with the parameter /trace. Then you can perform the steps necessary to reproduce your problem, close NMM, and grab the file from %USERPROFILE%\Documents\Nexus Mod Manager.

Windows' Event Viewer

If NMM crashes completely and is unable to write a Trace Log file, you can hopefully find an error message in Windows' Event Viewer.

The log you're looking for in this case is:

  • Found under Windows Logs -> Application.
  • An Error level log.
  • Has the Source .NET Runtime.
  • Mentions the application NexusClient.exe.

Copy this entire log message and include it in your issue.

Clone this wiki locally