Difference between revisions of "How to read most Bethesda game error logs"

From Nexus Mods Wiki
Jump to: navigation, search
(Details: update)
m (Details)
Line 14: Line 14:
 
The second thing is to realize that the game engine is loading and parsing the contents of plugins in "load order" sequence, though it may process different types of data in different passes through the "load order".  So where an error message doesn't identify the plugin or give a "reference" number, you need to consider that it is probably still processing the last plugin for which you do have a reference.  But it is possible it has progressed to the next one, and a line following may provide the similar clue.  Sometimes it just isn't clear at all and you have to ignore it or guess.
 
The second thing is to realize that the game engine is loading and parsing the contents of plugins in "load order" sequence, though it may process different types of data in different passes through the "load order".  So where an error message doesn't identify the plugin or give a "reference" number, you need to consider that it is probably still processing the last plugin for which you do have a reference.  But it is possible it has progressed to the next one, and a line following may provide the similar clue.  Sometimes it just isn't clear at all and you have to ignore it or guess.
  
In general you aren't going to be able to do anything about the warnings and errors you find in the logs, unless you are prepared to open the mod in game's Construction Kit and perform the surgery necessary to "fix" it.  Your normal recourse is to send the relevant portion of your error log to the mod author so they can provide an "official" patch or update; but in cases where the author has moved on or fails to respond you have to decide to either live with the problems, see if someone on a forum can help, or remove the mod.
+
In general you aren't going to be able to do anything about the warnings and errors you find in the logs, unless you are prepared to open the mod in the game's Construction Kit and perform the surgery necessary to "fix" it.  Your normal recourse is to send the relevant portion of your error log to the mod author so they can provide an "official" patch or update; but in cases where the author has moved on or fails to respond you have to decide to either live with the problems, see if someone on a forum can help, or remove the mod.
  
 
As a guideline, ''any'' "errors" or the more "warnings" a mod generates, the more likely it is causing the problem that sent you looking into the error log in the first place.  However, those coming from the game or DLC plugins are either harmless or have to be "fixed" by an "unofficial patch" file designed for the purpose.
 
As a guideline, ''any'' "errors" or the more "warnings" a mod generates, the more likely it is causing the problem that sent you looking into the error log in the first place.  However, those coming from the game or DLC plugins are either harmless or have to be "fixed" by an "unofficial patch" file designed for the purpose.

Revision as of 23:21, 19 January 2017

Overview

Once you get an error log enabled (which varies by game), you will often find an astonishing number of logged entries. The first thing to understand is that most are "warnings" (if they aren't flagged as "FATAL" or "ERROR" somehow) that the game engine was not able to properly process something. In most instances it will report it ignored or removed a variable or reference, or it didn't execute a script. These did not cause the engine to "break" or stop working through the plugin files.

However, it does mean that something in the mod is not going to work as the creator intended. How severe a problem that causes is unpredictable: but it can range from "unnoticeable" to "CTD" or " 'freeze' in an endless loop".

This article is about how you can identify the source plugin of those messages.

Programs and Tools

  • Any plaintext editor, such as Windows Notepad or Notepad++.

Details

The primary thing you as the user need to understand is how to identify which mod plugin the log messages refer to. Please read the short article Form ID which explains how to get the "mod index" from the "Form/Ref IDs". This appears to hold consistent across the Bethesda line of games based upon the Gamebryo engine. In short the first two characters of a "reference" or "Form or Ref ID" are the "mod index" of the plugin (in your specific "load order") in hexadecimal form.

The second thing is to realize that the game engine is loading and parsing the contents of plugins in "load order" sequence, though it may process different types of data in different passes through the "load order". So where an error message doesn't identify the plugin or give a "reference" number, you need to consider that it is probably still processing the last plugin for which you do have a reference. But it is possible it has progressed to the next one, and a line following may provide the similar clue. Sometimes it just isn't clear at all and you have to ignore it or guess.

In general you aren't going to be able to do anything about the warnings and errors you find in the logs, unless you are prepared to open the mod in the game's Construction Kit and perform the surgery necessary to "fix" it. Your normal recourse is to send the relevant portion of your error log to the mod author so they can provide an "official" patch or update; but in cases where the author has moved on or fails to respond you have to decide to either live with the problems, see if someone on a forum can help, or remove the mod.

As a guideline, any "errors" or the more "warnings" a mod generates, the more likely it is causing the problem that sent you looking into the error log in the first place. However, those coming from the game or DLC plugins are either harmless or have to be "fixed" by an "unofficial patch" file designed for the purpose.

When reporting such errors, you need to take it upon yourself to trim your report down to the "essentials". Do not simply post the log with thousands of lines of warnings no one is going to do anything about. (The forum posts have character limits and people have only so much patience wading through "junk".) Create a copy containing the information at the beginning of the log (as this contains useful version identification and system type data), and then the line above the error line, and the line below it, to provide an error line "set of data" context. Use a blank or dotted line as a separator between "error line data sets". Repeat that pattern for each error message related to the plugin concerned. Also, because someone viewing your edited log file has no way of telling what plugin a "mod index" refers to, add the plugin identification information along with the "mod index" number before the first "error line data set", preferably with a link to the mod download site for positive identification in the event of questions.

When posting your edited log in forums, put it in "Spoiler" tags. (Use the "Special BBCode" button in the Forum "Reply" menu bar as the third icon from the left in the top row, next to and left of the "Font" pick-list field.)

When sending your edited log to an author, pack it into a standard archive format such as a ZIP or 7Zip file. This avoids (or at least warns about) errors in transmission of the contents.

Be sure to retain the original log file in case more information is needed from it later.

References

Nexus wiki articles referred to by this article:

  • <none>



Nexus wiki articles that refer to this article: