A customizable, open-source HUD plugin for MX Bikes displaying real-time race information and telemetry.
Example HUD layout showing standings, map, telemetry, and widgets. All elements are fully customizable.
- Live race standings, track map, and proximity radar with approach alerts
- Lap timing with splits, personal bests, gap-to-PB visualization, and online lap records
- Track specific riders with custom colors and icons across all HUDs
- Controller rumble feedback with customizable effects (bumps, slide, spin, lockup, wheelie, etc.)
- Telemetry visualization and compact info widgets
- Drag-and-drop positioning with color themes and customizable hotkeys
- Automatic profile switching for Practice, Qualify, Race, and Spectate sessions
Download and install the plugin to begin customizing your HUD. Most users should use the automatic installer. Use the ZIP for manual installation.
See Installation for setup instructions.
Requirements:
- MX Bikes Beta 20 or newer
- Microsoft Visual C++ Redistributable (x64) (the automatic installer will check for this)
- Download the latest installer
mxbmrp3-Setup.exe - Run the installer - it will:
- Auto-detect your MX Bikes installation (Steam or standalone)
- Install to the correct plugins folder
- Check for and offer to install Visual C++ Redistributable if needed
- Handle upgrades automatically (preserves your settings)
-
Download the latest release archive
mxbmrp3.zip -
Find your MX Bikes plugins folder:
- Steam: Right-click MX Bikes in your library → Manage → Browse local files → open
plugins - Standalone: Navigate to your MX Bikes installation folder (e.g.,
C:\Games\MX Bikes\) → openplugins
- Steam: Right-click MX Bikes in your library → Manage → Browse local files → open
-
Extract the plugin files:
- Copy
mxbmrp3.dloto[MX Bikes]/plugins/ - Copy the
mxbmrp3_data/folder to[MX Bikes]/plugins/
Do NOT delete the existing game files (
proxy64.dlo,proxy_udp64.dlo,xinput64.dli) - these are native MX Bikes files, not old plugin versions.Your directory should look like this after installation:
MX Bikes/ │ mxbikes.exe │ ... │ └───plugins/ ├── mxbmrp3_data/ ← Add this folder (from release) │ ├── fonts/ ← Font files (.fnt) │ ├── textures/ ← Texture files (.tga) │ └── icons/ ← Icon files (.tga) ├── mxbmrp3.dlo ← Add this (from release) ├── proxy_udp64.dlo ← Keep (native game file) ├── proxy64.dlo ← Keep (native game file) └── xinput64.dli ← Keep (native game file) - Copy
Launch MX Bikes - the plugin will load automatically. Some elements are enabled by default and can be repositioned or configured via the settings menu. If nothing appears, see Troubleshooting.
- Move Mouse - Show cursor and
[=]settings button (auto-hides after inactivity) - Left Click - Interact with settings menu and HUD elements
- Right Click & Drag - Reposition elements
Keyboard and controller hotkeys can be customized in Settings > Hotkeys. By default, only the settings menu hotkey is configured:
- Tilde (below Esc) - Toggle settings menu
Use the settings menu (Tilde key or [=] settings button) to configure all HUDs and widgets. Hover over any setting to see its description - all controls have in-game tooltips explaining their function.
The settings menu provides:
- General - Profiles, preferences, grid snapping
- Appearance - Font categories and color theme customization
- Hotkeys - Keyboard and controller bindings
- Riders - Track specific riders with custom colors and icons
- Rumble - Controller vibration feedback effects
- Updates - Check for new versions and install updates in-game
- Individual HUD tabs - Per-element visibility, scale, opacity, and options
All settings are automatically saved between sessions.
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 (disabled by default) automatically changes profiles based on session type.
All HUD and widget settings are documented via in-game tooltips - hover over any control in the settings menu to see its description.
| HUD | Description |
|---|---|
| Standings | Live race positions with gaps, status, and tracked rider indicators |
| Map | Top-down track map with rider positions (click to spectate) |
| Radar | Proximity radar with approach alerts and distance arrows |
| Timing | Split and lap times with gap comparisons |
| Gap Bar | Visual gap-to-PB bar with position markers |
| Pitboard | Pitboard-style lap information display |
| Lap Log | Historical lap times with PB indicators |
| Ideal Lap | Best sector times and theoretical ideal lap |
| Records | Online lap records (CBR or MXB-Ranked) with personal bests |
| Telemetry | Throttle, brake, suspension graphs |
| Performance | FPS and plugin CPU usage |
| Rumble | Controller rumble effect visualization |
| Widget | Description |
|---|---|
| Lap | Current lap number |
| Position | Race position |
| Time | Session time/countdown |
| Session | Session type |
| Speed | Speed and gear |
| Speedo | Analog speedometer |
| Tacho | Analog tachometer |
| Bars | Telemetry bars (throttle, brake, clutch, RPM, suspension, fuel) |
| Fuel | Fuel calculator with consumption tracking |
| Lean | Bike lean angle with arc gauge |
| Notices | Race status notices (wrong way, blue flag, last lap, finished) |
| Gamepad | Controller visualization |
Add custom fonts, textures, and icons by placing files in your MX Bikes user data folder:
Documents/PiBoSo/MX Bikes/mxbmrp3/
├── fonts/ ← Custom .fnt files
├── textures/ ← Custom .tga textures
└── icons/ ← Custom .tga icons
On game startup, the plugin syncs these files to the plugin's data directory (plugins/mxbmrp3_data/). User files with the same name as bundled assets will override them. This keeps your customizations separate from the plugin installation, so updates won't overwrite your files. Restart the game after adding or modifying assets.
Textures use the naming convention {element_name}_{number}.tga (e.g., standings_hud_1.tga). They're auto-discovered and selectable via the Texture control in each HUD's settings.
Fonts (.fnt files) are auto-discovered and assignable to categories (Title, Normal, Strong, Marker, Small) in Settings > Appearance. To generate fonts, use the fontgen utility provided by PiBoSo. See this forum post for details. An example configuration is provided in fontgen.cfg.
Icons (.tga files) are discovered alphabetically and available for tracked rider customization.
Plugin data is stored in Documents/PiBoSo/MX Bikes/mxbmrp3/:
| File | Description |
|---|---|
mxbmrp3_settings.ini |
All HUD settings (positions, visibility, options) |
mxbmrp3_personal_bests.json |
Personal best lap times per track/bike/category |
mxbmrp3_tracked_riders.json |
Tracked riders with colors and icons |
HUD Not Appearing
- Check Installation requirements (MX Bikes Beta 20+, Visual C++ Redistributable)
- Verify
mxbmrp3.dloandmxbmrp3_data/are in the correctplugins/folder. MX Bikes has two directories - the game installation (containsmxbikes.exe) and user data (Documents\PiBoSo\MX Bikes\). Plugins go in the game installation, not Documents.
Black Screen on Game Startup
- Ensure the Visual C++ Redistributable (x64) is installed
- Restart your computer after installing - the runtime may not load until after a reboot
Elements Appearing Twice (Ghost/Duplicate)
- Check for duplicate
mxbmrp3.dlofiles - only ONE should exist in your plugins folder
Elements Overlapping
- Drag elements to reposition them
- Use settings menu to adjust scale
Controller Not Working
- If you accidentally deleted
xinput64.dlifrom the plugins folder, controller input may stop working - To restore: verify game files integrity (Steam) or reinstall MX Bikes
For bug reports or feature requests, open an issue on GitHub.
Built with C++17, Visual Studio 2022, MX Bikes Plugin API, and Claude Code.
CLAUDE.md- Quick-start guide for developers and AI assistantsARCHITECTURE.md- Comprehensive technical documentation with diagrams
Requirements: Visual Studio 2022+, Windows SDK 10.0, Platform Toolset v143
- Clone the repository:
git clone https://github.com/thomas4f/mxbmrp3.git cd mxbmrp3 - Open
mxbmrp3.slnin Visual Studio 2022 - Select Release configuration (or Debug for development)
- Build the solution (Ctrl+Shift+B)
- Output:
build/Release/mxbmrp3.dlo
Ideas under consideration (no guarantees): extended telemetry (g-force), event log, HTTP data export for OBS overlays.
Licensed under the MIT License. See THIRD_PARTY_LICENSES.md for bundled asset attributions.
Feedback and contributions are welcome.
