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
• TCP Integration: Communicates with LiveSplit via TCP server component

Requirements

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

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. Configure LiveSplit Server component to listen on 127.0.0.1:16834

LiveSplit Setup

1. Right-click on LiveSplit → Edit Layout
2. Add "LiveSplit Server" component (under Control)
3. Configure server settings:
   • Host: 127.0.0.1
   • Port: 16834
4. Create 5 splits for your run (tracks 1-4 start + track 4 end)

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

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

Version 1.1.1

• Ensure all requests to live split are sent in the correct order
• Fix potential issue with Harmony patching patches from other assemblies

Version 1.1.0

• Non-blocking TCP communication to prevent game lag
  • All LiveSplit commands run asynchronously on background threads
  • 2-second connection timeout prevents freezing if server is unreachable

Version 1.0.0

• Initial release
• Automatic timer start when track 0 begins (3-lap races only)
• Automatic splits at the start of tracks 1, 2, 3, and 4
• Final split when track 4 completes
• Automatic reset on race cancellation or returning to track selection
• TCP integration with LiveSplit Server (127.0.0.1:16834)
• Comprehensive unit test coverage