Skip to content

Latest commit

Β 

History

History
111 lines (65 loc) Β· 3.32 KB

File metadata and controls

111 lines (65 loc) Β· 3.32 KB

MPVC Logo

Player Guide

How to use MPVC on a server that already has it installed.


MPVC requires access to your microphone. There are three ways to set this up β€” pick whichever suits you best.


Option 1 β€” Use your browser (no install)

The simplest option. No installation required, works on any PC.

How it works: Each time you want to talk, press the πŸŽ™οΈ button in-game. A browser window will open asking for microphone permission β€” click Allow, then minimize the tab. That's it.

This window needs to stay open (minimized is fine) for as long as you want to talk.

Best for: Players who join occasionally and don't want to install anything.


Option 2 β€” Install MPVC.exe βœ… Recommended

A lightweight app that runs in your system tray. Once installed, the game detects it automatically β€” no browser window, no extra steps.

Setup

1. Download MPVC.exe from the Releases page.

2. Run it. On first launch, it will ask:

"Would you like MPVC to start automatically with Windows?"

Click Yes β€” from then on, MPVC starts silently in the background every time you boot your PC, and BeamMP is launched automatically.

3. That's it. Next time you join a server with MPVC, the πŸŽ™οΈ button will work instantly β€” no prompts, no browser.

Tray icon: ⚫ gray = idle (mic off), 🟒 green = mic active

Windows SmartScreen warning: MPVC.exe is unsigned and built with PyInstaller, which causes some antivirus engines to flag it. This is a known false positive. Click More info β†’ Run anyway, or use Option 3 to build from source.


Option 3 β€” Build from source

Produces the exact same MPVC.exe as Option 2. Use this if you'd rather compile the code yourself and verify what you're running.

Requirements: Python 3.13+

cd MicBridge
build.bat

Output: MicBridge/dist/MPVC.exe β€” use it exactly like Option 2.

πŸ“– Step-by-step guide for beginners

Step 1 β€” Install Python

Download and install Python 3.13 from python.org.

During installation, check "Add Python to PATH" before clicking Install.

Step 2 β€” Download the repository

Click the green Code button on this page β†’ Download ZIP, then extract it anywhere.

Step 3 β€” Build

Open the extracted folder, go into MicBridge/, and double-click build.bat.

A terminal window will open and install everything automatically (~30 seconds). When done:

Build successful!  dist\MPVC.exe

Move MPVC.exe from MicBridge/dist/ to wherever you'd like to keep it, then follow Option 2 from Step 2.


In-game controls

Once you're set up, two buttons appear in your HUD:

Button Mode What it does
πŸŽ™οΈ Talk & Listen Opens your mic and lets you hear nearby players
πŸ”Š Listen Only Hear nearby players without opening your mic

Press the active button again to deactivate.

Nearby players panel

Indicator Meaning
🟒 Green dot Player's mic is open
Bold name Player is currently speaking
Strikethrough Muted by you (click to unmute)