CSTV Discord Integration

Automatically post CS2 demo recordings to Discord via webhook.

Pro Feature

This plugin requires both a Pro server and CSTV enabled.

Overview

The CSTV Discord plugin automatically sends demo download links to your Discord server whenever a match is recorded. Perfect for teams and communities that want to review matches and preserve demos.

Requirements

• Pro server with CSTV enabled
• Discord server with appropriate permissions
• Webhook URL from Discord

Features

• Automatic demo URL posting to Discord
• Match information in notifications
• Direct download links
• Configurable webhook integration
• No manual upload needed

Discord Webhook Setup

Creating a Webhook

1. Open Discord and navigate to your server
2. Right-click the channel where you want demo links posted
3. Select Edit Channel
4. Navigate to Integrations → Webhooks
5. Click New Webhook

Configuring the Webhook

Customize your webhook:

• Name - Choose any name (e.g., "CS2 Demos", "Match Recordings")
• Avatar - Optional custom avatar for webhook posts
• Channel - Select target channel for demo notifications

Getting the Webhook URL

1. Click Copy Webhook URL
2. Save this URL - you'll need it for server configuration

Multiple Channels

You can create multiple webhooks pointing to different channels for organizing demos by team, tournament, or practice vs. competitive matches.

Server Configuration

Adding Webhook to Server

1. Log in to your Pro Panel
2. Navigate to your server's Edit page
3. Locate Discord Webhook URL (Optional) field
4. Paste your webhook URL
5. Click Save
6. Restart your CS2 server to apply changes

Restart Required

The server must be restarted for the webhook configuration to take effect.

Enabling CSTV

If CSTV isn't already enabled:

1. In your server panel, enable CSTV
2. Configure CSTV settings (port, delay, etc.)
3. Save and restart server

See the CSTV Guide for detailed CSTV configuration.

How It Works

Automatic Demo Posting

When a match completes and CSTV recording stops:

1. Demo file is automatically generated on server
2. Plugin detects the new demo file
3. Download URL is created
4. Webhook sends notification to Discord with:
   • Match information
   • Team names (if available)
   • Map played
   • Direct download link
   • Timestamp

Notification Example

Discord notifications typically include:

🎬 New CS2 Demo Available

Map: de_dust2
Match: TeamA vs TeamB
Date: 2025-12-27 10:30 UTC

Download: [Click here to download]

Demo Management

Accessing Demos

Via Discord:

• Click the download link in Discord
• Demo downloads directly to your computer

Via Server:

• Connect via FTP
• Navigate to /demos
• Download .dem files manually

Playing Demos

See the CSTV Guide for instructions on playing downloaded demos.

Troubleshooting

Webhook not posting to Discord

Check:

1. Webhook URL is correct and complete
2. Webhook hasn't been deleted in Discord
3. Bot permissions in Discord channel allow posting
4. Server has been restarted after adding webhook
5. CSTV is enabled and recording demos

Wrong channel receiving notifications

Verify the webhook is configured for the intended channel in Discord. Each webhook is tied to a specific channel.

Demo links not working

Ensure your server has proper demo file storage configured and demos are being saved to the correct directory.

No notifications after matches

Verify:

• CSTV is enabled and recording
• Matches are completing properly
• Demo files are being generated (/demos/ directory)
• Webhook URL is correctly saved in panel

Advanced Configuration

Multiple Webhooks

For organizations with multiple servers or teams:

1. Create separate webhooks for each server/team
2. Configure each server with its specific webhook
3. Organize Discord channels by server or team

Example structure:

#team-a-demos
#team-b-demos
#practice-demos
#tournament-demos

Custom Webhook Names

Customize webhook display names to identify the source:

• "Pro Server 1 - Demos"
• "Practice Server - Recordings"
• "TeamName - Match Demos"

Webhook Security

Keep Webhook URLs Private

Webhook URLs allow anyone with the URL to post to your Discord channel. Never share webhook URLs publicly.

If compromised:

1. Delete the old webhook in Discord
2. Create a new webhook
3. Update server configuration
4. Restart server

Best Practices

Organization Tips

• Create separate Discord channels for different demo types
• Use descriptive webhook names
• Set up webhooks for competitive vs. practice servers separately
• Archive old demos periodically to save space
• Document your demo naming conventions

Demo Storage

• Regularly back up important demos
• Download tournament/competitive demos immediately
• Clear practice demos periodically to save server storage
• Consider external storage for long-term demo archives

Limitations

• Requires Pro server
• CSTV must be enabled and functional
• Limited to Discord webhook functionality
• No retroactive posting of old demos
• Webhook rate limits apply (Discord side)

Additional Features

Match Information

When using match management plugins (like MatchZy), notifications can include:

• Team names
• Player rosters
• Match scores
• Round counts
• Server configuration used

File Naming

Demos are typically named with:

• Date and time
• Map name
• Team names (if configured)
• Match ID (if applicable)

Example: 2025-12-27_14-30-45_de_dust2_TeamA_vs_TeamB.dem

Related Resources

• CSTV Setup Guide - Enable and configure CSTV
• MatchZy Plugin - Enhanced match information
• Demo Playback - How to watch demos
• Discord Support - Get help with setup

Integration Examples

For Competitive Teams

1. Create webhook in #match-demos channel
2. Configure Pro server with webhook
3. Enable CSTV for all matches
4. Team reviews demos after each match
5. Archive important matches

For Communities

1. Webhook in #community-highlights channel
2. Record PUGs and community matches
3. Players download their favorite matches
4. Create highlight reels from demos

For Tournament Organizers

1. Separate webhooks per division/bracket
2. Archive all tournament demos
3. Review for rule violations
4. Share demos with casters/analysts
5. Preserve tournament history