Bedrock Script Inspector is a powerful web-based inspector version of Minecraft Bedrock Script API, providing extended debugging capabiliy for scripts. It utilizes native method wrapping which then will execute the interpreter and web inspector.
Note that this is only usable in Bedrock Dedicated Server and not local-hosted worlds / realms because @minecraft/server-net
is used to transfer and receive data and @minecraft/server-admin
is used for autoloading.
Bedrock Script Inspector includes a lot of features:
- Script consoles
- Object inspect
- Console graphing
- Eval
- Events
- Disable / enable / unsubscribe listeners
- subscribe / unsubscribe listeners trace
- Listeners timing
- Event data inspect
- Runs
- Suspend / resume / clear runs
- Add / clear runs trace
- Function timing
- Properties
- World / entity properties
- Property set trace
- Timing
- Watchdog Stats
-
Download build from Releases & extract
-
Run
install.bat
orinstall.sh
This will install the server dependencies and link the server CLI commands
bsi
for global use. -
Add a pack to inspect: (directory must contain manifest.json)
bsi ap <dir/to/pack>
-
Add the inspector pack to BDS: (directory must contain server.properties)
bsi ab <dir/to/bedrock_server>
-
Start the BDS server from NodeJS
bsi sb <dir/to/bedrock_server> <port>
-
Open
localhost
with port depends on which server port is used
-
add-pack
(aliasap
) - Adds a script pack to the inspector packModule dependencies must match the inspector's module dependencies. The pack is added through subpack and dropper script is created to execute the entry script after inspector scripts has been executed.
copy
(c
) - Copies the pack instead of linking it to the subpack
-
remove-pack
(aliasrp
) - Removes a script pack from the inspector packThis removes the pack that is being inspected from the subpack and removes the dropper script.
-
add-bds
(aliasab
) - Adds the inspector pack to the BDSThis adds the inspector pack to the BDS behavior packs and its world's behavior packs list. This also creates config for the inspector pack to allow BDS modules to be used.
copy
(c
) - Copies the inspector pack instead of linking it to the BDS behavios packs
-
remove-bds
(aliasrb
) - Removes the inspector pack from the BDSThis removes the inspector pack from the BDS behavior packs, its world's behavior packs list and, the inspector pack config.
-
start-bds
(aliassb
) - Starts server & BDS process from inspectorThis starts the inspector server, while also starts the bedrock server. Benefits being inspector autoconnect is possible and formatted BDS logs.
add
(a
) - Adds the pack to the BDS (same as runningadd-bds
) before starting the BDSadd-copy
(aC
) - Copies the inspector pack instead of linking it to the BDS behavios packsremove
(r
) - Removes the pack from the BDS (same as runningremove-bds
) after BDS process closedauth-user
(au
) - Inspector server authorization usernameauth-pass
(ap
) - Inspector server authorization password
It is possible to start the BDS server without running
add-pack
first by addingadd
option. Theremove
option can also be used to remove the debugger pack after the BDS is closed, making it a temporary addition to the BDS.bsi sb <dir/to/bedrock_server> <port> -a -r