HowToDebug0adWithVSCode.md

The objective of this doc is to share how to debug the game 0ad with VSCode

1st you have to compile it with debug objects, to do so you need to:

cd 0ad/build/workspaces ./update-workspaces.sh -j3
cd gcc
make config=debug

Then you can execute the debug version

binaries/system/pyrogenesis_dbg

and then you can configure your VSCode adding this, to your launch.json:

    {
        "name": "debug 0ad",
        "type": "cppdbg",
        "request": "launch",
        "program": "/opt/src/0ad/binaries/system/pyrogenesis_dbg",
        "args": [],
        "stopAtEntry": false,
        "cwd": "/opt/src/0ad/binaries/system/",
        "environment": [],
        "externalConsole": false,
        "MIMode": "gdb",
        "setupCommands": [
            {
                "description": "Add pretty impression to gdb",
                "text": "-enable-pretty-printing",
                "ignoreFailures": true
            }
        ],
        "miDebuggerPath": "/usr/bin/gdb"
    }

And there you go, now you can debug what's up with 0ad