Source code can be found here

Playing a Replay

Currently the only way to render replay files is Blender.

Blender Setup

[!important] I do not provide any rigs or maps for you, you'll have to find/make one yourself

Prerequisites

• The Structures Blend file (you could use your own file if it's formatted right)

• A Replay

• And The Plugin (right click save as file if you dont want to clone the repo)

1. Create a new Blend file.

2. In the top left corner

3. Click Link or Append (either one works; I recommend Link so when you make a change to the material, it's reflected across all replays)

4. Select the Structures.blend file I supply (or your own if you decide to make your own).

5. Go over to Collections and select Structures.

6. Move over to the scripting tab.

7. Click Open and select the blenderplugin.py file I give you.

8. Press the little play button

9. Open the Sidebar menu (it opens itself like 50% of the time).

10. Move over to Misc; and Press Setup Scene

[!Tip] If you want to put a camera on a players view its easier to do it now, by adding a camera and parenting it to Player.000 or Player.001

1. Press Select File and select your replay (I recommend copying it and putting it in the same folder as your blend file).

2. And then finally generate animation; Blender might freeze for a while, but it should generate an animation that you're free to do what you want with.

Obtaining a Replay

After you install the mod, there should be a new folder in your Melonloader\UserData folder called Replays

Whenever you start a match, it'll automatically create a new .RR file.

With the filename structure {localPlayerName}-Vs-{remotePlayerName} On {map}-{RandomizedName}.rr

[!Tip] If you want to find the newest file you can right click in explorer and click Sort By and then Date modified

Known Issues

• The Blender plugin is incredibly slow
• There currently isn't a way to scale the player up or down (easily at least)
• Objects and players hover sometimes (I've made Players and Objects parented to separate objects to hopefully make this easier to fix)
• Sometimes rotations spaz out (as far as i can tell this is a unity giving me invalid data randomly)

Building

Project Setup

Create a References folder in your project directory

From RUMBLE/MelonLoader/Il2CppAssemblies Copy

• Il2Cppmscorlib.dll

• Il2CppRUMBLE.Runtime.dll

• Il2CppBucketheadEntertainment.Plugins.dll

• UnityEngine.dll

• UnityEngine.CoreModule.dll

• UnityEngine.PhysicsModule.dll

• UnityEngine.InputLegacyModule.dll

From RUMBLE/MelonLoader/net6 Copy

• Il2CppInterop.Common.dll

• Il2CppInterop.Generator.dll

• Il2CppInterop.Runtime.dll

Add RumbleModdingAPI.dll (obtainable via Thunderstore if you don't have it) to references.

Restore NuGet packages if needed

Add That References folder as a References Folder in your editor (or just select all of them and reference them).

[!NOTE] For those who wanna make their own recorders/parsers, or prepose changes or otherwise just understand the format I have included an ImHex Pattern that defines the general structure of .rr files

Special thanks to SDRAWKCABMIAY for making the CRUMBLE font used in the logo

And Thank you ulvak for the RumbleModdingAPI

1.1.3

• MatsuNoKi has kindly made an update to fix RumbleReplay until i have the time and energy to give it the love and attention it deserves

1.1.1

• Forgot that relative links wouldnt work on thunderstore

1.1.0

• Added github actions to allow more tech savy users to quickly get an unreleased verison
• Automated generating releases to make my life easier
• Made a change to the processing of usernames to result in nicer looking replay filenames and headers
• Also added a more up to date Structures.blend because ive accidently been using an older verison
• README now mirrors the one from the github
• Updated README to be more informative and provide credits at the bottom
• Added Player Cosmetics to headers
• Added Player BP to headers
• Added PlayFabId to the headers
• Changed the assembly name so Lumbot tracks RumbleReplay
• Deprecated the orginal basicPlayerUpdate and replaced it with a more comprehenisive one, thats more useable for animation
• Blender: Automatically set's the framerate to 50 in blender

1.0.2

• Fixed an issue where if the header was above 128 bytes it'd add a empty pad byte
• Abstracted out some common functions for better code readability

1.0.1

• Accidently used the wrong icon from my prototypes