Setting up Debugging

Setting up Build & Run

1. Install the DreamMaker Language Client extension for Visual Studio Code.
2. Press Ctrl+Shift+B to build.
3. Press F5 to build & run.

If hitting F5 appears to do nothing:

1. Press Ctrl+Shift+D to access the debug view.
2. Click the "create a launch.json file" link.
3. Hitting F5 should now work.

Setting up debugging

To enable debugging on your codebase, add this proc and call it at the top of /world/New():

/world/proc/enable_debugger()
    var/dll = world.GetConfig("env", "EXTOOLS_DLL")
    if (dll)
        call(dll, "debug_initialize")()

The debugging hooks will automatically activate when the project is run with F5. Use Ctrl+F5 to run without debugging. The debugging hooks will not activate when not configured, so this code can be safely committed to source control.

Using the debugger

For a general overview, read Debugging in Visual Studio Code.

Advanced configuration

Create launch.json

Click the "create a launch.json file" link in the Debug and Run view, or click the gear icon while a debug session is active.

Run without building

Edit launch.json and remove or comment out the "preLaunchTask" line.

Debugging on Linux

DreamSeeker and the debug hooks will work under Wine with no additional configuration. Use an attach configuration if running DreamDaemon under Wine. Debugging the Linux-native DreamDaemon is not currently supported.

Attach configurations

Mode and port parameters can be passed to debug_initialize. The default is as if you had written:

var/mode = world.GetConfig("env", "EXTOOLS_MODE") || "NONE"
var/port = world.GetConfig("env", "EXTOOLS_PORT") || "2448"
call(dll, "debug_initialize")(mode, port)

Set EXTOOLS_MODE when running DreamSeeker or DreamDaemon or adjust enable_debuger to pass one of the following modes:

• BACKGROUND: listen for connections on the given port in the background.
• BLOCK: wait for a connection on the given port before resuming.

Edit launch.json, click "Add Configuration", and choose "BYOND: Attach to debugger". Ensure the port numbers match. You will also need to set EXTOOLS_DLL.

Read more about world.GetConfig.

Bundled Extools

To ensure compatibility, debug adapter releases bundle a copy of the extools.dll debugging hooks which they know how to communicate with and set EXTOOLS_DLL accordingly. To use a locally built DLL, set the dreammaker.extoolsDLL key in Visual Studio Code's settings.json.