mingdaoshiming / chromapper

GitHub repository for ChroMapper, the Unity-based map editor for Beat Saber.

This is ChroMapper.

ChroMapper is an in-development, Unity-based map editor for Beat Saber, specializing in modded map creation. ChroMapper also offers various tools and features that tailor towards the advanced mappers of the community.

Coming from a Tutorial?

Welcome! This is the source code for ChroMapper.

The intention for the asset files being open to the public is to help aid other contributors in making ChroMapper better. ChroMapper will not be anywhere close to where it is today without the help of several contributors taking time out of their lives to expand upon the available source code.

However, what you see here is in-development software. This is not final. The source code will contain bugs and issues, potentially making it impossible to map with. I currently do not recommend (or endorse) cloning and building ChroMapper outside of development purposes. If you are building ChroMapper with the sole intention to map with it, you will not get support. If you would like support for ChroMapper, please consider joining Closed Beta.

Comparison Sheet

(Inspiration from BeatMapper)

Here is a simple chart that compares various features, platforms, and availability of some of the other widely used Beat Saber editors.

Feature	ChroMapper	MediocreMapAssistant2	BeatMapper	Official Editor
Engine/Framework	Unity	Unreal	React	Unity
Availability	Standalone	Standalone	Web Browser	Bundled
Platform	Windows	Windows	Fuckin' Anywhere	Windows
Perspective	3D	3D	3D/2D	2D
Mapping Extensions	✔️	✔️	✔️	❌
Noodle Extensions	✔️	❌	❌	❌
Chroma RGB Lightmapping	✔️	✔️	❌	❌
Chroma 2.0 Lightmapping	✔️	❌	❌	❌
360/90 Degree Support	✔️	❌	❌	✔️

Releases

Closed Beta is here!

Links to the application form have been sent out to places that contain a good amount of potentailly interested mappers. Expectations and requirements are detailed in the application.

ChroMapper development, suggestions, and bug reports, are provided in the channels that are unlocked when entering Closed Beta.

Patreon

If you'd like to donate to the project and get some sweet perks, to get support for the software, or to get live updates on ChroMapper development, you can support me on Patreon. The Counters+ tier ($5+) will get you instant access to ChroMapper Closed Beta.

When Closed Beta is finished, all future patreon members (and current Closed Beta members) will receive pre-release builds faster than the public, which include hotfix and beta builds.

For Developers

ChroMapper is developed with Unity in C#. Please see the build guide for setting up your development environment.

License

The project uses the GNU GPL v2 license. Please keep that license in mind as you make contributions to ChroMapper.