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

  1. Select the correct Twitch account.
  2. Select a channel.
  3. Complete the actions on Channel setup.
  4. If Channel setup shows Ready, start the bot.
Open the setup guide

Guides by task

Select the guide for your screen

01

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.

02

Channels and access

Channels and access

Each Twitch channel keeps its own connection and tools.

03

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.

06

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.

08

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.

13

Community interaction · Moments

Channel Moments

Turn live viewer calls into one moderated Twitch clip or marker. Then publish safe stream and weekly recaps.

14

Community interaction · Viewer identity

Choose a viewer passport

Create a host-scoped profile. Choose its audience and the activity that BlokeBot presents.

16

Community progression · Seasons

Community progression

Turn supported channel events into individual or communal progress. Keep standings and viewer-earned rewards beyond the season.

24

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.

28

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.

30

Viewer points

Set up and manage points

Give each viewer a channel balance. Manage channel points. Staff can adjust balances or award prizes.

32

Public results

Share a public leaderboard

Viewers can open read-only guessing or points rankings without permission to manage the channel.

34

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.

36

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.

37

Plugin manifest

plugin.toml

plugin.toml defines the plugin package and its declarations.

38

Plugin development

Lua SDK

The generated module gives LuaLS type information.

39

Plugin development

Plugin handlers

Handlers connect manifest declarations to Lua functions. Plugins can declare the handler types below.

40

Plugin development

Host API

Use the API for the current invocation.

41

Plugin pages

Plugin pages

Generated pages use BlokeBot page documents for standard controls. Embedded pages provide a contained browser experience.

42

Plugin automations

Automation nodes

Plugins can add typed nodes to the standard automation editor.

43

Plugin releases

Testing and releases

The release process checks each target and submits the tested package to the curated repository.

44

Plugin development

Troubleshooting

Author command results and runtime diagnostics identify plugin errors.

45

Help and recovery

Warnings and an offline bot

Start with the message on the page. Use the reported problem to find the recovery action.

46

Moderator access

Let moderators help safely

Channel owners control moderator access to BlokeBot. They can allow all current Twitch moderators or use access lists.

Resolve a problem

Check the visible state first

  1. First, check the selected channel.
  2. Then check Alerts and Bot status.
  3. Use the troubleshooting guide to select safe information for the server owner.
Open the troubleshooting guide

Server operations

Install or host BlokeBot

Use the server setup guide for these topics:

  • Twitch developer credentials.
  • Callback URLs.
  • HTTPS.
  • Process state.
  • Backups.
Open the server setup guide