Larian Studios

Osiris debug log tool

Posted By: Norbyte

Osiris debug log tool - 03/02/18 08:59 PM

Currently the game doesn't have any debug logs, so if something works in the editor but doesn't work ingame it is quite difficult to debug. I've created a tool that generates Osiris debug logs from the game itself, similar to osirislog.log in the Divinity Engine.

Download (v1.0.1): https://s3.eu-central-1.amazonaws.com/nb-stor/dos/OsirisProxy-1.0.1.zip
Source: https://github.com/Norbyte/ositools

Usage
=====
- Extract the zip file to the game's Bin directory (eg. C:\Program Files (x86)\Steam\steamapps\common\Divinity Original Sin 2\Bin).
- Start the game (either via EoCApp.exe or via Steam); the logger will start automatically and an additional (debug) console window will be shown if all is well
- Osiris game logs will be saved to the My Documents\OsirisLogs\ directory. If you'd like to save the logs somewhere else, change the LogDirectory value in OsirisProxy.json.

To remove the logger from the game just delete DXGI.dll from the Bin directory.
Posted By: Ameranth

Re: Osiris debug log tool - 03/02/18 10:37 PM

Many thanks for this, Norbyte, I look forward to putting it to use smile
Posted By: BloodyWorth

Re: Osiris debug log tool - 03/02/18 11:04 PM

Amazing, love you long time ! ♥
Posted By: Windemere

Re: Osiris debug log tool - 03/02/18 11:07 PM

This is going to be a huge help when testing, thanks so much.
Posted By: LaughingLeader

Re: Osiris debug log tool - 14/03/18 01:53 AM

Hey Norbyte. Thanks for making this. I finally got out of the editor today to test some mods in-game, and starting DOS2 with the debug log returns the error "Could not locate global Osiris variables". Perhaps this is from the latest update shifting a few things around?
Posted By: Norbyte

Re: Osiris debug log tool - 16/03/18 05:26 PM

Yeah, the offsets probably changed a bit. I'll take a look at it tomorrow.
Posted By: Norbyte

Re: Osiris debug log tool - 18/03/18 02:15 PM

Updated version with support for the latest update (v3.0.180.158): https://s3.eu-central-1.amazonaws.com/nb-stor/dos/OsirisProxy-1.0.2.zip
Posted By: Windemere

Re: Osiris debug log tool - 19/03/18 02:25 AM

Thanks for the continued support, Norbyte!
Posted By: LaughingLeader

Re: Osiris debug log tool - 23/03/18 11:05 PM

Thanks again for making this Norbyte. It's been extremely useful for debugging why certain things weren't working as expected in existing saves (being able to see what goals are active, what values queries are returning, etc.).

thankyou
Posted By: Ameranth

Re: Osiris debug log tool - 02/05/18 09:42 PM

I wanted to say thanks for this again, because this tool has saved me countless hours finding the most obscure of bugs.

Not sure how we'd get on without you Norbyte.
Posted By: Tinkerer

Re: Osiris debug log tool - 06/09/18 12:58 PM

Good news: in the Definitive Edition, you can pass the parameter "-storylog 1" to EoCApp.exe to get an Osiris log!
Posted By: Windemere

Re: Osiris debug log tool - 06/09/18 02:15 PM

Originally Posted By: Tinkerer
Good news: in the Definitive Edition, you can pass the parameter "-storylog 1" to EoCApp.exe to get an Osiris log!


Whoa! That's fantastic, thank you!
Posted By: LaughingLeader

Re: Osiris debug log tool - 06/09/18 04:30 PM

Originally Posted By: Tinkerer
Good news: in the Definitive Edition, you can pass the parameter "-storylog 1" to EoCApp.exe to get an Osiris log!

Woah, neat!

Would it be possible to timestamp the log file, and possibly specify an output folder, perhaps as additional parameters? Currently the log file gets overwritten from each game session.
Posted By: Norbyte

Re: Osiris debug log tool - 17/01/19 06:45 PM

Hi Everyone,

I've updated the log tool to help with debugging "Could not create a working story" issues.

In addition to creating Osiris logs that log which rules fired and how, it'll create a Compile.log and Compile.div file in the log folder (My Documents\OsirisLogs by default) whenever story compilation fails that contains the story that failed to compile, and the corresponding compiler error/warning log.

Link: https://s3.eu-central-1.amazonaws.com/nb-stor/dos/OsirisProxy-1.0.3.zip

Happy debugging!
© 2020 Larian Studios forums