Forge Bible Bot

Setup Guide

Everything you need to get the most out of Forge Bible Bot — from first install to advanced features.

Getting Started

Setup takes about 2 minutes. Here's how to get Forge Bible Bot live in your Twitch channel:

1 Sign in — Visit forgebiblebot.com and click "Add to Twitch". Sign in with your Twitch account to authorize the bot.

2 Mod the bot — In your Twitch chat, type: /mod ForgeBibleBot

This gives the bot permission to post messages in your channel. Without this, it will try to respond but Twitch may throttle its messages.

3 Test it out — Type !verse John 3:16 in your chat. The bot should respond with the verse!

4 Explore your dashboard — Go to your Dashboard to customize settings, toggle features, and set up the OBS overlay.

💡 Tip: Your community doesn't need to learn any commands to get started. They can just type Bible references naturally in chat — like "John 3:16" or "I love Romans 8:28" — and the bot will automatically detect and respond with the verse.

Stay Connected

Forge Bible Bot is actively developed with new features released regularly. Please bookmark your dashboard and visit it often — new capabilities like channel point redemptions, overlay themes, and stream event responses are added via updates. They're all off by default, so you need to visit your dashboard to turn them on.

1 Bookmark your dashboard — Visit forgebiblebot.com/dashboard regularly to see announcements, enable new features, and manage your community.

2 Install as an app — Click the install prompt in your browser to install FBB as a PWA on your phone, tablet, or desktop. No app store needed.

3 Enable push notifications — Get notified of important updates directly on your device.

4 Upgrade to EventSub — If you see a green "Upgrade to EventSub" or "Re-authorize Scopes" button on your dashboard, click it! This one-time re-auth unlocks channel points, raids, follows, subs, cheers, and go-live notifications.

Why visit regularly? Your prayer wall, trivia leaderboard, and community stats are all on your dashboard. New features are added frequently, and you won't see update announcements or admin messages unless you check in. We want to serve you and your community — help us help you by staying connected!

Discord Setup

Adding Forge Bible Bot to your Discord server unlocks additional features like rich embeds, slash commands, Verse of the Day auto-posting, Prayer Wall sync, scheduled posts, and more.

1 Add to Discord — From the landing page or your dashboard, click "Add to Discord" and select which server to add the bot to.

2 Set up Verse of the Day — In your dashboard under Verse of the Day, pick the Discord channel, time, and timezone for the daily auto-post. The bot posts a themed verse every day from a curated 70-verse rotation.

3 Set up Prayer Wall sync — Under Prayer Wall settings, choose a private Discord channel where prayer requests will be posted when someone uses !prayer or /prayer.

💡 Tip: Discord users can use either slash commands (/verse John 3:16) or bang commands (!verse John 3:16). They can also just type Bible references naturally in any message and the bot will auto-detect them.

Recommended Channel Setup

💡 Community Resources: Visit the Forged Together page for downloadable ministry resources, Twitch panel banners, and to see the Anvil Council supporters.

OBS Overlay Setup

The overlay displays verses, trivia, Jesus quotes, proverbs, study topics, the discussion queue, stream events (raids, follows, subs, cheers, channel points), shoutouts, a countdown timer, and celebration effects directly on your stream. It slides up, displays for a configurable duration, then fades out. Choose from 4 theme presets or set custom colors to match your branding.

These instructions are for OBS Studio 32.1 (released March 2026). If you're using an older version, the steps are similar but some menu names may differ slightly.

1 Copy your overlay URL — In your Dashboard, scroll down to the OBS Overlay section and copy the URL. It looks like: https://forgebiblebot.com/overlay/abc123...

2 Add a Browser source in OBS — In OBS, click the + button in the Sources panel. In OBS 32.1, the source type is called "Browser" (older versions called it "Browser Source"). Give it a name like "FBB Overlay".

3 Configure the source:

  • URL: Paste your overlay URL
  • Width: Match your stream resolution (e.g. 1920)
  • Height: Match your stream resolution (e.g. 1080)
  • Check"Control audio via OBS" — this is required for TTS audio to work on stream

4 Position the source — Set the Browser source to fill your entire scene (matching your canvas resolution, e.g. 1920x1080). The overlay has a transparent background and layers cleanly over your stream. To position individual elements (verses, trivia, timer, events, topic), use the Overlay Editor in your dashboard - it provides a drag-and-drop canvas for placing each zone independently around your webcam, game capture, or other stream elements.

5 Test it — Type !verse Psalm 23:1 in your Twitch chat. You should see the verse appear on your OBS preview within a few seconds!

💡 Tip: If you want the overlay to appear on top of everything, make sure the Browser source is at the top of your Sources list (above your game capture, webcam, etc.).

What Appears on the Overlay?

Each of these can be individually toggled on or off in your dashboard under General Settings → OBS Overlay → Overlay Display Controls. You can also toggle specific event overlays directly within each event's settings section in Twitch Settings.

Overlay Customization

Customize the look of your OBS overlay to match your stream branding. Go to General Settings → OBS Overlay in your dashboard.

Theme Presets: Gold (default dark background with gold accents), Light (white background, dark text), Dark (subtle dark tones), Minimal (transparent background, clean sans-serif font).

Color Customization: Use the four color pickers to override the theme's default primary color, background color, accent color, and text color.

Font Size: Choose Small, Medium (default), or Large to control how big verse text appears on your overlay.

Overlay Editor: Open the Overlay Editor from your dashboard to visually position each overlay element. Drag and drop five independent zones - Verses, Topic, Trivia, Timer, and Events - anywhere on a preview canvas. Each zone can be resized and positioned independently so your overlay fits perfectly around your webcam, game capture, or other stream elements.

Font Style: Choose from 10 clean, readable fonts: DM Sans (default), Inter, Roboto, Open Sans, Lato, Poppins, Nunito, Source Sans, Raleway, or Montserrat.

Display Duration: How long each notification stays on screen. Choose 10, 15 (default), 20, 25, or 30 seconds. Trivia and special events have their own durations that scale proportionally.

Tip: After changing overlay settings, save and then refresh your OBS Browser Source (right-click → Refresh) to see the changes. The overlay URL stays the same — only the styling updates.

OBS Browser Docks

Control FBB directly inside OBS. Browser Docks are compact panels embedded in your streaming software for quick access to stream controls, live activity feeds, and trivia management.

Available Docks

Stream Controls — Toggle overlay, trivia, auto-detect, celebrations, and features instantly.

Live Activity Feed — Real-time prayer requests, praise reports, and queue items with action buttons and optional audio alerts.

Trivia Controls — Start/skip trivia, set difficulty, and toggle Auto-Trivia mode for continuous questions.

Setup

1 Go to OBS Docks to copy your dock URLs.

2 In OBS: Docks menu → Custom Browser Docks...

3 Add a name, paste the URL, click Apply. Drag the panel to position.

Tip: Docks work best at 250-400px wide. Log in to forgebiblebot.com in OBS first.

Auto-Trivia Mode

Continuously posts trivia questions in your Twitch chat. After each question resolves, a new one fires after a configurable 5-30 second delay. Toggle off anytime. Perfect for BRB screens!

🔊 TTS Audio Setup (for !jesussaid)

When someone uses !jesussaid, the words of Christ can be read aloud on your stream via text-to-speech. Here's how to make sure the audio works:

⚠️ Prerequisite: You must have the OBS overlay set up first (see above), and "Control audio via OBS" must be checked in your Browser source properties. This same setting also enables celebration sound effects (trivia chimes, prayer tones, etc.).

1 Enable TTS in your dashboard — In the Jesus Said & Proverb section of your dashboard, make sure "Enable TTS Audio" is checked.

2 Set up audio monitoring in OBS — This is how you hear the TTS in your headphones while also sending it to your stream:

  • In OBS 32.1, go to Edit → Advanced Audio Properties (or right-click any source in the Audio Mixer and select Advanced Audio Properties)
  • Find your Browser source (the one with your overlay URL)
  • Under the Audio Monitoring column, change it to "Monitor and Output"

3 Set your monitoring device — Go to Settings → Audio and make sure "Monitoring Device" is set to your headphones (not "Default"). Always select a specific device here.

4 Test it — Type !jesussaid in your Twitch chat. You should hear the words of Jesus read aloud through your headphones, and the audio will also go out to your stream.

💡 Note: The Browser source may not appear in the Audio Mixer until TTS audio plays for the first time. This is normal — once the first !jesussaid fires, it will show up. In OBS 32.1, sources with no active audio are hidden from the mixer by default.

Dashboard Overview

Your Dashboard is where you manage everything. Here's what you can do in each section:

General Settings

Set your default Bible translation (ESV is the default — 18 translations available), toggle features on/off, configure command permissions with five tiers (everyone, followers, subscribers, VIPs, mods-only), and set a custom bot display name.

Verse of the Day

Choose which Discord channel gets the daily VOTD auto-post, what time it posts, and your timezone. The VOTD rotates through 70 curated verses across five themes: identity in Christ, grace and salvation, strength and courage, hope and future, and peace and comfort.

Prayer Wall

Configure where prayer requests sync to in Discord. Manage prayer requests from the dedicated Prayer Wall page.

Praise Reports

The joyful counterpart to prayer requests! When viewers use !praise or /praise, their praise report is saved and can sync to a dedicated Discord channel with a golden celebratory embed. Configure the praise channel in your Discord Settings.

Community Impact

The !impact command shows your community's stats for the current month — verses shared, trivia rounds played, prayers lifted up, and praise reports. A great way to see God moving through your ministry!

OBS Overlay

Copy your overlay URL and enable/disable the overlay. Open the Overlay Editor to visually position each element on a drag-and-drop canvas - including the new Discussion Queue zone. Customize fonts, colors, themes, and display duration. Control which features display with individual toggles.

Jesus Said & Proverb

Toggle these features on/off and control TTS audio. !jesussaid shows red-letter quotes from Jesus in the Gospels. !proverb shows wisdom from Proverbs, Ecclesiastes, and wisdom Psalms.

Community & Ministry

Set your community description, testimony page, ministry info, and welcome DM message for new Discord members.

Command Permissions

Each command can be set to one of five permission tiers: Everyone, Followers, Subscribers, VIPs, or Mods & Streamer Only. Each tier is hierarchical - setting "Followers" means followers, subscribers, VIPs, mods, and the broadcaster can all use it. This is also available in Twitch via !toggle. Note: Follower detection uses Twitch chat badges, so follower badges should be enabled in your channel settings for best results. Permission tiers apply to Twitch commands only; Discord commands use a separate everyone/mods system.

Scheduled Posts

Schedule messages to post in your Discord server at any future date and time. Supports plain text or rich embeds with titles, descriptions, colors, footers, and YouTube video URLs. Manage from the Scheduler page.

Stream Mode

A mobile-friendly panel for toggling features on/off during your stream without navigating the full dashboard. Access it from the ⚡ Stream link in the nav bar.

Team Access (Delegate)

Invite trusted moderators to help manage your bot. You control what they can access with four scoped permissions: Stream Controls, Prayer Wall, Settings, and Scheduled Posts.

All Commands

Commands work with ! in Twitch and Discord, or / slash commands in Discord. Your community can also just type Bible references naturally — no command needed.

Bible & Study

CommandDescription
!verse <ref>Look up any verse (e.g. !verse Romans 8:28-30)
!read <ref>Read a full chapter
!search <words>Search the Bible by keyword
!xref <ref>Find cross-references for a verse
!randomRandom encouraging verse
!votdToday's Verse of the Day (builds a streak!)
!next [n]Navigate to next verse(s)
!prev [n]Navigate to previous verse(s)
!saveBookmark the last verse you looked up
!savedView your bookmarked verses
!translation <code>Set your preferred translation (esv, niv, nkjv, nlt, nasb, nasb95, amp, bsb, kjv, web, asv, ylt, bbe, darby, nirv, lsv, gnv, fbv)

Ministry & Community

CommandDescription
!jesussaidRandom red-letter quote from Jesus (with TTS on overlay!)
!proverbBiblical wisdom from Proverbs & wisdom literature
!gospel [lang]Share the Gospel message (12 languages: en, es, de, fr, pt, ko, ja, zh, ru, ar, hi, tl)
!evangelio / !evangelium / !evangile / !evangelho / !ebanghelyoGospel shortcuts (Spanish, German, French, Portuguese, Tagalog)
!gospel-ko / !gospel-ja / !gospel-zh / !gospel-ru / !gospel-ar / !gospel-hiGospel shortcuts (Korean, Japanese, Chinese, Russian, Arabic, Hindi)
!prayer <request>Submit a prayer request
!praise <message>Share a praise report — celebrate answered prayers and what God is doing
!impactSee community stats for the current month (verses, trivia, prayers, praises)
!streakCheck your VOTD streak

Bible Trivia

CommandDescription
!trivia [easy|medium|hard]Start a trivia question (500 questions)
!a <answer>Answer the active trivia question
!score [user]Check your trivia score and accuracy
!leaderboardYour community's trivia leaderboard
!globalGlobal leaderboard across all communities

Stream (Twitch)

CommandDescription
!topic <ref>Set a study topic (shows on overlay, reminders every 15 min)
!topic clearClear the study topic
!q add <topic>Add a discussion topic to the queue (mods/broadcaster)
!q nextActivate the next queued topic
!q doneClear the active discussion item
!q listShow the discussion queue
!q remove <#>Remove a queued item by number
!q promote <#>Move a queued item to position 1
!q clearClear the entire discussion queue
!timer <1-30>Start a countdown timer on OBS overlay (mods/broadcaster)
!timer stopCancel the active timer
!toggle <feature> on/off/mods/vips/subscribers/followers/everyoneToggle features or set permissions during stream (mods/broadcaster)

Info

CommandDescription
!aboutBot info and links
!testimonyCreator's testimony page
!supportSupport development
!helpList all commands

Feature Deep-Dive

Bible Reference Auto-Detect

The bot watches all chat messages for Bible references. No command needed — if someone types "I love John 3:16" or just "Romans 8:28", the bot detects the reference and responds with the verse. This works in both Twitch and Discord. It supports all standard formats: single verses, ranges (Romans 8:28-30), comma-separated verses (John 3:16,17), cross-chapter ranges (Ephesians 4:31-5:2), and multi-reference lookups with semicolons (John 3:16; Psalm 23:1).

18 Bible Translations

Every user can set their preferred translation with !translation <code>. The bot remembers your choice permanently. Available translations:

Bible Trivia

500 questions across three difficulty levels: Easy (74 questions, 1 point), Medium (101 questions, 2 points), and Hard (95 questions, 3 points). The bot uses fuzzy matching and synonym recognition — so "Moses" and "Moses the prophet" both work, and "cypress wood" and "gopher wood" are both accepted for translation-variant answers. Trivia answers display in your community's default translation for consistency.

Verse of the Day Streaks

Every time someone uses !votd, they build a streak. Miss a day and the streak resets (but the best streak is always remembered). Streak milestones: 🔥 3+ days, 🔥🔥🔥 7+ days, 🔥🔥🔥🔥 14+ days, 🔥🔥🔥🔥🔥 30+ days. Great for encouraging daily Scripture engagement!

Installable App (PWA)

Forge Bible Bot is a Progressive Web App. You can install it on your phone, tablet, or desktop — no app store needed. On iOS, tap the Share button then "Add to Home Screen" in Safari. On Android and desktop, you'll see an install prompt when you visit the site. Once installed, you get quick access to your dashboard and can receive push notifications.

Stream Events

These features require the EventSub upgrade from your dashboard. If you haven't upgraded yet, look for the green "Upgrade to EventSub" banner on your Overview page.

First-Chatter Welcome

Automatically greet each viewer the first time they chat during your stream. Resets each stream day. Enable in Twitch Settings → First-Chatter Welcome.

Raid Welcome

When another streamer raids your channel, the bot sends a customizable welcome message. Use {raider} for the raiding streamer's name and {viewers} for the viewer count. Enable in Twitch Settings → Raid Welcome.

Follow Welcome

Thank new followers automatically with a customizable message. Includes a 5-minute cooldown per user to prevent spam. Enable in Twitch Settings → Follow Welcome.

Sub & Cheer Responses

When someone subscribes or cheers, the bot responds with a thank-you message including a random Bible verse. Use {user}, {bits}, and {random_verse} template variables. Enable in Twitch Settings → Sub & Cheer Responses.

Auto-Shoutout

Maintain a list of Twitch usernames (friends, fellow streamers, VIPs) who get an automatic shoutout the first time they chat each stream. Set per-user custom messages or use your default. Manage in Twitch Settings → Auto-Shoutout System.

Channel Point Redemptions

Map your Twitch Channel Point rewards to bot actions. Here's how to set it up:

1 Create a Custom Reward on Twitch — Go to your Twitch Creator Dashboard → Viewer Rewards → Channel Points → Manage Rewards & Challenges. Create a new custom reward (e.g., "Random Bible Verse").

2 Add a Mapping on FBB — In your FBB dashboard, go to Twitch Settings → Channel Point Redemptions and click "Add Mapping". Enter the exact reward name (case-insensitive) and choose a bot action.

3 Test it — Redeem the Channel Point reward in your chat and the bot will execute the configured action.

Available actions: random_verse, verse_lookup (reads user input), votd, gospel, trivia, jesus_said, proverb, psalms, read, prayer_request, praise_report, custom_message.

Discord Go-Live Alerts

Get automatic Discord notifications when your stream goes live or ends. Set up in Discord Settings → Go-Live Notifications:

1 Select a Discord channel for go-live alerts

2 Enable "Post when stream goes live" and optionally "Post when stream ends"

3 Customize messages — Use {streamer} for your display name

4 Optional: Select a role to ping — Choose a Discord role from the dropdown and that role will be mentioned when the go-live notification posts, triggering real notifications for members with that role.

Prayer Follow-Up

Enhances the Prayer Wall with status tracking and automated follow-up nudges for your prayer team.

How It Works

Each prayer request now has a status: Pending (default), Prayed For, Ongoing, or Answered. You can update the status from the Prayer Wall page using the dropdown on each request.

When enabled, a daily cron job checks for prayers that haven't been updated in a configurable number of days (default 7). It sends a gentle nudge to your designated follow-up channel in Discord — a separate channel from the main Prayer Wall, so nudges go to your leadership or prayer team, not the whole server.

Setup

1 Create a follow-up channel — In your Discord server, create a private channel for your prayer/leadership team (e.g., #prayer-team).

2 Configure in Dashboard — Go to Discord Settings → Prayer Follow-Up. Enable the feature, select the follow-up channel, and set the nudge interval.

💡 Tip: Nudges are intentionally light — one embed per stale prayer, at most 10 per day. This keeps it useful without becoming noise.

Monthly Memory Verse

A community Scripture memorization feature. One verse per month — intentionally kept simple so your community can focus on doing one thing well.

How It Works

Setup

1 Enable it — Go to General Settings → Monthly Memory Verse and toggle it on.

2 Set the verse — Enter a reference (e.g., Psalm 119:11) and optionally pick a translation.

3 Choose day & channel — Pick which day of the week to post reminders and which Discord channel to use.

💡 Philosophy: Weekly, not daily. One verse, not five. The goal is meaningful engagement, not notification fatigue. "I have stored up your word in my heart." — Psalm 119:11

Bot Timer

A simple countdown timer that displays on your OBS overlay — great for break timers, prayer time, or Q&A countdowns.

Usage (Twitch Only)

CommandDescription
!timer <1-30>Start a countdown timer (1-30 minutes, whole numbers only)
!timer stopCancel the active timer

Details

Discussion Queue

During Bible study streams, great questions and topics often come up faster than you can address them. The discussion queue lets mods and the broadcaster park those topics so nothing gets lost, then work through them one at a time.

Usage (Twitch Only)

CommandDescription
!q add <topic>Add a discussion topic to the queue
!q nextPull the next item from the queue and make it active
!q doneClear the active discussion item
!q listShow the full queue in chat
!q remove <#>Remove a specific item by number
!q promote <#>Move an item to position 1
!q clearClear the entire queue

Details

Example Flow

You are studying Judges 2-4 with your topic set via !topic Judges 2-4. A viewer asks about denominations, and another brings up relationships. A mod types !q add Denominations and !q add Relationships. When you finish the current discussion, type !q next and the bot announces: "Now discussing: Denominations (queued by @ModName)" - and it appears on your OBS overlay. When done, !q done or !q next to move on.

Best Practices

For Twitch Streams

For Discord Servers

Stay Up to Date

"Your word is a lamp to my feet and a light to my path." — Psalm 119:105

Built for God's glory by ForgedByGrace7 ✝️