Plugins

Plugins are modular extensions that give VPE its capabilities. Each plugin handles one specific job — connecting to a streaming platform, controlling OBS, managing bots, or running test scenarios.

VPE ships with everything you need built in. There's nothing extra to download or install. Plugins are simply the way features are organized under the hood, and you interact with them through the dashboard.

Every plugin can be independently enabled or disabled from the Plugins tab in the dashboard. Disabled plugins use zero resources — they're completely inactive until you turn them on.

Platform providers connect VPE to your streaming services. Each provider handles authentication, listens for live events, and feeds them into VPE for processing.

Supported platforms: Twitch (chat, cheers, follows, subs, raids, hype trains, polls, predictions), YouTube (chat, Super Chats, memberships, polls), Kick (chat, follows, subs, donations), TikTok (chat, gifts, reactions, viewers), Facebook (comments, reactions, followers, viewers), and Instagram (comments, reactions, viewers).

To connect a platform, go to Settings and sign in with your streaming account. VPE handles the OAuth flow automatically and keeps your connection alive, including refreshing credentials when they expire.

The OBS plugin connects VPE to OBS Studio via its built-in WebSocket protocol. This is how VPE controls your scenes, overlays, audio, and sources.

VPE automatically discovers your OBS sources and maps them to effect channels. It looks for sources with a VPE_ prefix first, then falls back to matching by source type. You can also set mappings manually.

Dry-run mode lets you test your entire automation setup without OBS connected. VPE simulates all OBS commands and prints what it would do to the terminal — perfect for building and debugging effects offline.

Scenario Player: Replays recorded stream scenarios for testing. Load a 'big donation' or 'raid' scenario and watch VPE react as if it were live. Great for building and testing automation rules without going live.

Bot Service: Runs five bot types — moderator, welcome, rules, commands, and timers. Each bot operates independently with its own personality and configuration.

Replay System: Orchestrates multi-angle instant replays through OBS. Automatically captures highlight moments and plays them back with smooth transitions (Pro and Studio plans).

AI Intelligence: Powers VPE's learning capabilities — smart effect selection, audience analysis, and optimization suggestions (Pro and Studio plans).

The Plugins tab in the dashboard shows every plugin with its current status: connected, disconnected, error, or disabled. You can see at a glance which platforms are online.

Each plugin has a Reload button that refreshes its configuration without restarting VPE. Change a setting, hit reload, and it takes effect immediately.

Plugin health is monitored continuously. If a platform connection drops, VPE shows the error in the dashboard and automatically attempts to reconnect. You'll see connection status update in real time.

Each plugin has its own settings, accessible from the plugin's detail panel in the dashboard. Platform providers have connection settings and event filters. OBS has source mapping and dry-run options.

Settings are isolated between plugins. Changing one plugin's configuration never affects another. This makes it safe to experiment with settings without worrying about side effects.

All configuration changes can also be made through VPE's API, which is useful for advanced users who want to script their setup or integrate with other tools.