Support

Product: Race Deck: MX Bikes (Stream Deck plugin for MX Bikes on Windows) · Provider: GRAMSHIFT (Tokyo, Japan)

An independent product, not affiliated with or endorsed by PiBoSo. MX Bikes is a trademark of its owners.

Something not working? Email contact@gramshift.com and we will help you get it going.

Getting started

  1. Get the plugin from the Elgato Marketplace; the Stream Deck app adds it.
  2. Drag the keys you want from the plugin's category onto your Stream Deck.
  3. Open the settings of any key and press Install under Plugin file. The plugin finds MX Bikes in your Steam libraries and puts one small file, gramshift_mxbdeck.dlo, into the game's plugins folder. No administrator rights are needed. Close the game first.
  4. Start MX Bikes and ride. The keys show your bike as soon as you are on track.
  5. Optional: enter a Key to send in a key's settings (for example F13 or Ctrl+Shift+P) and give the same key to a control in the game's controls (for example a camera change or a reset). Pressing the Stream Deck key then presses that key in the game.

MX Bikes not installed through Steam? The settings page then shows the folder of the plugin file, %APPDATA%\Elgato\StreamDeck\Plugins\com.gramshift.mxbdeck.sdPlugin\bin\game, with an Open folder button: copy gramshift_mxbdeck.dlo from there into <MX Bikes folder>\plugins\ once.

Game on another PC, or Stream Deck on a Mac

The keys can show MX Bikes running on another Windows PC on your network: with Stream Deck on a second PC, or on a Mac.

  1. On the computer with Stream Deck, open the settings of a key and set Receive from to This PC and the network. Do the same for each key that should show the game on the other PC.
  2. Press Files for the game PC (under Plugin file). A folder opens with two files: gramshift_mxbdeck.dlo and gramshift_mxbdeck_net.txt, which holds this computer's address on your network.
  3. Copy both files into the plugins folder of MX Bikes on the game PC (with a USB stick or a shared folder), then start MX Bikes there. The Status line in the key settings says Reading MX Bikes over the network from and the game PC's address.

The keys listen on UDP port 41753. If another program uses it, enter another Port in the key settings and press Files for the game PC again. If Windows or macOS asks, allow Stream Deck on private networks. When the computer with Stream Deck gets a new address on your network, press Files for the game PC again and copy the new gramshift_mxbdeck_net.txt. Pressing a key sends a game key only to MX Bikes on the same Windows PC; with the game on another PC the keys show your ride.

Stream Deck +

Every key also works on a dial of Stream Deck +. The touch strip shows the key's main value with a line above it (for example the gear with your speed), and a bar for the revs, the fuel and the engine temperature. Pushing the dial or touching the strip sends the key's Key to send, the same as pressing the key.

The keys

KeyShowsSettings
Gear & RevsThe gear (N in neutral), the speed, and a rev bar up to the bike's limiter that turns from green to yellow to red near the top and flashes at the limiter.km/h or mph
Lap TimesThe lap you are on (LAP 2/5 in a race over laps; in a race of time and laps with the laps after the clock beside it, like LAP 6 · +2), the delta to your best lap at every split of the track (green when you are ahead of it, red when behind), the last lap and the best lap. Until there is a best lap: "no Δ yet". After a lap the game marks invalid: LAST LAP INVALID.Big number: delta to my best lap, or the current lap time
PositionYour place and the number of riders. In a race: the gaps to the riders ahead (▲) and behind (▼), and LEADER when you lead. A time penalty is shown in orange; DNS, RETIRED and DSQ when the game says so.—
SessionThe session (practice, qualifying, warmup, race 1, race 2), the time left (in a race of time and laps, with the laps after it, like +2 LAPS) or the lap of the laps (NO TIME LIMIT when the session has none), its state (SIGHTING LAP, PRE-START, IN PROGRESS, RACE OVER) and the weather.—
FuelFuel in the tank with a bar, the laps it lasts, and the fuel used per lap: the average of your last 3 laps ridden whole without a refill. Until then: "after one lap". In a race over laps, the laps line and the bar turn red when the fuel falls short of the finish and yellow with less than one lap to spare; in other sessions red under one lap and yellow under two.Litres or US gallons
Engine TempThe engine temperature with a bar and a colour against the alarm limits the game gives for your bike: COLD below the low limit, OK, and OVERHEAT (red key) from the high limit. Below it, the water temperature.°C or °F

Every key has the same press and data settings: Key to send, Only while the game is the active window (on by default), Game program (empty = mxbikes.exe) and Data name (empty = Local\GramshiftPiboso_mxbikes, the name the plugin file shares its data under; change it only if we ask you to), Receive from (This PC, or This PC and the network) and Port (empty = 41753).

Messages on the keys

MessageWhat it means
NO GAME · start MX Bikes / plugin file in?The live data is not there: MX Bikes is not running, or the plugin file is not in the game's plugins folder (see Getting started). The keys find the game within about a second after it starts.
LOADINGThe game is starting and has not shared its data yet.
NO EVENT · in the menuYou are in the game's menus.
IN THE PITS · ride to showYou are in the event but not on track.
REPLAYA replay is playing.
CRASHEDThe game says your rider has crashed.
PAUSED (dimmed key)The game is paused. The last values stay readable but dimmed.
STALE (dimmed key)The data has not changed for 3 seconds while the game says it is running: the game is loading, or stopped.
UNSUPPORTED · data changed / update plugin (red)The data does not fit the layout this version of the plugin reads, usually because the plugin file in the game is from another version. Open a key's settings: Plugin file then offers Update (close the game first). The keys show no numbers until then. If it stays, please tell us.
READ ERROR (red)Windows refused to let the plugin read the data. If you run the game as administrator, run the Stream Deck app the same way, or run both normally.

Questions

What does the plugin file do?

MX Bikes loads every plugin file in its plugins folder and hands it the live data of your ride, the same way it does for other dashboards. Ours copies that data into a block of memory on your PC that only this Stream Deck plugin reads, and changes nothing in the game. On its own it sends nothing over the network. Only when you put the address file from Files for the game PC next to it does it also send the same data to that one address on your network, about ten times a second.

How do I update or remove the plugin file?

Open the settings of any key: Plugin file says whether it is installed and up to date, with Update and Remove. Close the game first. Remove deletes only our file; the plugins folder and other plugins stay. Before you uninstall the Stream Deck plugin, press Remove; otherwise the file stays in the game folder (you can delete gramshift_mxbdeck.dlo there yourself).

Where does the delta come from?

From the game itself: at every split of the track MX Bikes gives the difference to your best lap, and the key shows it until the next split.

I press the key and nothing happens in the game.

Open the key's settings and read the Status line: it says the key that was sent, or why it was not. By default keys are sent only while the game is the active window. Give the same key to a control in the game's controls. If you run MX Bikes as administrator, Windows blocks keys from Stream Deck: start the game normally.

Does it press keys by itself?

No. One press of a Stream Deck key sends one key you chose, as if you pressed it on your keyboard. It never presses anything by itself and has no macros.

Requirements

Stream Deck app 6.9 or later on Windows 10 or later, or macOS 12 or later. MX Bikes on the same PC, or on a Windows PC on the same network.

Privacy Policy