blanko-RumbleReplay icon

RumbleReplay

Allows you to record your matches and play them back in blender

Last updated a month ago
Total downloads 102
Total rating 1 
Categories Mods Tools
Dependency string blanko-RumbleReplay-1.1.1
Dependants 0 other packages depend on this package

This mod requires the following mods to function

UlvakSkillz-RumbleModdingAPI-3.3.1 icon
UlvakSkillz-RumbleModdingAPI

API to Help Modders Get Started and to remove the necessity of GameObject.Find

Preferred version: 3.3.1
LavaGang-MelonLoader-0.7.0 icon
LavaGang-MelonLoader

The World's First Universal Mod Loader for Unity Games compatible with both Il2Cpp and Mono

Preferred version: 0.7.0

README

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 playbutton

  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