OBS: Project MB (v5)

Comprehensive setup guide and technical reference for Project MB: Valorant Scoreboard 2026.

About Project MB

Project MB is an open-source data tool designed to bridge the gap between grassroots community esports and high-tier professional broadcasts. By connecting live OBS graphic overlays to an external Google Sheets control panel, a broadcast producer can seamlessly update scoreboards, rosters, and stats in real-time.

Riot Games Legal Disclaimer: Project MB was created under Riot Games' "Legal Jibber Jabber" policy using assets owned by Riot Games. Riot Games does not endorse or sponsor this project. All custom files not owned by Riot Games are open source and free to adapt for other purposes.

How do Project MB scoreboards work?

Capturing the Scoreboard

Project MB captures the in-game Valorant scoreboard with gameplay elements dynamically removed. This requires a secondary computer on the lobby referred to as the "Void PC".

When loading into the match on the Void PC, the observer enters free cam mode (pressing V) and flies straight downward outside the map skybox. This results in a clean, solid black screen where no map geometry, abilities, or player highlights interfere with the scoreboard screen capture.

Technical Background

The screen capture of the Valorant scoreboard, timer, team scores, and agent info is piped to OBS. Using the OBS Source Clone plugin, we create clones of this single capture source. By applying precise cropping parameters and custom filters to each clone, the system isolates individual assets (like individual agent portraits, team numbers, and round indicators) and integrates them into custom designed overlay graphics.

Installation & Prerequisites

Ensure your production environment meets the following requirements before executing the tool:

Environment Requirements

Font Installation

Crucial Step: Locate Tungsten-Bold.ttf in the PMB Graphics assets folder and install it on your PC before launching OBS Studio so text layers map correctly.

Google Sheets API Configuration

To control the overlay elements from Google Sheets, you must generate access credentials:

Step 1: Google Sheet Preparation

Access the default Project MB Production Sheet. Navigate to File > Make a copy (ensuring you select scripts to preserve reset button macros). Under the Share options, set the document link to "Anyone with the link can view".

Step 2: Google API Key Creation

  1. Go to the Google Cloud Developer Console.
  2. Create a new project (e.g., Project MB Production) and configure the OAuth consent screen. You can skip the deployment registration as it remains local.
  3. Select Credentials in the left sidebar, click + Create Credentials, and select API Key. Copy the key.

Step 3: Importer Tool Configuration

Open the extracted Google Sheets Importer directory, run install.bat, and open the config-dist.json file in a text editor to update these values:

{
  "spreadsheetId": "YOUR_SPREADSHEET_ID_FROM_URL",
  "tableName": "Interface",
  "range": "C2:D",
  "apiKey": "YOUR_GOOGLE_CLOUD_API_KEY",
  "obsAddress": "ws://localhost:4455",
  "obsPassword": "YOUR_OBS_WEBSOCKET_PASSWORD"
}

Save this configuration file as config.json.

OBS WebSocket Setup

Inside OBS Studio, select Tools > WebSocket Server Settings. Check Enable WebSocket Server, verify the port matches your config.json (default 4455), and save settings.

Launch the integration by double-clicking start.bat in the importer directory. The command prompt should launch and confirm: "Connected to OBS".

Default Scene Collection

The standard scene package includes presets optimized for match workflows:

  • Tutorial Scene: Used to verify text binding and script triggers.
  • Intermissions: Stream start, countdown breaks, stream end, and technical timeout screens.
  • Desk & Guests: Split-layouts with custom borders for talent panels.
  • Map Bans: Dynamic selectors that toggle status indicators for maps.
  • Agent Select: Highlighting agent picks utilizing Magnum video loops.
  • Valorant Overlay: Clean top overlays (Top Complex, Top Simple, or Top Hybrid formats) featuring the live crop-filtered scoreboard.