/DereTore

Music and beatmap authoring toolkit for THE iDOLM@STER Cinderella Girls Starlight Stage (CGSS/DereSute/デレステ). / 偶像大师灰姑娘女孩星光舞台音乐&谱面制作工具箱

Primary LanguageC#MIT LicenseMIT

DereTore

AppVeyor GitHub contributors Libraries.io for GitHub Github All Releases GitHub (pre-)release

The goal of DereTore is to improve gaming experience in THE iDOLM@STER Cinderella Girls: Starlight Stage (CGSS/DereSute/デレステ), and even to customize it a little bit.

Downloads:

A newer version of Starlight Director (the beatmap editor) can be found at hozuki/StarlightDirector. However, if you want to build ACB music, currently you are still advised to use Music Toolchain in this repository.

Wonder how this name comes from?

What can it do?

  • Extract audio files used by CGSS (and some other games using ACB/HCA).
  • Decode those audio files to wave audio.
  • Create songs, and their cover images.
  • Create beatmaps.
  • Preview beatmaps.

The greatest thing is that the things you create is fully playable. You just need to replace the original files, or use IdolProxy (which is easier).

Check out projects for detailed information.

Usage

Have a look at the Wiki Page. Please contact us if you want to help.

Basic requirements:

Windows:

macOS/Linux:

  • Wine (will install wine-mono when needed)
  • OpenAL (bundled OpenAL-Soft builds in newer releases)

In newer releases, HCA encoding is provided by VGAudio so hcaenc_lite.dll is no longer needed.

Optional requirements:

If you want to build custom CD jackets:

Checked Feb. 09, 2018: Although JacketCreator generates asset bundles for Unity version 5.1.2f1 (original version that CGSS uses), CGSS (using Unity 5.4.5p1) is still able to load and display them. Cygames also updated the Unity version they used, so maybe the jackets created by Jacket Creator become unrecognizable.

Building

  1. Clone from GitHub: git clone https://github.com/OpenCGSS/DereTore.git;
  2. Restore all NuGet packages;
  3. Open DereTore.sln in Visual Studio (Visual Studio 2017 or later is required for supporting C# 7 syntax);
  4. Build the solution.

Contributing

Beginning from version 3.0.3, CGSS is compiled by IL2CPP. This may cause some problems in the future. If you feel like to track the latest changes, feel free to make a pull request.

TODO List

License

This solution uses MIT License. See LICENSE.md.

Notes

See here.