A free, open-source plugin for MX Bikes, GP Bikes, and Kart Racing Pro with customizable on-screen displays, immersion features, social tools, and streaming/broadcasting overlays.

Default HUD layout. All elements are fully customizable - see Tips & Tricks for setup ideas.

Features

• Racing: Live standings, timing, gap bar, track map, radar and online records
• Social: Steam friends, Discord Rich Presence and tracked riders
• Progress: Stats, personal bests, achievements and FMX trick scoring
• Layout: Customizable HUDs with themes, hotkeys and auto-switching profiles
• Analysis: Lap analysis with splits, a delta trace, telemetry and fuel tracking
• Immersion: Spotter voice, first-person helmet overlay and controller rumble
• Streaming: OBS overlay, auto-director, controller visualization and companion window
• Modding: Moddable themes, fonts, icons and web overlay styling

Get Started

Quick Start

1. Download the installer above and run it
2. Launch the game and load a track
3. Move the mouse to bring up the pointer, then right-click and drag to reposition elements
4. Press Tilde (~) or click the settings button to toggle elements, adjust opacity, and more

The installer isn't signed yet, so Windows will warn about an "unknown publisher" - why & how to proceed.

Contents

• Installation
• Controls
• Configuration
• HUDs & Widgets
• More Features
• Tips & Tricks
• Advanced Settings
• Modding
• Troubleshooting
• Privacy
• Feedback & Issues
• Uninstallation
• Development
• License
• Acknowledgments
• About

Installation

Requirements:

• MX Bikes beta21 or newer / GP Bikes beta22b or newer / Kart Racing Pro Release 14 or newer

Automatic Installation

1. Download the latest installer mxbmrp3-Setup.exe
2. Run the installer - it finds your MX Bikes, GP Bikes and Kart Racing Pro installations (Steam or standalone), lets you pick which to install for, puts the files in each one's plugins\ folder, and keeps your settings on an upgrade

Manual Installation

1. Download the latest release archive mxbmrp3.zip

2. Find your game's plugins folder:

   • Steam: Right-click the game in your library > Manage > Browse local files > open plugins
   • Standalone: Navigate to your game installation folder (e.g., C:\Program Files\[Game]\) > open plugins

3. Extract the plugin files:

   • Copy the DLO for your game to the plugins\ folder:
     • mxbmrp3.dlo for MX Bikes
     • mxbmrp3_gpb.dlo for GP Bikes
     • mxbmrp3_krp.dlo for Kart Racing Pro
   • Copy the mxbmrp3_data\ folder to the plugins\ folder
   • Do not delete the game's own files (proxy64.dlo, proxy_udp64.dlo, xinput64.dli, or telemetry64.dlo for GP Bikes) - they are native game files, not old plugin versions

   Your directory should look like this after installation (files vary slightly by game):

   [Game]/
   │   mxbikes.exe / gpbikes.exe / kart.exe
   │   ...
   │
   └───plugins/
       ├── mxbmrp3_data/        ← Add this folder (from release)
       ├── mxbmrp3.dlo          ← Add this (MX Bikes only)
       ├── mxbmrp3_gpb.dlo      ← Add this (GP Bikes only)
       ├── mxbmrp3_krp.dlo      ← Add this (Kart Racing Pro only)
       ├── proxy_udp64.dlo      ← Keep (native game file)
       ├── proxy64.dlo          ← Keep (native game file)
       ├── xinput64.dli         ← Keep (native game file)
       └── telemetry64.dlo      ← Keep (GP Bikes only)
   

After Installation

Launch the game and load a track - a few elements are on by default, so the HUD appears right away. If nothing does, see Troubleshooting.

Controls

Mouse

• Move Mouse - Show mouse pointer and settings button (auto-hides after inactivity)
• Left Click - Interact with settings menu and HUD elements
• Right Click & Drag - Reposition elements
• Left Click a rider - On the Map, Standings, Event Log or Charts HUD, switch the spectate camera to that rider

Keyboard Shortcuts

Keyboard and controller hotkeys can be customized in Settings > Hotkeys. By default, only the settings menu hotkey is configured:

• Tilde (~) - Toggle settings menu. It is the key left of 1 on the number row, so on a non-US layout it may be marked ` or § rather than ~

Configuration

The plugin is active in-game only - it does nothing in the main menus, so all configuration happens on track.

Hover over any setting for a tooltip explaining what it does.

Auto-save (Settings > General) writes your changes when you leave the track. To save sooner, use the Save button at the bottom of the menu - it lights up whenever you have unsaved changes.

The settings menu provides global settings that apply to all profiles, followed by per-element tabs for the individual HUDs and widgets. The per-element tabs list the most-used first; the rest open from the More row at the bottom:

Plus a tab for each individual HUD, and one shared Widgets tab covering every widget.

Profiles

Four separate profiles store complete HUD layout configurations:

• Practice - Practice and warmup sessions
• Qualify - Pre-qualify, qualify practice, and qualify sessions
• Race - Race 1, Race 2, Straight Rhythm sessions
• Spectate - Spectating or viewing replays

Auto-switch (Settings > General) changes profiles for you as the session type changes.

HUDs & Widgets

HUDs are the larger data displays - each gets its own settings tab with options like column/row toggles, gap modes, and textures. Widgets are simpler, single-purpose readouts (one number, gauge, or dial); rather than a tab each, they're configured together under the shared Widgets tab, a row apiece for visibility, title, texture, opacity and scale (the two that belong to a feature - the Director's status button and the Spotter's subtitles - sit on that feature's own tab instead).

Widgets

HUDs

More Features

Each of these has its own switch in the settings menu.

Web Overlay

Turn on Web server (Settings > General) and the plugin serves a live browser overlay: a standings tower, event log, rider focus card, and periodic broadcast panels (fastest-lap boards, a "down the order" rundown, and on-track battles). Point an OBS Browser Source at http://localhost:8080 (the address is in the row below the setting, a clickable link while it is serving), or just open it in a browser. Colors and fonts follow your in-game settings, and a gear icon on the overlay sets tower size, filters and the rest per browser. Full guide: Web overlay.

Achievements (MX Bikes only)

Settings > Achievements: a hundred-odd milestones, Bronze to Platinum, for riding, racing, freestyle, jumping and for trying out the plugin itself. A toast marks each tier earned, and a halfway card the long steps to Gold and Platinum (Toasts > Visible turns the cards off; tracking continues either way). They read your existing stats, so an install starts with whatever its numbers already earn. A few are hidden until you stumble on them, and the ones about things going wrong have their own page, outside the completion figures.

Take every counted one to Platinum and a Prestige button appears, trading the whole ladder back - achievements and their counters to zero - for a level and the Prestige badge widget, which you then turn on under Widgets. Personal bests are untouched; there is no way back, so it asks twice. Full list: Achievements.

Spotter (voice callouts)

Turn on Spoken audio (Settings > Spotter, or the checkbox beside the tab) and the plugin talks to you while you ride: riders behind or alongside you, blue flags, a rider down, and - each time you cross the line - your position and the gaps ahead and behind. Windows text-to-speech reads it out of the box, with TTS voice, Speed and Volume to choose how; recorded voice packs are a separate download. Five Callouts switches decide what gets announced, and Subtitles puts every call on screen so you can run it silent. It follows whoever you're watching, so it works while spectating and in replays. Full guide: Spotter voice.

Auto-director (spectating & replays)

Turn on the Director (Settings > Director, or its camera-icon status button) and it automatically cuts the spectate camera to the most interesting rider or battle, broadcast-style, so you don't have to switch riders by hand. It works while spectating live and in replays - a great way to re-watch or record a session and let it direct the action for you. It also drives the Web Overlay's battle panel.

Second-monitor HUD (Companion window)

Set HUD display (Settings > Appearance > Companion window) to Companion or Both to open a standalone window you can drag and maximize on a second monitor. Each HUD keeps its own on/off state and position there (drag or toggle it while your mouse is over that window), so you can run a minimal in-game layout and a full dashboard on the second screen at once.

Companion bg sets what is behind the HUD in that window. Set it to Green, Blue or Magenta to put just the HUD over your game in OBS: add a Window Capture of [mxbikes.exe]: MXBMRP3 and give it a Chroma Key filter with the same Key Color Type. Pick a colour your HUD does not use, since the filter removes it from the HUD too.

Track records

The Records HUD fetches online lap records from CBR or MXB-Ranked. Turn on Auto-fetch (Settings > Records) to load them when you enter a track. Records also work while spectating.

Custom segment timing (training tool)

Bind the Segment + and Segment - hotkeys (Settings > Hotkeys) to drop timing points on the track as you ride. Drop two and the Timing HUD times the section between them - live, with a delta to your best for it - so you can drill a single corner or rhythm section without completing a full lap. Remove the points to return to normal split/lap timing.

See where friends are racing

Steam (Settings > General) is on by default on the Steam build. It broadcasts your session to friends and populates the Friends HUD: which of your Steam friends are in-game, the server and track they're on, and who's joined your session.

Tips & Tricks

Streaming setup

• Session info - turn on the Session HUD (Settings > Session) to show the server name, track, and session format on screen for your viewers.
• Pitboard and Gamepad - both widgets have fully customizable textures, and the Gamepad widget shows your live controller inputs.
• Discord (Settings > General) - Rich Presence shows your current session and track in your Discord profile.
• Stream chat in game (Settings > Stream Chat) - your Twitch and YouTube chat together on screen. Enter your Twitch channel and/or YouTube @handle, press Enter, and switch each Status on. Read-only, no login.
• Broadcast overlay - for a browser/OBS overlay with standings and battles, see Web Overlay.
• Just the HUD over your game - set Companion bg (Settings > Appearance > Companion window) to Green, Blue or Magenta and key it out in OBS, see Second-monitor HUD.

Power-user INI tweaks

More options are available by editing the INI file directly. It is organized by HUD section, and each section takes per-element color and font overrides. Colors use ABGR hex values; fonts use the font filename (without .fnt) of any file in the fonts/ folder. For example:

[StandingsHud]
classicLayout=1            ; remove number plates and brand color strips

[SpeedWidget]
color_primary=0xff00ff00   ; green text (ABGR format)
font_title=RobotoMono-Bold ; Roboto Mono Bold font

Use the Color Override Picker to convert RGB colors to ABGR format. See Advanced Settings for how to edit and hot-reload the INI file.

Getting the most FPS

Biggest wins first:

1. Turn on Direct GL (Settings > General) - the plugin draws the HUD itself instead of handing every piece of it to the game
2. Set Panel theme to None (Settings > Appearance) - a theme puts artwork behind every panel
3. Turn off Drop shadow (Settings > Appearance) - every shadowed string is drawn twice
4. Turn down Detail, and slim or turn off Track outline (Settings > Map) - the track ribbon is the plugin's largest single piece of drawing
5. Turn off what you don't use (the checkbox beside each tab, or the Visible column in Settings > Widgets) - a hidden element builds and draws nothing

Beyond the plugin: every other plugin in your plugins folder works every frame whether you use it or not, so removing ones you don't need is often the biggest win of all.

Experimental: run the plugin on its own thread

By default the plugin does its work during the game's frame. Set pluginThread=1 in the [Advanced] section of the INI file to move the plugin's HUD building and event handling onto a separate thread, so a heavy HUD rebuild can't cost you frames. It's experimental - try it if you're chasing the smoothest possible frame times. Toggle it live with the Reload hotkey.

Game settings that pair with the plugin

These three are the game's own settings, not the plugin's.

Remove the stock pitboard

Create an empty file called pitboard.cfg in [Game]\misc\hud\ (create the directories if needed). This removes the default 2D pitboard while keeping the small 3D pitboard in the game world. Delete the file to restore it.

Show/hide the rider stand icon

Turn on Show Rider Stand (Simulation). To customize the icon or its position, extract rider.cfg and riderstand.tga from misc.pkz\misc\helpers\ to [Game]\misc\helpers\ and edit them there.

Show/hide the game's native gear indicator

Turn off Show HUD (Simulation) if you'd rather use the plugin's Gear widget instead. To customize the graphics or position, extract gear.tga, hud.cfg, LCD.fnt, and switch.tga from misc.pkz\misc\hud\ to [Game]\misc\hud\ and edit them there.

Advanced Settings

All plugin settings are stored in mxbmrp3_settings.ini in your user data folder.

Most settings are in the in-game menu; the power-user ones are INI-only, and carry inline comments there.

INI structure:

• [HudName] - Base/default settings for a HUD
• [HudName:Practice], [HudName:Qualify], [HudName:Race], [HudName:Spectate] - Profile-specific overrides (only values that differ from base)

Editing the INI file: the simple way is with the game closed - edit mxbmrp3_settings.ini, then launch. To hot-reload while the game is running:

1. Turn off Auto-save (Settings > General), or it writes your in-game state back over the edits when you leave the track
2. Edit the INI file
3. Use the Reload hotkey to apply changes (bind it in Settings > Hotkeys)

Modding

Put your files in Documents\PiBoSo\[Game]\mxbmrp3\, never in the install folder ([Game]\plugins\mxbmrp3_data\): bundled files there are overwritten on update, while anything in Documents survives it. The web overlay's custom.css goes there too - you create that one yourself.

Fonts, textures and icons are loose files in their own subfolders. Themes, gamepad packs, pit boards, gauges and spotter voices are packs - a folder holding that pack's art or audio plus a <type>.ini describing it (theme.ini, gamepad.ini, pitboard.ini, gauge.ini, spotter.ini - a fixed name, so copying a pack and renaming the folder is the whole job). Every pack's ini opens with the same [pack] section, and base = <pack> layers yours over a shipped one so a reskin is one or two files. Both kinds sync to the plugin on startup, and your choice is stored by folder name, so adding or removing other packs never reassigns it.

• Modding guide - the folder layout, panel themes, textures, gamepad, pit board and gauges packs, fonts, icons, and the web overlay's HTML/CSS/JS.
• Spotter voice - what it calls, how to set it up, and how to reword it or record your own voice.
• Web overlay - the OBS browser source, the overlay's own settings panel, and where they are saved.
• FMX tricks - every trick the FMX HUD recognises, what it takes, what it is worth, and how a chain multiplies.

Data Files

Troubleshooting

Windows Warns Me When Downloading or Installing

The installer isn't code-signed yet, so Windows may show one or more "unknown publisher" / "not commonly downloaded" warnings. These are reputation warnings about the unsigned installer and its low download count, not a malware detection. Depending on your browser you may see up to three, in this order:

• Downloading (browser): "isn't commonly downloaded." In Microsoft Edge: open Downloads, click the ... next to the file, then Keep > Show more > Keep anyway (Chrome is similar).
• Running the installer (Windows SmartScreen): a blue "Windows protected your PC" box - click More info > Run anyway.
• Installing (User Account Control): "...app from an unknown publisher..." - click Yes. Admin is required because the plugin is copied into the game's plugins\ folder under Program Files.

Installing manually from the ZIP archive avoids most of these, since there's no installer to run. If you'd like to check the download anyway, you can scan it on VirusTotal.

Make Sure You're on the Latest Version

• Many issues are already fixed in a newer release, so update before troubleshooting further
• Check your version in Settings > Updates (or the Version widget) and install a newer one from there - no manual download or reinstall needed. The plugin also notifies you on startup when a stable release is out
• If the in-game updater is set to Off or unavailable, download the latest release manually from GitHub Releases and reinstall

HUD Not Appearing

• Check the Installation requirements for your game's minimum version
• Verify the DLO file and mxbmrp3_data\ are in the correct plugins\ folder. Games have two directories - the game installation (contains the game .exe) and user data (Documents\PiBoSo\[Game]\). Plugins go in the game installation, not Documents.
• Use the DLO for your game: mxbmrp3.dlo (MX Bikes), mxbmrp3_gpb.dlo (GP Bikes) or mxbmrp3_krp.dlo (Kart Racing Pro) - see manual installation

Installer Detected the Wrong Game Directory

• If you have multiple installations (e.g., standalone and Steam), the installer may pick the wrong one. Verify the plugin ended up in the plugins\ folder next to the game .exe you actually launch. If not, run the installer again and select the correct path, or install manually.

Text or Icons Not Appearing

• The plugin shows "MXBMRP3 is not installed correctly" in block letters when it finds no fonts or icons
• mxbmrp3_data\ holds the fonts, textures and icons, and must sit in plugins\ beside the DLO (see directory structure)
• If you moved or renamed it, restore it from the release archive

Gamepad Widget Appears Cut Off

• Click Reset Widgets (Settings > Widgets) to correct the button positions

Elements Appearing Twice (Ghost/Duplicate)

• Check for duplicate MXBMRP3 DLO files - only the one for your game should exist in your plugins folder. Other plugins' DLO files are fine.

Controller or Rumble Not Working

• Verify the correct Controller is selected (Settings > General)
• If you accidentally deleted xinput64.dli from the plugins folder, controller input may stop working
• To restore: verify game files integrity (Steam) or reinstall the game

Web Overlay Not Working

• If Web server reads Error (Settings > General), the plugin couldn't open the port - usually because another application already has it
• Change Web server port (Settings > General) to a free one (e.g., 8081). When it's serving, the row below turns into a clickable http://localhost:<port> link
• Remember to update your OBS Browser Source URL to match the new port

Stream Chat Shows Unavailable

• YouTube chat is read through YouTube's public web chat without an API key, which is unofficial: when YouTube changes it, the chat panel shows Unavailable, the YouTube Status (Settings > Stream Chat) reads Can't read, and its chat can't be read
• Twitch chat is unaffected. The plugin is not affiliated with Twitch or YouTube

Game Fails to Launch, Crashes, or Shows Black Screen

• See the MX Bikes Troubleshooting Guide for general game issues (crashes, mods, plugins, RAM, controllers)
• If the Windows Event Log shows mxbmrp3.dlo as the faulting module, see Feedback & Issues

Privacy

The plugin sends a small anonymous ping per game launch, so the developer can see how many people use it, which features are worth keeping, and what needs fixing. It is on by default. The installer asks before anything is sent: untick Participate in the anonymous usage survey on its Privacy page and the plugin starts with it off. You can change it at any time with the Usage survey toggle (Settings > General). Turning it off sends one final anonymous opt-out ping, then nothing more.

Turning it off doesn't disable anything else; the plugin works exactly the same. The one difference: the plugin catches crashes in the game itself, which is what the known-crash list is built from, and with the usage survey off yours stop being reported automatically. The crash files are still written to Documents\PiBoSo\[Game]\mxbmrp3\crashes\, so you can still attach them to a bug report.

What it sends:

What it does not send: no names, no in-game/online activity, no telemetry, no lap times, no server or rider data, and no crash dump or log (those stay on your machine) - nothing identifying. The pings are fire-and-forget and never affect performance.

Usage-survey data is processed by two open-source services: Aptabase handles the detailed events above, and GoatCounter receives a single per-launch hit as an aggregate headcount. Both are covered by the one Usage survey toggle.

When the usage survey is on, the plugin may also fetch a small config file from this repository that can only ever reduce what's sent, never add to it. Turning the Usage survey toggle off stops this too.

What the data actually adds up to: the aggregate results are published as an interactive page (also usage_survey/REPORT.md in the repo) - installs, activity over time per game, version adoption, geography, feature/HUD popularity, and crash trends (grouped by which module faulted). It's generated straight from the anonymous pings described above, so you can see exactly what they amount to.

Feedback & Issues

Bug reports, feature requests, and questions are all welcome. Open an issue on GitHub or leave a comment on MXB-Mods.

A short description of what you were doing when the issue happened (track, session type, bike, and any reproduction steps) helps a lot.

For crashes, attach the matching pair - same timestamp and pid - written to Documents\PiBoSo\[Game]\mxbmrp3\crashes\ whenever the plugin catches an unhandled fault:

• mxbmrp3_crash_<timestamp>_<pid>.dmp - the minidump (state at the moment of crash)
• mxbmrp3_crash_<timestamp>_<pid>.log - a snapshot of the plugin log captured at crash time

The plugin catches any crash in the game, so these are usually faults in the game itself rather than plugin bugs. Check Known MX Bikes Crashes first - it lists the game-engine crashes the handler has caught, with Event Viewer fault offsets you can match against yours. A crash listed there is a known game bug with no plugin fix possible.

Uninstallation

Automatic Uninstallation

If you used the installer, remove the plugin like any other Windows app: open Settings > Apps > Installed apps (or Control Panel > Programs and Features), find MXBMRP3, and choose Uninstall. You can also run mxbmrp3_uninstall.exe directly from any game's plugins\ folder. The uninstaller lets you pick which games to remove from, then deletes the plugin DLO, the mxbmrp3_data\ folder, and the registry entry.

Manual Uninstallation

If you installed from the ZIP, delete the files you added from each game's plugins\ folder:

• the plugin DLO (mxbmrp3.dlo, mxbmrp3_gpb.dlo, or mxbmrp3_krp.dlo)
• the mxbmrp3_data\ folder

Leave the game's own files in place - proxy64.dlo, proxy_udp64.dlo, xinput64.dli, and telemetry64.dlo (GP Bikes). They are not part of the plugin.

Settings & Data

Both methods leave your settings, profiles, and stats untouched, so an upgrade or reinstall keeps them. To remove them as well, delete the per-game folder:

Documents\PiBoSo\[Game]\mxbmrp3\

---

Development

Built with C++17, Visual Studio 2022, the PiBoSo Plugin API, and Claude Code.

• DEVELOPMENT.md - building (Windows shipping build + Linux cross-build) and running the test suites
• CONTRIBUTING.md - how to report bugs and contribute changes (and how the public mirror works)
• TESTING.md - the layered test suite (unit / integration / specialized) and how to add a test
• ARCHITECTURE.md - full technical documentation with diagrams
• CLAUDE.md - quick-start context for developers and AI assistants

Quick start: clone, run cmake --preset msvc, then open the generated build/msvc/mxbmrp3.sln in Visual Studio 2022 and build.

License

Licensed under the MIT License. See THIRD_PARTY_LICENSES.md for bundled asset attributions.

Acknowledgments

• bh5o - Pitboard texture
• Husk - Gamepad widget source design files
• HornetMaX - MaxHUD, which served the MX Bikes community for over a decade

Thanks to everyone in the MX Bikes community who tested, reported bugs, and shared ideas.

About

MXBMRP3 is a community project: one person's spare-time work, and much of what it has become comes from the people who use it - the riders who report problems, suggest features, test new ideas and find new ways to use it.

It started in 2024, after development of MaxHUD, the community's long-standing HUD, came to an end. The first version, MXBMRP - MX Bikes Memory Reader Project, was a small experiment I built before I really knew what I was doing. That grew through several versions into MXBMRP3, a full plugin built on the game's plugin API.

Keeping MXBMRP3 open source is deliberate: it can be studied, changed and built on, and does not depend on me. It is free, with no paid tier, no locked features and no ads, and every release is built from the public source.

If MXBMRP3 makes the game a little better for you, or inspires something new, it has done what I hoped it would.

Say thanks

A comment or rating on mxb-mods, a star on GitHub or a coffee on Ko-fi helps. All optional.