1.0.4 • Published 5 years ago

slug-unity-log-parser v1.0.4

Weekly downloads
3
License
ISC
Repository
github
Last release
5 years ago

SLUG - Unity Log Parser

A (very) simple tool written in rush for parsing Unity3D Engine logs to see player's journey easily within a markdown table. This is not intended to be a production-ready tool, but might come in handy for people who is struggling reading huge logs.

Benefits

It formats each log entry into a markdown table row, without the stack trace bloating. This way you can read the sequence of things happened. It also captures the exceptions with the latest stack call - so you can see what threw the exception.

Sample Data

Below is an example of what Engine.log looks like after exporting as markdown:

WARNING: This log is only for checking out progression easily. You should examine the original Engine.log as well.

ERRORLINECLASS LOG
197931Game ManagerLevel Loaded: MyBeautifulLevel
197931Game ManagerMusic Started: MyBeautifulAudio
197931Escape MenuEscape Menu Instantiated
197860WorldTimeManagerGame Paused
197931Escape MenuEscape Menu Destroyed
ERROR212984MissingReferenceExceptionThe object of type 'MySh*ttyCode' has been destroyed but you are still trying to access it

The Catch

In order to use this tool, you should format your logs (Debug.Log etc.) like this:

Debug.Log("[CLASS NAME] Real Log Message")

Or optionally, you can check out SLUG - Unity Logger which does the same thing, except for writing down [Class Name] manually.

Either way, slug can parse all log messages starting with [ and create a markdown table.

How To Use

Install

To install, run the command

npm i -g slug-unity-log-parser

Usage

To run the app, use slug command with the Engine.log file path

slug path/to/engine.log