diff --git a/.github/CHANGELOG.md b/.github/CHANGELOG.md
index 0ab6919f..d3555c88 100644
--- a/.github/CHANGELOG.md
+++ b/.github/CHANGELOG.md
@@ -1,5 +1,9 @@
## Changelog
+Update _ August 2023
+
+- feat: added .simbridgedebug command which explains debugging steps, if SimBridge crashes right after starting (07/08/2023)
+
Update _ July 2023
- fix: change the checklist image in the checklist command to the correct one (27/07/2023)
diff --git a/.github/command-docs.md b/.github/command-docs.md
index ce423389..bcc95566 100644
--- a/.github/command-docs.md
+++ b/.github/command-docs.md
@@ -83,6 +83,7 @@
| .reportedissues | Provides a link to the reported issues page within docs, either a general link, or a link for a specific search
Search terms can be terminated by a line break or one of the symbols . - > / \ | .issues |
| .remoteefb | Provides information about to the viewing the EFB remotely | .refb
.remoteflypad
.rflypad |
| .screenshot | Help to screenshot for support | .cockpit
.ss |
+| .simbridgedebug | Provides reason for SimBridge crashing, and steps to get a screenshot for debugging the crashing. | .sbdebug |
| .simbridgelog | Information on how to provide SimBridge Log | .slog |
| .simulationrate | Explanation of the limitation of the Simulation Rate based on frame rate | .simrate |
| .simversion | Help to identify MSFS version for support | .msfsversion |
diff --git a/assets/images/support/simbridgeDebug.png b/assets/images/support/simbridgeDebug.png
new file mode 100644
index 00000000..8a6b2c69
Binary files /dev/null and b/assets/images/support/simbridgeDebug.png differ
diff --git a/src/commands/index.ts b/src/commands/index.ts
index 0df4b017..3b8437aa 100644
--- a/src/commands/index.ts
+++ b/src/commands/index.ts
@@ -171,6 +171,7 @@ import { remoteEfb } from './support/remoteEfb';
import { brakeCheck } from './support/brakeCheck';
import { spad } from './general/spad';
import { devLanguages } from './general/devLanguages';
+import { simbridgeDebug } from './support/simbridgeDebug'
const commands: BaseCommandDefinition[] = [
typeCommand,
@@ -344,6 +345,7 @@ const commands: BaseCommandDefinition[] = [
brakeCheck,
spad,
devLanguages,
+ simbridgeDebug,
];
const commandsObject: { [k: string]: BaseCommandDefinition } = {};
diff --git a/src/commands/support/simbridgeDebug.ts b/src/commands/support/simbridgeDebug.ts
new file mode 100644
index 00000000..f7631111
--- /dev/null
+++ b/src/commands/support/simbridgeDebug.ts
@@ -0,0 +1,26 @@
+import { MessageCommandDefinition } from '../../lib/command';
+import { makeEmbed, makeLines } from '../../lib/embed';
+import { CommandCategory, imageBaseUrl } from '../../constants';
+
+const SIMBRIDGE_HELP_URL = `${imageBaseUrl}/support/simbridgeDebug.png`;
+
+const simbridgeDebugEmbed = makeEmbed({
+ title: 'FlyByWire Support | Why does SimBridge crash?',
+ description: makeLines([
+ 'If SimBridge crashes moments after start, it could be due to bad installation of SimBridge, missing modules or another issue. In order to assist you further we will need to see your SimBridge logs.',
+ '',
+ '1. Open the folder where SimBridge is installed.',
+ '2. Open a terminal window in that location (Hold `SHIFT` and right click on the empty space of the folder, then select "Open Windows Terminal", "Open Command Prompt", or "Open Powershell Window".',
+ '3. Type `fbw-simbridge.exe` and press enter.',
+ '4. Screenshot the output of the console and send it to us.',
+ ]),
+ image: { url: SIMBRIDGE_HELP_URL },
+ footer: { text: 'Tip: Click the image to view in full size' },
+});
+
+export const simbridgeDebug: MessageCommandDefinition = {
+ name: ['simbridgedebug', 'sbdebug'],
+ description: 'Provides instructions to debug SimBridge',
+ category: CommandCategory.SUPPORT,
+ genericEmbed: simbridgeDebugEmbed,
+};