Pyrogenesis Tools

Game development tools for working with Pyrogenesis Engine in Visual Studio Code

• Features
• Contributing
• JS Debugger
  • Issues and contributions

Features

• JS Debugger features:
  • breakpoints
  • exceptions
  • step-in/out/over
  • variable watch
  • call stack

🐞 Using the Debugger

1. Start Pyrogenesis with DAP enabled

pyrogenesis --dap-interface

2. Launch a fresh VS Code window

(No folder/workspace—just an empty window.)

1. Open Run & Debug (Ctrl + Shift + D).
2. Click Run and Debug.
3. Pick “Pyrogenesis JS Debugger” from the list.

3. Load the script you want to debug

Because SpiderMonkey only exposes scripts after they are executed, you must first trigger the code path in the game:

1. Play / navigate in Pyrogenesis until the script runs.
2. Back in VS Code, open the LOADED SCRIPTS view (under the debugger controls).
3. Search for and double-click your file.
4. Set breakpoints as usual.

Breakpoints stay valid as long as the VS Code window is open—you can stop, re-attach, or restart without losing them.

⚠️ Pause/Break-all is not supported. If your breakpoint doesn’t hit, exit to the main menu or restart Pyrogenesis and try again.

Issues and contributions

The Pyrogenesis Tools extension is an open source project from the Wildfire games organization. Feel free to open issues and create pull requests anytime.

See the full changelog for the latest changes.

Contributing

see CONTRIBUTING.md