Help guides
Help topics
Use the BlokeBot navigation label and dashboard text to select a guide for your current task.
Set up a new channel
Prepare a bot after Twitch sign-in
- Select the correct Twitch account.
- Select a channel.
- Complete the actions on Channel setup.
- If Channel setup shows Ready, start the bot.
Guides by task
Select the guide for your screen
Everyday navigation
Find your way around the dashboard
The navigation follows the selected channel. It groups tools by task and shows only the features that the channel turned on.
Channels and access
Channels and access
Each Twitch channel keeps its own connection and tools.
Twitch connection
Connect the bot to your channel
BlokeBot identifies the required Twitch account or permission. It keeps the bot stopped until the channel is ready.
Channel tools
Choose the tools your channel needs
Each available Chat Tools feature is an independent opt-in choice. Each channel can run only the tools it needs.
Channel plugins
Use plugin features in your channel
A trusted plugin can add channel tools. Each channel controls its own plugin features and settings.
Move channel settings
Export and move channel settings
Export supported channel settings to import them into another channel. The file is not a full backup.
Stream presentation · Browser Sources
Create Browser Sources for OBS
Configure Browser Sources.
Stream presentation · Cues
Build and trigger reusable Cues
Combine media in a reusable Cue. Then play the saved Cue through a Cue player Browser Source.
Stream presentation · Media library
Manage media for Cues
Manage channel media.
Community interaction
Find a channel's activities
Use your channel page.
Community interaction · Requests
Run a structured request board
Manage viewer requests.
Community interaction · Queues
Build fair play-with-viewers parties
Manage viewer participation.
Community interaction · Moments
Channel Moments
Turn live viewer calls into one moderated Twitch clip or marker. Then publish safe stream and weekly recaps.
Community interaction · Viewer identity
Choose a viewer passport
Create a host-scoped profile. Choose its audience and the activity that BlokeBot presents.
Community progression · Bounties
Fund channel challenges with viewer points
Manage community challenges.
Community progression · Seasons
Community progression
Turn supported channel events into individual or communal progress. Keep standings and viewer-earned rewards beyond the season.
Community progression · Competitions
Run tournaments and leagues
Manage competitions.
Community interaction · Raids
Use the raid and collaboration hub
Manage raid collaboration.
Community progression · Cooperative game
Run a persistent BlokeRaid campaign
Keep one host-scoped channel boss across streams. Preserve the campaign record.
Community progression · Multi-host
Coordinate a multi-host Collective
Manage a Collective.
Community progression · Bingo
Run Stream-event Bingo
Manage Bingo.
Native Twitch
Use Twitch channel tools
Use Twitch tools for the selected channel.
Native Twitch · Polls
Ask viewers a question
Manage polls.
Native Twitch · Clips & markers
Save a live moment
Create a shareable clip now or leave a private marker to find in the stream recording later.
Native Twitch · Rewards & redemptions
Manage rewards and viewer requests
Manage Channel Points rewards.
Native Twitch · Predictions
Run and settle a Prediction
Manage Predictions.
Custom commands
Create commands and scheduled messages
Configure Custom commands.
Chat commands · Viewer discovery
Publish the commands viewers can use now
Choose one global Commands trigger. Viewers can discover a safe list of main command names for the selected channel's current state.
Guessing games
Set up and run a guessing game
Manage Guessing rounds.
Viewer points
Set up and manage points
Give each viewer a channel balance. Manage channel points. Staff can adjust balances or award prizes.
Points giveaways
Run a giveaway
Manage giveaways.
Public results
Share a public leaderboard
Viewers can open read-only guessing or points rankings without permission to manage the channel.
Automations
Connect channel events to automatic actions
Build, test and reuse visual channel automations.
Automations · Twitch events
Start automations from Twitch activity
The Twitch events page lists each automation source for the selected channel. It shows the required Twitch approval and current use.
Automations · Actions
Choose what an automation does
Configure flow actions. Each action obeys its feature switches and Twitch limits.
Plugin development
Lua plugins
A plugin project declares its access to BlokeBot. It includes generated types and the files for local tests and the curated repository.
Plugin manifest
plugin.toml
plugin.toml defines the plugin package and its declarations.
Plugin development
Lua SDK
The generated module gives LuaLS type information.
Plugin development
Plugin handlers
Handlers connect manifest declarations to Lua functions. Plugins can declare the handler types below.
Plugin development
Host API
Use the API for the current invocation.
Plugin pages
Plugin pages
Generated pages use BlokeBot page documents for standard controls. Embedded pages provide a contained browser experience.
Plugin automations
Automation nodes
Plugins can add typed nodes to the standard automation editor.
Plugin releases
Testing and releases
The release process checks each target and submits the tested package to the curated repository.
Plugin development
Troubleshooting
Author command results and runtime diagnostics identify plugin errors.
Help and recovery
Warnings and an offline bot
Start with the message on the page. Use the reported problem to find the recovery action.
Moderator access
Let moderators help safely
Channel owners control moderator access to BlokeBot. They can allow all current Twitch moderators or use access lists.
Technical operations
Install and recover trusted plugins
Administer curated plugins.
Server owners
Install and operate the main database
SQLite is the default. BlokeBot supports the current PostgreSQL 18 minor release for one active instance per main database.
Technical operations
Run a BlokeBot server
Operate the BlokeBot server.
Resolve a problem
Check the visible state first
- First, check the selected channel.
- Then check Alerts and Bot status.
- Use the troubleshooting guide to select safe information for the server owner.
Server operations
Install or host BlokeBot
Use the server setup guide for these topics:
- Twitch developer credentials.
- Callback URLs.
- HTTPS.
- Process state.
- Backups.