RallyXAutoSplitter

RallyXAutoSplitter

A MelonLoader mod for RUMBLE that provides automatic splitting integration with LiveSplit.

Features

• Automatic Timer Control: Automatically starts, splits, and resets the LiveSplit timer based on race events
• Track-based Splitting: Splits at the start of tracks 1-4, plus a final split when track 4 completes
• Smart Reset Logic: Resets when returning to track selection or when a race ends without a winner
• Non-blocking Communication: TCP commands are sent asynchronously to prevent game lag
• TCP Integration: Communicates with LiveSplit via TCP server component

Requirements

• RUMBLE (the game)
• MelonLoader installed
• LiveSplit with the LiveSplit Server component enabled (see setup below)

Installation

• Ensure MelonLoader is installed in your RUMBLE directory
• Download the latest release of RallyXAutoSplitter
• Place RallyXAutoSplitter.dll in your RUMBLE/Mods folder
• Enable the LiveSplit Server in LiveSplit (see LiveSplit Setup below)

LiveSplit Setup

Important: This mod requires the LiveSplit TCP Server, not the LiveSplit WebAssembly server.

Enable LiveSplit Server

• Configure the server:
• Right-click on LiveSplit → Settings
• Scroll to the bottom and find LiveSplit Server options
• Set Server Port to 16834 (default)
• Startup Behaviour should be Start TCP Server

Setup Splits

• Right-click on LiveSplit → Edit Splits
• Create 5 splits for your run:
• Track A
• Track B
• Track C
• Track D
• Track E

How It Works

The mod hooks into RUMBLE's race system and:

• Starts the timer when track 0 begins (no split)
• Splits when tracks 1, 2, 3, and 4 start
• Splits again when track 4 completes (final split)
• Resets when a race ends without completion or when returning to track selection

All LiveSplit commands are sent asynchronously with a 2-second timeout to prevent game lag if the LiveSplit server is slow or unreachable.

Building

Prerequisites

-.NET 6 SDK

• Visual Studio 2022 or later (optional)

Build Steps

dotnet build RallyXAutoSplitter/RallyXAutoSplitter.csproj -c Release

The compiled DLL will be in RallyXAutoSplitter/bin/Release/net6.0/

Development

The project includes a comprehensive unit test suite:

dotnet test RallyXAutoSplitter.Tests/RallyXAutoSplitter.Tests.csproj

Architecture

• Interfaces: Core logic depends on abstractions (ILiveSplitService, ILogger, IRaceData, ITcpClientFactory)
• Adapters: MelonLoader and Il2Cpp types are isolated behind adapters for testability
• Services:
• AutoSplitterService: Contains the splitting logic
• LiveSplitService: Handles TCP communication with LiveSplit

License

This project is open source. Feel free to modify and distribute.

Credits

Created by ACutiePi