Skip to content

Latest commit

ย 

History

14 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

vaybc

VAYBC is a comprehensive Jeopardy-style game PowerPoint template and VBA code that's been customized for Bible Challenge competition at VAY Sports Fest

VAY Bible Challenge 2026 - PowerPoint Game System

A customized Jeopardy-style PowerPoint game system specifically designed for VAY Sports Ministry's Bible Challenge competition. This interactive presentation allows for dynamic gameplay with real-time scoring, countdown timers, and automated question management.

Two versions available:

  • Practice: Full 8-player, 6-category board for training
  • Official Game: Competition-compliant 3-player, 5-category board

{TODO: Put photo here} Official game board showing 5 categories with Bible-themed questions

๐ŸŽฏ Features

Two Template Options

Official Game (VAY Competition Rules)

  • 5 Bible Categories with 5 difficulty levels each
  • 3 Player Support (VAY regulation compliance)
  • Competition-ready interface optimized for official gameplay

Practice Game (For Training)

  • 6 Categories with 5 difficulty levels each
  • 8 Player Support for larger practice groups
  • Full original template functionality for comprehensive training

Core Gameplay (Both Templates)

  • Daily Doubles with random placement and custom wagering
  • Final Jeopardy with individual player wagering
  • Interactive Game Board with clickable question tiles
  • Real-time Score Tracking with persistent scoreboards
  • Automatic Score Management with audit trail logging

Technical Features

  • Excel Import - Load questions and answers from spreadsheet templates
  • Countdown Timer - Visual timer for each question (customizable duration)
  • Score Adjustment Tools - Manual score correction capabilities
  • Master Slide Integration - Persistent scoreboards across all slides
  • Question Navigation - Automatic slide transitions and board management

๐Ÿ“‹ Requirements

  • Microsoft PowerPoint (2010 or later recommended)
  • Windows Operating System (tested on Windows 10)
  • VBA/Macros Enabled in PowerPoint
  • Microsoft Excel (for question import functionality)

๐Ÿš€ Quick Start

Installation

  1. Clone the repository:

    git clone https://github.com/i12know/vaybc.git
    cd vaybc
  2. Choose your template:

    • For Official Competition: PowerPoint_Files/VAY_Bible_Challenge_Official3teams.pptm (3 players, 5 categories)
    • For Practice/Training: PowerPoint_Files/VAY_Bible_Challenge_Practice8players.pptm (8 players, 6 categories)
  3. Open the PowerPoint file:

    • Enable macros when prompted by PowerPoint
    • Both templates use the same VBA codebase
  4. Configure player/team names:

    • Go to View > Slide Master
    • Official Template: Edit team name text boxes (TextBox 2, TextBox 3, TextBox 4)
    • Practice Template: Edit team name text boxes (TextBox 2 through TextBox 9)
    • Exit Slide Master view

Basic Usage

  1. Setup Questions:

    • Use the Excel template in Templates/VAY_Bible_Challenge_Practice.xlsx
    • Fill in categories, values, questions, and answers
    • Run ImportFromExcel() macro to load questions
  2. Start Game:

    • Press F5 to start slideshow
    • Click question values on the board to navigate
    • Use player buttons to award/deduct points
  3. Game Controls:

    • Correct Answer: Click green "Player X Correct" button
    • Incorrect Answer: Click red "Player X Incorrect" button
    • Manual Score Adjustment: Use AdjustScores() macro
    • Reset Game: Use resetAll() macro

๐Ÿ› ๏ธ Customization

Template Differences

The codebase supports both configurations through the same VBA constants:

Private Const PLAYER_COUNT = 8    # Full support for up to 8 players
Private Const CATEGORY_COUNT = 6  # Full support for up to 6 categories

Official Template (VAY Competition Rules):

  • Uses only players 1-3 (scoreboards 4-8 hidden)
  • Uses only categories 1-5 (category 6 hidden)
  • Simplified interface for official competition

Practice Template (Full Training):

  • All 8 player scoreboards visible and functional
  • All 6 categories visible and functional
  • Complete original template experience

Creating Custom Variations

To modify existing templates:

  1. Adjust visible elements in Master Slide view
  2. Show/hide scoreboards by modifying Master Slide layouts
  3. Add/remove player buttons on question slides
  4. Update Excel templates to match category count

Template-Specific Functions

Both templates use the same VBA functions, but with different visual implementations:

' This function adapts based on visible players in each template
Private Function sNameOfPlayer(playerNo As Integer) As String
    ' Official template: Returns names for players 1-3 only
    ' Practice template: Returns names for players 1-8
End Function

Countdown Timer

The Slide Master includes a 5-stage visual timer (shapes named timerLight1a/1b through timerLight5) that counts down by extinguishing lights as time passes. DufJeopardy.bas has setTimerDelay(), which prompts for a total delay and distributes it evenly across the lights' animation exit triggers:

Sub setTimerDelay()
    ' Run manually from the VBA editor; sets the countdown duration
    ' for the timerLight shapes on both the Slide Master and Title Master
End Sub

Linked video countdown: DufJeopardy.bas supports linked MP4 countdown shapes named CountdownVideo. Normal question slides use a manually started 10-second countdown. The Final Jeopardy intro/category slide has no countdown; the Final Jeopardy prompt slide uses an automatically started 30-second countdown. Daily Double target questions are switched to an automatically started 30-second countdown after the wager is entered. Clicking a red Incorrect button deducts the score and rewinds the current countdown for the next buzz-in; the host can start it again by clicking the video. A green Correct button stops and rewinds the video.

To wire it into a deck:

  1. Put countdown_10s_1x1.mp4 and countdown_30s_1x1.mp4 in the same folder as the .pptm
  2. Add and position one linked video shape named CountdownVideo on a question slide
  3. Run InstallLinkedCountdownVideos() to recreate linked countdown video shapes on slides that have JeopardyTheme

If the deck folder moves and PowerPoint loses the media links, keep both MP4 files beside the .pptm and rerun InstallLinkedCountdownVideos().

Excel Template Format

Questions should be formatted in Excel as:

  • Column A: Category Name
  • Column B: Point Value
  • Column C: Question Text
  • Column D: Answer Text
  • Column E: Additional Comments

Template Files:

  • VAY_Bible_Challenge_Practice.xlsx - Fill out 5 categories instead of 6 for official competitions

๐Ÿ“ Repository Structure

vaybc/
โ”œโ”€โ”€ VBA/
โ”‚   โ”œโ”€โ”€ DufJeopardy.bas               # Main game logic (shared by both templates)
โ”‚   โ”œโ”€โ”€ TimerModule.bas               # Experimental VBA countdown timer
โ”‚   โ”œโ”€โ”€ copying.bas                   # AGPL-3.0 license text
โ”‚   โ””โ”€โ”€ AdjustScoresBox.frm/.frx      # Manual score adjustment dialog
โ”œโ”€โ”€ PowerPoint_Files/
โ”‚   โ”œโ”€โ”€ VAY_Bible_Challenge_Official3teams.pptm    # 3 players, 5 categories
โ”‚   โ”œโ”€โ”€ VAY_Bible_Challenge_Practice8players.pptm  # 8 players, 6 categories
โ”‚   โ”œโ”€โ”€ countdown_10s_1x1.mp4                      # Linked normal-question countdown video
โ”‚   โ””โ”€โ”€ countdown_30s_1x1.mp4                      # Linked Final Jeopardy/Daily Double countdown video
โ”œโ”€โ”€ Templates/
โ”‚   โ””โ”€โ”€ VAY_Bible_Challenge_Practice.xlsx    # Fill out 5 categories instead of 6 for official competitions
โ”œโ”€โ”€ Documentation/
โ”‚   โ””โ”€โ”€ Bible_Challenge/
โ”‚       โ””โ”€โ”€ MakingBCQuestions.md      # Guide for writing "irrefutable" trivia questions
โ”œโ”€โ”€ docs/
โ”‚   โ””โ”€โ”€ images/                       # Screenshots and diagrams
โ””โ”€โ”€ README.md

๐ŸŽฎ Game Rules & Scoring

Template-Specific Rules

Official VAY Bible Challenge Rules

  • 5 Categories: Old Testament, New Testament, Characters, Geography, Prophecy
  • Point Values: $100, $200, $300, $400, $500 per category, with double the value for Round 2
  • 3 Teams Maximum: Compliant with VAY competition regulations
  • Daily Doubles: 1-2 per game, randomly placed in categories 1-5
  • Final Jeopardy: All teams participate with wagering

Practice Template Rules

  • 6 Categories: Includes an additional category for comprehensive training
  • Point Values: $100, $200, $300, $400, $500 per category, with double the value for Round 2
  • 8 Teams Maximum: Full training environment
  • Daily Doubles: 1-2 per game, randomly placed in categories 1-6
  • Final Jeopardy: All participating teams wager

Scoring System

  • Correct answers add points
  • Incorrect answers subtract points
  • Daily Double scoring based on the team's wager
  • Final Jeopardy uses individual team wagers

๐Ÿ”ง Troubleshooting

Common Issues

Macros not working:

  • Ensure macros are enabled: File > Options > Trust Center > Macro Settings
  • Check if VBA references are intact

Excel import failing:

  • Verify Excel template format matches expected structure
  • Check for special characters in questions/answers

Debug Mode

Enable debug output by adding to VBA:

Debug.Print "Current player: " & player
Debug.Print "Score change: " & direction * iSlideValue

๐Ÿ“ Contributing

We welcome contributions! Please:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit changes (git commit -m 'Add AmazingFeature')
  4. Push to branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Development Guidelines

  • Document all VBA functions with comments
  • Test changes on multiple PowerPoint versions
  • Update documentation for new features
  • Follow existing naming conventions

๐Ÿ“œ License & Credits

Original Work

Created by Kevin Dufendach (2009-2016)

  • Original Jeopardy PowerPoint Template by krd.public+Jeopardy@gmail.com on http://sites.google.com/site/dufmedical (defunct) Updated by VAY (2022-present)
  • Rev.2022 by Bumble:
    • Reduced fonts, made it 5 columns (by moving the 6th off screen), changed title from โ€œJeopardyโ€ to โ€œBible Challengeโ€
    • Added JeopardyTheme.mp3, Time-Up.wav to Slide Master Prompt & Final Jeopardy. JeopardyBoardFill.wav sound effect will play when you mouse-over the title screen (music files must be in the same folder)
    • Coded replacement of โ€œ~โ€ in Excel import file to a new paragraph after โ€œ=======โ€œ so that translation could be added more easily
    • Coded an Audit Trail of scoring on the last slide to support dispute resolution
    • Moved players 5-8 off-screen to make the 4 players version, then moved player 4 off-screen to make the 3 players version
  • Rev.2023:
    • Hanh added โ€œGLA SBC WCCโ€ to the Master Slides 1&2 for Player 1, 2, 3 labels. Note: Replace the content of the text, do NOT delete the TextBox, and create a new TextBox
    • Bumble added the Final Jeopardy button in the Round 1 Board, Rules button, and distributed the music to each slide to make it more suitable for multimedia questions
    • Hanh modified Final BC Topic: Change Prompt to Topic, change Response to Final Prompt, add music, and Final Answer after the music stops
    • Bumble adjusted the Daily Doubles for 5 columns, added a check for duplicates
  • Rev.2025:
    • Bumble created a GitHub for it.

License

This project is licensed under the GNU Affero General Public License v3.0 or later.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

See LICENSE file for full terms.

VAY Modifications

Modified for VAY Sports Ministry Bible Challenge 2025

Official Template:

  • Reduced to 5 categories (compliance with VAY rules)
  • Limited to 3 players maximum
  • Streamlined interface for competition use

Practice Template:

  • Maintained full 6 categories and 8 players
  • Complete training environment
  • Preparation for competition scenarios

Both Templates:

  • Customized for Bible-themed content
  • Enhanced audit trail and scoring
  • Shared VBA codebase for consistency

๐Ÿค Acknowledgments

  • Kevin Dufendach for the original Jeopardy PowerPoint template
  • VAY Sports Ministry for sponsoring the Bible Challenge competition
  • Community contributors who helped customize and test the system

๐Ÿ“ž Support

For questions about this implementation:

  • Open an issue in this repository
  • Contact VAY Sports Ministry technical team

๐ŸŽฏ Future Enhancements

  • Wire the linked MP4 countdown into the production .pptm decks, see issue #2
  • "Revert" Button to revert the scoring should the judges approved a challenge

Built with โค๏ธ for VAY Sports Ministry Bible Challenge

About

VAYBC is a comprehensive Jeopardy-style game PowerPoint template and VBA code that's been customized for Bible Challenge competition at VAY Sports Fest

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages