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

1. Ensure MelonLoader is installed in your RUMBLE directory
2. Download the latest release of RallyXAutoSplitter
3. Place RallyXAutoSplitter.dll in your RUMBLE/Mods folder
4. 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

1. Right-click on LiveSplit → Edit Splits
2. 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