Integrations
Discord Webhooks

Discord Webhook Integration

Connect Hyperstone to your Discord server to receive notifications about builds, commits, and other project activities directly in your Discord channels.

What You'll Need

  • A Discord server where you have permission to manage webhooks
  • A channel where you want to receive notifications

Setting Up the Webhook

Step 1: Open Channel Settings

  1. Open Discord and navigate to your server
  2. Right-click on the channel where you want to receive notifications
  3. Select Edit Channel from the menu

Step 2: Create the Webhook

  1. In the channel settings, click on the Integrations tab in the left sidebar
  2. Click on Webhooks (or View Webhooks if webhooks already exist)
  3. Click the New Webhook button
  4. Give your webhook a name (e.g., "Hyperstone Notifications")
  5. Optionally, upload a custom avatar for the webhook

Step 3: Copy the Webhook URL

  1. Click on your newly created webhook to expand its settings
  2. Click the Copy Webhook URL button
  3. The URL will look something like this: 
    https://discord.com/api/webhooks/123456789/abcdefghijklmnopqrstuvwxyz

Step 4: Add to Hyperstone Settings

  1. Open Hyperstone
  2. Navigate to Settings → Local Settings
  3. Find the Discord Integration section
  4. Paste your webhook URL into the input field
  5. Click Test Webhook to send a test message
  6. Click Save Settings

What Gets Posted

Once configured, Hyperstone will automatically post notifications to your Discord channel for:

  • Builds: When you create a new build/playtest
  • Commits: When you commit changes to your project (optional)
  • Exports: When you export your game to itch.io or other platforms
  • Errors: Critical errors or crashes detected in your game (if analytics enabled)

Testing Your Webhook

After setting up your webhook, you can test it by:

  1. In Hyperstone, go to Settings → Local Settings
  2. In the Discord Integration section, click Test Webhook
  3. Check your Discord channel for a test message

You should see a notification appear in your Discord channel within a few seconds.

Customizing Notifications

You can customize which events trigger Discord notifications in Settings → Local Settings → Discord Integration:

  • Enable/disable build notifications
  • Enable/disable commit notifications
  • Enable/disable export notifications
  • Set minimum severity for error notifications

Troubleshooting

Webhook Not Working

  • Check the URL: Make sure you copied the entire webhook URL, including the token at the end
  • Check permissions: Ensure the webhook hasn't been deleted in Discord
  • Check channel: Verify the channel still exists and the webhook has permission to post

Messages Not Appearing

  • Check Discord settings: Make sure you haven't muted the channel
  • Check webhook status: Go back to Discord channel settings and verify the webhook is still active
  • Check Hyperstone settings: Ensure the webhook URL is correctly saved in Hyperstone settings

Invalid Webhook Error

If you see an "Invalid Webhook" error:

  • The webhook may have been deleted in Discord
  • The URL may be incomplete or corrupted
  • Create a new webhook and update the URL in Hyperstone

Security Notes

  • Keep your webhook URL private: Anyone with the URL can post messages to your channel
  • Don't share webhook URLs publicly: Treat them like passwords
  • Regenerate if compromised: If your webhook URL is exposed, delete it in Discord and create a new one

Removing the Integration

To stop sending notifications to Discord:

  1. Go to Settings → Local Settings
  2. Find the Discord Integration section
  3. Clear the webhook URL field
  4. Click Save Settings

Optionally, you can also delete the webhook in Discord:

  1. Go to your Discord channel settings
  2. Navigate to Integrations → Webhooks
  3. Click on the webhook and select Delete Webhook

Related Documentation

Godot EngineBlender