Skip to main content
When a monitored game closes, Overlayed automatically scans for new crash dump files. If a new dump is found, a new event is emitted so you can prompt the user to submit it. Crash dumps are uploaded to the Overlayed Dashboard and associated with your application.

Listening for crash dumps

overlay.crashDumps.on("new", async ({ id, game }) => {
	// Prompt the user — e.g. show a dialog asking if they want to submit
	const confirmed = await askUser("A crash was detected. Send report?");

	if (confirmed) {
		await overlay.crashDumps.submit(id);
	}
});

Submitting a crash dump

Call submit with the id from the new event. This uploads the dump file to the Overlayed backend and removes the local file on success.
await overlay.crashDumps.submit(id);

Event data

type CrashDumpEvent = {
	/** Opaque identifier used to submit the dump. */
	id: CrashDumpId;
	/** Identifier of the game that crashed. */
	game: GameIdentifier;
};