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

This video is outdated, while most of the video remains the same, some things you may have to dig around for.

PropEdit (ChroMapper) guide (Youtube)
: Some random weird 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

Beat Timer
: A web-based alternative to Audacity and Arrow Vortex combined, allowing you to normalize audio, fetch the BPM of a song, and offset the audio to be on beat.

TextureCreate
: A web-based texture and material generation tool.

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

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 Knowledge

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)
: A handfull of included shader variables, some you will likely use. Study these!

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.

iquilezles.
: An absolute goldmine of knowledge with shaders.

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)
: A pack of 700+ noise textures.

Gradient Pack (Free)
: A pack of 300+ gradient textures.

Unity Packages

Vivify Template
: The package that contains the tools necessary to properly setup your unity project for vivify creation, bundle exporting, and a bunch of examples and tools to make the process easier.

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

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

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