Skip to content

Useful Links

Check this awesome page out for a goldmine of links with varying usages!

Notice

This page (and entire site) is mainly geared towards mappers and modcharters, NOT game modders. Check out the "Other Links" on the BSMG wiki modding page for links more related to game modding.


To organize and future proof, links will be organized in categories, some being more specific than others to avoid a crazy tree of categories.

Navigation Tip

This site supports text searching and search highlighting! If you are looking for something specific and may not know where to find it, you can search for the subject in the search bar located at the top right :D

Mapping / Modcharting

Heck Wiki
: The official documentation for the Heck suite. An absolute essential for anybody utilizing Heck mods.

BSMG Wiki
: The site that every player with a modded BeatSaber installation should have bookmarked. Covers everything from Mapping, Modding, and so much more.

BeatMods
: The hub for all approved plugins for BeatSaber and ChroMapper.

BS Mapping Utility
: A fine amount of utilities for miscellaneous stuff. Another fine site to have bookmarked.

Equivalent Fractions
: A list of fractions equivalent to each other from 0 - 1. Great for syncing path animations along with the games base jump animations.

easings.net
: All available easings for use excluding easeStep (Click on them for a slew of stuff including visual examples!)

Regexr
: One of the top sites for creating Regular Expressions (Regex). Each piece of the expression is also explained if you dont know what it does!

Scripting Libraries

ReMapper by Swifter
: A Typescript library that supports the latest from the Heck Library.

Wumbo Template by Mawntee
: An all in one Javascript template/script geared towards beginners.

HeckLib by Jevk
: A TS/Node.js library for creating modhcarts.


Applications

ChroMapper
: The go-to mapping application for creating maps! ChroMapper also supports animations, geometry, and much more for modcharters. Plugins will also help you alot!


FAQs

ChroMapper FAQ
: Have an issue with ChroMapper? Check this page for common issues before reaching out for support.

BSMG FAQ
: FAQ for modding BeatSaber, making maps, downloading/loading up maps, etc..


Video Tutorials

ChroMapper Tutorial (Youtube)

Notice

ChroMapper has grown a lot since this video has been made, so some things you may have to look in other spots for, but for the most part everything is the same.

PropEdit (ChroMapper) guide (Youtube)
: Some weird whimsical random guys guide on PropEdit, and basic Noodle Extensions usage of PropEdit in ChroMapper!

Info

"PropEdit" is a ChroMapper plugin that focuses on making modhcarts easier for those who aren't into script-based solutions. The plugin provides a UI that enables the mapper to add most of what the Heck Suite offers into their maps effortlessly.

Note: While the video is around a year old and many updates have happened since, it is still a great introduction to the plugin.

Other thingys:
V3 is now the standard for map formatting, you do not have to convert the map from V2 to V3.
CM Plugins are now hosted on BeatMods!

How to use ProBuilder inside Unity (Youtube)
: A playlist on ProBuilder in unity.

How to create Particle Systems inside Unity (Youtube)
: A great starting point for getting into Unity Particle Systems.

Heck Animations Overview
: A video covering every style of animation with Noodle/Chroma.


Tools

Photo Multitool
: A slew of random tools for editing photos. Yes.

Asset Bundle Extrator (UABE)
: Extract assets from a Unity AssetBundle

Video Compressor
: Simple video compressor, specify the file size aswell!

Perlin Noise Generator Website
: Simple site that allows you to quickly generate and download perlin noise textures.


Everything Vivify

Shaders

Shader Pragma Directives (Unity Docs)

Shader GPU Instancing (Github)
: Unity HLSL Shader Instancing + some.

Learn shader effects | Ronja Tutorials
: Learn a bunch of shader effects here.

Learn about shaders in unity from the ground up
: Learn about HLSL, writing shaders, examples, etc...

Learn about draw call performance (Youtube)

Introduction to the Raymarching technique (Youtube)
: A great video explaining the Raymarching technique in GLSL.

Surface Shader Examples in Unity (Unity Docs)
: A bunch of examples with surface shading.

Unity Built-In Shader Variables (Unity Docs)
: (!IMPORTANT!)

Unity "UnityCG" Include source (Unity Docs)
: "What does #include "UnityCG.cginc" add to my shader file?" This!

Standard CG Shader Library
: A bunch of math functions included with the standard library.

Shader Knowledge

iquilezles.
: An absolute goldmine of knowledge with shader.. Just shader.

The Book of Shaders
: A great introduction to shaders!

Writing HLSL (Unity Docs)
: Learn how to write HLSL programs

Shader Anatomy (Unity)
: Learn about the structure of a HLSL shader!

Global Variables for BeatSaber Shaders (1.29.1)
: All Global Variables for shaders found on BeatSaber shaders on 1.29.1

Shader "Did you knows" by Owen
: A great source of niche (unity) shader information. (Recommended to bookmark if you are a beginner especially!)

Assets

Noise Pack (Free)
: Its a free pack of noise textures cmon

Gradient Pack (Free)
: Its a free pack of gradient textures CMON.

Unity Packages

CurveMaster (30$)
: A tool for tuning your animation curves in Unity.

Better UnityAnimationWindow (Audio Waveforms!)
: Add your song to the animation window as a waveform WITH beat markers!

Chrunity
: A tool that allows you to place Chroma "Geometry" objects in Unity and port it into your map.


Community Discord Servers

Beat Saber Modding Group (BSMG)

Beat Saber Mapping

ChroMapper