Modding the game?!

[Coty]

Want to mod the game? Here's some forbidden knowledge.

What is this?

When we ship Wave Break builds on Steam, we are actually uploading two copies of the game every time. The first, default, is an IL2CPP build. This is a highly optimized build of the game. Unfortunately, it's so optimized that it is very difficult to mod! To help ease the burden, we are also shipping secondary Mono builds.

Without getting too deep into technical jargon, a quick summary is this: IL2CPP builds are hard to mod, so we have another branch on steam for Mono builds, which are easier to mod.

How to get Mono builds?!

Locate Wave Break in your library. Right click the game, select properties. Navigate to the BETAS tab. Type in the following: iwanttomodthegame and select Check Code. This will add the Mono branch to the dropdown above. Use the dropdown to switch to the Mono branch. You can switch back and forth anytime, but any mods done to the game may be lost after switching branches!

Here's a short video doing exactly that: https://streamable.com/j07byb

Got it. Now how do I mod?

Wave Break does not have an official modding API. The Mono builds are simply to make it easier for determined modders to add or modify anything they desire into the game. Wave Break is made in Unity, so Unity-specific modding tools may be helpful to you!

Here are some cool tools to check out!

C# modding:
https://github.com/pardeike/Harmony
https://github.com/dnSpy/dnSpy
https://github.com/icsharpcode/ILSpy

Asset browsing/extraction:
https://github.com/Perfare/AssetStudio
https://github.com/mafaca/UtinyRipper

If you create something cool, let us know either here on the forums or on our Discord!
https://discord.com/invite/funktroniclabs

Remember!

This stuff is only for the main app of the game. The previous alpha/playtest apps do not ship with Mono build branches.