Getting Started

Get your first bug report flowing in under 5 minutes.

1. Create an account

Go to forgelogger.dev/auth and sign up with email or Google OAuth. After registration you will be redirected to the dashboard.

2. Create a project

Open Projects in the sidebar and click New Project. Fill in:

Field	Example	Notes
Name	My Awesome Game	3-120 characters
Slug	my-awesome-game	Lowercase, numbers, hyphens only
Description	Open world RPG	Optional, up to 1000 chars
AI Summary	Enabled	Auto-generates reproduction steps for bug reports
AI Deduplication	Disabled	Collapses identical reports (enable when you have volume)

3. Create an environment

Navigate to your project and open the Environments tab. Create at least one environment (e.g. Development, Staging, Production). Each environment can have an optional color tag for visual distinction in the dashboard.

4. Generate an API token

Go to the Settings page and click New Token. Select the project and environment, give the token a name (e.g. “Godot Dev”), and click Create.

The token starts with flg_ and is shown only once. Copy it and store it securely.

5. Send your first session and report

Use the token to authenticate against the Ingest API. Here is a minimal cURL example:

Start a session

curl -X POST \
  -H "Authorization: Bearer flg_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "build": { "version": "0.1.0", "platform": "windows" }
  }' \
  https://ingest.forgelogger.dev/v1/ingest/sessions

Response:

{
  "sessionId": "a1b2c3d4-...",
  "buildId": "e5f6g7h8-...",
  "startedAt": "2026-04-08T12:00:00.000Z"
}

Submit a bug report

curl -X POST \
  -H "Authorization: Bearer flg_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "a1b2c3d4-...",
    "report": {
      "title": "Player falls through floor",
      "description": "Happens near the bridge in level 2",
      "severity": "high"
    }
  }' \
  https://ingest.forgelogger.dev/v1/ingest/reports

That’s it! Open the dashboard and you will see the report under your project.

6. Use a game engine plugin (optional)

Instead of calling the API directly, install one of the engine plugins:

Godot 4 Plugin — automatic sessions, screenshots, offline queue, crash detection
Unity Plugin — coming soon
Unreal Engine Plugin — coming soon

Next steps

Ingest API Reference — full endpoint documentation with DTOs and examples
App Guide — learn how to use the dashboard, integrations, and exports
Plugins — engine-specific setup guides