Minecraft Bedrock Debugger
github.com
What it is
Minecraft Bedrock Debugger is a free, open-source Visual Studio Code extension for developers building Minecraft Bedrock behavior packs and add-ons with JavaScript or TypeScript. It connects through script debugger commands, using port 19144 by default, and supports breakpoints, stepping, a Locals pane and watches. Developers can run Minecraft slash commands and keep shortcuts for favorite commands. Performance tools provide diagnostics and a script profiler that saves captures to a configured local path. Minecraft 1.21.10 or later can expose server statistics including entities, chunks, memory, tick time and network usage. Client diagnostics include FPS, memory, entity systems and CPU profiling, but require Minecraft’s “Enabled client diagnostics” creator setting. Scripts can add live diagnostics through the @minecraft/debug-utilities module. TypeScript projects can use source maps through sourceMapRoot and generatedSourceRoot. Dedicated Server debugging requires enabling inbound or outbound script-debugging settings in server.properties, which are disabled by default. Changing variable state and immediate mode are unsupported.
Spec sheet
- Purpose
- The Visual Studio Code extension helps debug JavaScript running in Minecraft Bedrock clients and Bedrock Dedicated Server.Read 9 Oct 2026 · github.com
- Intended users
- The documentation presents the debugger as a tool for developers building Minecraft Bedrock behavior packs and add-ons with JavaScript or TypeScript.Read 9 Oct 2026 · learn.microsoft.com
- Support
- The project asks users to send feedback by filing an issue in its GitHub repository.Read 9 Oct 2026 · github.com
- License
- The public GitHub repository lists an MIT license.Read 9 Oct 2026 · github.com
- Breakpoints
- It supports setting breakpoints and stepping through code.Read 4 Oct 2026 · github.com
- Client diagnostics
- Client-side performance data includes FPS, memory, entity systems, and CPU profiling, and requires Minecraft’s “Enabled client diagnostics” creator setting.Read 4 Oct 2026 · github.com
- Client diagnostics requirement
- Client-side performance data requires the “Enabled client diagnostics” creator setting to be enabled in Minecraft.Read 9 Oct 2026 · github.com
- Commands
- It can run Minecraft slash commands and offers shortcuts for favorite commands.Read 4 Oct 2026 · github.com
- Connection
- The debugger connects to Minecraft through script debugger commands and uses port 19144 by default.Read 9 Oct 2026 · github.com
- Custom diagnostics
- Minecraft scripts can push custom live diagnostics through the @minecraft/debug-utilities module.Read 4 Oct 2026 · github.com
- Custom diagnostics integration
- Minecraft scripting can push custom live diagnostics into the debugger using the @minecraft/debug-utilities module.Read 9 Oct 2026 · github.com
- Debugging features
- Supported features include breakpoints, stepping through code, the Locals pane, watches, performance diagnostics, and running Minecraft slash commands.Read 9 Oct 2026 · github.com
- Dedicated server settings
- Bedrock Dedicated Server debugging is disabled by default and requires changing server.properties settings to allow inbound or outbound script debugging.Read 9 Oct 2026 · github.com
- Dedicated Server setup
- Bedrock Dedicated Server debugging requires enabling the relevant inbound or outbound script-debugging settings in server.properties, which default to false.Read 4 Oct 2026 · github.com
- Inspection
- It provides a Locals pane and watches.Read 4 Oct 2026 · github.com
- Installation and feedback
- The project directs users to install the extension from the Visual Studio Marketplace and submit feedback through GitHub issues.Read 4 Oct 2026 · github.com
- Live diagnostics
- For Minecraft servers running version 1.21.10 or later, it can show statistics such as entity counts, memory usage, tick time, and network traffic.Read 9 Oct 2026 · github.com
- Notable limits
- Changing variable state and immediate mode are listed as unsupported scenarios.Read 4 Oct 2026 · github.com
- Performance tools
- It includes performance diagnostics and a script profiler that saves captures to a locally configured path.Read 4 Oct 2026 · github.com
- Profiler
- The extension includes a script profiler that saves performance captures of a running add-on to a configured local path.Read 9 Oct 2026 · github.com
- TypeScript
- For TypeScript projects that generate JavaScript, the setup supports source maps through sourceMapRoot and generatedSourceRoot settings.Read 4 Oct 2026 · github.com
- TypeScript support
- For TypeScript projects that generate JavaScript, the setup uses sourceMapRoot and generatedSourceRoot paths in launch.json.Read 9 Oct 2026 · github.com
- Unsupported scenarios
- Changing variable state and immediate mode are listed as unsupported.Read 9 Oct 2026 · github.com
Plans and prices
Strong points and limits
Strong points
- Breakpoints and step-through debugging
- Locals pane and watch values
- Built-in script performance profiler
- Server and client diagnostics
- MIT-licensed open-source project
Limits
- Changing variable state unsupported
- Immediate mode unsupported
- Client diagnostics require a creator setting
- Dedicated Server debugging is disabled by default
Who it suits
This extension suits developers debugging JavaScript or TypeScript for Minecraft Bedrock clients, servers, behavior packs and add-ons. It is intended for Windows use through Visual Studio Code.
Verdict
Minecraft Bedrock Debugger provides core code debugging plus performance and live diagnostics for Bedrock scripting. Developers must configure diagnostics and server settings, and accept the listed unsupported scenarios.
Where Specifiction places it
- Minecraft Add-on Editors#7 of 268.1