MX Bikes Memory Reader Plugin 2 (MXBMRP2)

A plugin for MX Bikes that displays event and server information directly on the in-game screen.

MXBMRP2 leverages the game's plugin system and memory reading to display a customizable HUD in-game.

This information can be useful to let people know what bike or server you're on when sharing your screen or streaming, for example.

This plugin is in early development and may contain bugs or incomplete features. If you encounter any issues or have suggestions, please report them on the Issues page. Feature- and/or pull requests are also welcome!

Installation

Download the latest plugin package (e.g., mxbmrp2-<verion>.zip, not the source code) from the releases page and extract the contents to your MX Bikes plugins folder, typically located at:C:\Program Files (x86)\Steam\steamapps\common\MX Bikes\plugins\).

Your directory should look like this:

MX Bikes\
│   mxbikes.exe
│   mxbikes.ini
│   ...
│
└───plugins\
    │   mxbmrp2.dlo
    │
    └───mxbmrp2_data\
            FontFix_CqMono.fnt
            mxbmrp2.ini

For additional installation help, see the below video:

mxbmrp2.mp4

Configuration

Optionally, you can customize the mxbmrp2.ini configuration file to suit your preferences.

Below is a brief description of the available fields within the Draw configuration section that you set to true to enable:

Field	Example	Notes
plugin_banner	mxbmrp2 v0.9.3
race_number		Prefixed to rider_name
rider_name	4 Thomas
category	MX2 OEM
bike_id	MX2OEM_2023_KTM_250_SX-F
bike_name	KTM 250 SX-F 2023
setup	Default
track_id	HM_swedish_midsummer_carnage_2
track_name	HM | Swedish Midsummer Carnage 2
track_length	965 m
connection	Host	Offline means you're in testing, Client means you're connected to a remote server and Host means that you are hosting a server locally.
server_name	thomas4f
server_password	verySecret
server_location	Europe	The server location as indicated by the administrator.
event_type	Race
session_state	Warmup
conditions	Clear
air_temperature	20°C

Toggle HUD display

Press CTRL+R to toggle the HUD on or off. This will also reload any changes made to the configuration file.

Position of the HUD

You cannot adjust the HUD position or other settings directly within the game interface. However, you can customize its position by editing the configuration file and toggling the HUD on and off using the CTRL+R shortcut.

Here's how to adjust the HUD position:

• The HUD position is specified using normalized values between 0.0 and 1.0.
• position_x controls the horizontal placement (from the left) and position_y controls the vertical placement (from the top).
• To position the HUD (roughly) on the center of the screen, set position_x=0.5 and position_y=0.5.
• Setting either value to 1.0 or greater will likely move the HUD outside the viewable area, depending on your screen resolution.

Font size and colors

Here are some examples on how to configure the other settings:

• You can adjust the font size by modifying the font_size parameter in small increments. Increasing the value from 0.025 (the default) to 0.050 will double the size.
• font_color and background_color are specified in ABGR (Alpha, Blue, Green Red), meaning that:
  • Red = 0xFF0000FF,
  • Green = 0xFF00FF00, and
  • Blue = 0xFFFF0000.
• To make the background fully transparent, set it to 0x00000000, for fully black, use 0xFF000000.

Font Family

By default, the plugin uses the CQ Mono font to stay consistent with the MaxHUD plugin.

MX Bikes also makes heavy use of the Enter Sansman Italic font, which is included as an alternative.

Note that unlike the other settings, changing the font family requires a restart of the game.

To generate additional fonts, you can use the fontgen utility provided by PiBoSo. For details, see this forum post and refer to fontgen.cfg.

Notes

Custom Data Handling

The game's plugin system lacks certain fields (e.g., whether you’re in testing, or if you're a host or client, and a few other things). Instead, this data is extracted from memory. This seems to work well, but let me know if you run into issues.

Credits

• My previous iteration of MXBMRP (stand-alone Python app) for the memory addresses.
• CQ Mono Font designed by Chequered Ink.
• Enter Sansman Font designed by Digital Graphic Labs.
• @TokisFFS for early testing.