Update Watchdog.md

Author: JaylyDev

docs/MinecraftApi/Watchdog.md

@@ -1,10 +1,10 @@
 # Watchdog
 
-Watchdog is a performance watchdog system that is enabled in Minecraft script plugins by default.
+Watchdog is a performance system for script engine that is enabled in Minecraft script plugins by default.
 
 ## Server properties
 
-Watchdog configuration can be modified via `server.properties` in Dedicated Server. This features are added since 1.19.20.
+Watchdog configuration can be modified via `server.properties` in [Dedicated Server](https://www.minecraft.net/en-us/download/server/bedrock). This features are added since 1.19.20.
 
 ```properties
 # Enables the watchdog (default = true)
@@ -19,10 +19,12 @@ script-watchdog-spike-threshold=100
 # Sets the watchdog threshold for slow scripts over multiple ticks (default = 2ms)
 script-watchdog-slow-threshold=2
 
-# Saves and shuts down the world when the combined memory usage exceeds the given threshold (in megabytes). Setting this value to 0 disables the limit. (default = 250)
+# Saves and shuts down the world when the combined memory usage exceeds the given threshold (in megabytes).
+# Setting this value to 0 disables the limit. (default = 250)
 script-watchdog-memory-limit=250
 
-# Produces a content log warning when the combined memory usage exceeds the given threshold (in megabytes). Setting this value to 0 disables the warning. (default = 100)
+# Produces a content log warning when the combined memory usage exceeds the given threshold (in megabytes).
+# Setting this value to 0 disables the warning. (default = 100)
 script-watchdog-memory-warning=100
 
 # Enables watchdog exception handling via the events.beforeWatchdogTerminate event (default = true)
@@ -39,34 +41,67 @@ script-watchdog-hang-exception=true
 
 These watchdog errors are thrown with `[Watchdog]` label in error.
 
-- Slow-running script detected in behavior pack '%s' (x ms average)
+---
 
-  Script runtime is delayed by over a certain timeframe. This
+### Slow-running script detected in behavior pack '%s' (x ms average)
 
-- x ms script spike detected in behavior pack '%s'
+  Script runtime is delayed by over a certain timeframe.
+
+---
+
+### x ms script spike detected in behavior pack '%s'
 
   There is a spike in script runtime.
 
-- Out of memory exception detected in behavior pack '%s'
+---
+
+### Out of memory exception detected in behavior pack '%s'
 
   This error occurs when the combined memory usage exceeds.
 
   This saves and shuts down the world by Watchdog termination and cannot be canceled using `BeforeWatchdogTerminateEvent`.
 
-- x ms script hang detected in behavior pack '%s'
+---
+
+### x ms script hang detected in behavior pack '%s'
 
   The scripts freezes at a certain location of your script for more than the watchdog threshold for single tick.
 
   This is usually caused by iteration, such as `while` loop and `for` loop.
 
-- Stack overflow detected in behavior pack '%s'
+---
+
+### Stack overflow detected in behavior pack '%s'
 
   Occurs when there is a recursive function (a function that calls itself) without an exit point.
 
-- High memory usage detected
+---
+
+### High memory usage detected
 
   Produces a content log warning when the combined memory usage exceeds the given threshold in megabytes.
 
-- Unhandled critical exception of type '%s' in behavior pack '%s'
+---
 
-  Produces a content log error when an unhandled critical exception occurs.
+### Unhandled critical exception of type '%s' in behavior pack '%s'
+
+  Produces a content log error when an unhandled critical exception occurs.
+  
+  There are multiple reason that a watchdog is deciding to terminate execution of a behavior pack's script.
+  - `hang`: script is not responsive due to a hang or infinite loop.
+  - `stackOverflow`: a long, and potentially infinite chain of function calls.
+  
+## Script API
+
+Using Minecraft's scripting API, you are able to connect to a callback that will be called when a script runtime is being terminated due to a violation of the performance watchdog system.
+
+This event allows you to cancel the termination of the script runtime to prevent from the watchdog from stopping the server from running. Note that depending on server configuration settings, cancellation of the termination may not be allowed.
+
+```js
+import { system } from '@minecraft/server';
+
+system.events.beforeWatchdogTerminate.subscribe((event) => {
+  event.cancel = true;
+});
+```
+