Full Auto — пакетная автогенерация

Коротко. Beatmap Studio делает из обычного аудиофайла кастомную песню для Synth Riders: слушает трек, считает темп, расставляет ноты по шести сложностям, показывает, как это будет в игре, и собирает один файл .synth — его и кладут в игру. Считает это наш сервер (поэтому алгоритмы и не видны в странице), а аккаунт нужен только чтобы сохранить проект и вернуться к нему позже.

Нужен Beat Saber или Song Beater? Это тот же сайт: переключатель игр в шапке. Генератор и редактор те же, а пакет собирается в формате Beat Saber (ZIP с папкой песни: Info.dat, файлы сложностей, song.egg, обложка), и его же читает Song Beater. Прямая ссылка на режим — ?mode=beatsaber.

Первый раз: пять шагов

1. Аудио. Вкладка «Проект», самое её начало: перетащите файл (MP3, OGG, WAV, FLAC или M4A) либо нажмите «Демо-трек» — на демо весь путь видно за полминуты. Есть готовая карта? Кнопка «Открыть готовый .synth» разберёт чужую песню на ноты, звук и обложку.
2. Ритм. Вкладка «Ритм и карта», верхняя часть: через секунду-другую появятся BPM, число онсетов и сетка. Если темп определился вдвое больше или меньше, помогут ÷2 и ×2 (или TAP в такт). Смещение сетки выручает, когда ноты ложатся чуть раньше музыки.
3. Карта. Там же, ниже: сложности, плотность, разброс, стены — и «Сгенерировать карту». Получится шесть сложностей: Easy, Normal, Hard, Expert, Master и Custom.
4. Посмотреть. «Предпросмотр 3D» (на телефоне — вкладка «3D») → «Играть»: ноты летят в такт с музыкой, как в игре. Сложность и камера выбираются справа сверху.
5. Забрать. «Скачать песню для игры» даёт файл .synth, а «Сохранить проект» оставляет работу в аккаунте, чтобы продолжить с другого устройства.

Пока в проекте нет ни звука, ни карты, поля «Ритма и карты» серые — так видно, что нужно сделать раньше. Появился звук — открылись темп, плотность, название, обложка и выгрузка; появилась карта — открылось сохранение проекта.

Пример 1: своя песня с нуля

Хочу катать любимый трек (4 минуты, MP3) на Expert, но не «мясо».

• «Проект» → файл. Анализ покажет, например, BPM 124.04 и 900 онсетов.
• «Ритм и карта»: плотность 60%, разброс средний, рейлы включены → «Сгенерировать карту».
• «3D»: посмотреть Expert. Слишком часто? Плотность 45% и кнопка «Другой вариант» — раскладка перетасуется.
• «Скачать песню» → MySong.synth → положить в CustomSongs → перезапустить игру.
• Итог: в Solo → Custom Songs песня с шестью сложностями, звук — единицы мегабайт, вся песня одним файлом.

Пример 2: чужая карта не по руке

Скачал .synth из мастерской, а раскладка слишком плотная.

• «Открыть готовый .synth» → карта, звук и обложка разберутся сами.
• Вкладка «Таймлайн и редактор»: видно все ноты (цвет — какая рука), жёлтые стены, рейлы. Колесо мыши — зум, рамка — выделение, Ctrl+Z — отмена.
• Правки: удалить лишние ноты, сдвинуть стену, сменить тип ноты (правая / левая / обе / золотая), потянуть рейл.
• «Скачать песню» — звук и обложка при этом не пересжимаются, качество не теряется.

Пример 3: вторая версия для новичка

Та же песня, но чтобы сыграл друг, который только начал.

• «Мои проекты» → открыть сохранённый проект: ничего загружать и анализировать заново не нужно.
• Плотность 30%, разброс узкий, препятствия выключить → «Сгенерировать карту».
• Название проекта MySong (easy) → «Сохранить»: рядом появится второй проект, а первый останется как был.

Что умеет

• Аудио: MP3, OGG, WAV, FLAC, M4A; демо-трек; разбор готового .synth.
• Анализ: BPM (руками, ÷2/×2, TAP), онсеты, сетка, смещение, чувствительность, квантование.
• Генерация: шесть сложностей, плотность нот, рейлы, разброс рук, препятствия, «Другой вариант» — другая раскладка.
• Редактор: таймлайн с зумом, добавление и удаление нот, типы стен, свободные рейлы, зелёные и золотые ноты, выделение рамкой, работа с фрагментом, отмена.
• Предпросмотр: проигрывание вместе с музыкой, выбор сложности, камеры, счётчик нот.
• Файл: название песни и исполнитель, обложка (можно не выбирать — нарисуется сама), качество звука, «шифровать как в игре», ZIP-архив с отдельными файлами.
• Проекты: аккаунт, список «Мои проекты», открытие проекта из файла.
• Проверка: перед выгрузкой карта проверяется сама — ноты не попадают в зону головы, три ноты разом невозможны, у одной руки есть минимальный интервал, последняя секунда свободна. Замечания видны в таблице, ошибки чинятся автоматически.

Как поставить песню в игру

Песня — это один файл .synth, все сложности внутри него. Куда положить:

• Quest 3: /sdcard/SynthRidersUC/CustomSongs/
• Quest (старый путь): /sdcard/Android/data/com.kluge.SynthRiders/files/CustomSongs/
• PC: SynthRidersUC\CustomSongs\ рядом с игрой

Затем в игре Solo → Custom Songs. Список читается при запуске, поэтому после копирования перезапустите игру. Проще всего через SideQuest или adb — пошагово это в меню «⋯ → Как установить в игру».

Частые вопросы

• Моя песня куда-то уходит? Да, на наш сервер: он разбирает звук, собирает карту и упаковывает песню, а страница только показывает результат. Никуда дальше файл не передаётся и никому не показывается. Если вы не нажимали «Сохранить проект», запись о песне живёт на сервере как временная и удаляется сама.
• Нужен ли аккаунт? Для просмотра готовых карт (.synth и Beat Saber) и ручного редактирования в таймлайне аккаунт не нужен. Для автоматической генерации карт, пакетного режима Full Auto и сохранения проектов требуется войти в аккаунт. Почты при регистрации нет, поэтому пароль восстановить нельзя — запомните его.
• Почему сохранение идёт несколько секунд? Сервер сжимает звук в формат игры (ffmpeg + OGG Vorbis): на четырёхминутной песне это до ~10 секунд. Кнопка показывает, на каком шаге процесс, а повторное сохранение без изменений — мгновенное.
• Игра не видит песню. Проверьте папку (см. выше) и перезапустите игру: список читается при запуске. Класть нужно сам файл .synth, а не распакованный архив.
• Зачем «шифровать как в игре»? Игра читает и обычные, и зашифрованные пакеты; галочка делает файл ближе к официальным. Если песня не открывается — попробуйте снять её.
• Хочу проще или сложнее. Это плотность и разброс: сгенерируйте заново и сравните в 3D. Сложность «Custom» — та же генерация, её удобно оставить под правки в таймлайне.
• Можно ли делать карты на чужую музыку? Для личного использования — да. Выкладывать чужие треки без разрешения правообладателя нельзя.

In short. Beatmap Studio turns an ordinary audio file into a custom Synth Riders song: it listens to the track, detects the tempo, lays out notes across six difficulties, shows how it will look in the game and builds a single .synth file — that is what you drop into the game. Your song is never uploaded: everything is computed in your browser, and an account is only needed to save a project and come back to it later.

Need Beat Saber or Song Beater? There is a separate build of this site for them — the game switch in the header: the same generator and editor, but the package is written in the Beat Saber format (a ZIP with the song folder: Info.dat, one file per difficulty, song.egg, a cover), which Song Beater reads as well.

First time: five steps

1. Audio. The «Project» tab, at its very top: drop a file (MP3, OGG, WAV, FLAC or M4A) or press «Demo track» — the demo shows the whole path in half a minute. Already have a chart? The «Open an existing .synth» button unpacks someone else's song into notes, audio and artwork.
2. Rhythm. The «Rhythm & chart» tab, its upper part: a second or two later you get BPM, the number of onsets and the grid. If the tempo came out twice too fast or too slow, use ÷2 and ×2 (or TAP along with the beat). Grid offset helps when notes land slightly before the music.
3. Chart. Further down the same tab: difficulties, density, spread, walls — and «Generate chart». You get six difficulties: Easy, Normal, Hard, Expert, Master and Custom.
4. Look at it. «3D preview» (the «3D» tab on a phone) → «Play»: notes fly in time with the music, just like in the game. Difficulty and camera are picked in the top right corner.
5. Take it. «Download song for the game» gives you the .synth file, and «Save project» keeps your work in your account so you can continue from another device.

While a project has neither audio nor a chart, the fields on the «Rhythm & chart» tab stay grey — that shows what has to happen first. Once audio is loaded, tempo, density, the song title, artwork and download open up; once a chart exists, saving the project becomes available.

Example 1: your own song from scratch

I want to play my favourite track (4 minutes, MP3) on Expert, but not a wall of notes.

• «Project» → file. Analysis might show, say, BPM 124.04 and 900 onsets.
• «Rhythm & chart»: density 60%, spread medium, rails on → «Generate chart».
• «3D»: check Expert. Too dense? Density 45% and the «Another variant» button reshuffles the layout.
• «Download song» → MySong.synth → put it in CustomSongs → restart the game.
• Result: in Solo → Custom Songs the song appears with six difficulties, a few megabytes of audio, all in one file.

Example 2: someone else's chart that does not fit your hands

I downloaded a .synth from the workshop and the layout is too dense.

• «Open an existing .synth» → chart, audio and artwork are unpacked for you.
• The «Timeline & editor» tab: every note is visible (colour shows which hand), plus yellow walls and rails. Mouse wheel zooms, the marquee selects, Ctrl+Z undoes.
• Edits: delete extra notes, move a wall, change a note's type (right / left / both / gold), drag a rail.
• «Download song» — audio and artwork are not re-compressed, so nothing is lost.

Example 3: a second version for a beginner

The same song, but for a friend who has just started.

• «My projects» → open the saved project: nothing to upload or analyse again.
• Density 30%, spread narrow, obstacles off → «Generate chart».
• Project name MySong (easy) → «Save»: a second project appears next to the first one, and the first stays as it was.

What it can do

• Audio: MP3, OGG, WAV, FLAC, M4A; the demo track; unpacking an existing .synth.
• Analysis: BPM (by hand, ÷2/×2, TAP), onsets, grid, offset, sensitivity, quantisation.
• Generation: six difficulties, note density, rails, hand spread, obstacles, «Another variant» — another layout.
• Editor: zoomable timeline, adding and deleting notes, wall types, free rails, green and gold notes, marquee selection, fragment editing, undo.
• Preview: playback together with the music, difficulty selection, cameras, note counter.
• File: song title and artist, artwork (optional — one is drawn for you), audio quality, «encrypt like the game does», a ZIP archive with the separate files.
• Projects: an account, the «My projects» list, opening a project from a file.
• Validation: the chart is checked automatically before download — notes never spawn in the head zone, three notes at once are impossible, a single hand has a minimum interval, the last second stays empty. Warnings show up in the table and errors are fixed automatically.

How to put the song into the game

A song is one .synth file, with every difficulty inside it. Where to put it:

• Quest 3: /sdcard/SynthRidersUC/CustomSongs/
• Quest (legacy path): /sdcard/Android/data/com.kluge.SynthRiders/files/CustomSongs/
• PC: SynthRidersUC\CustomSongs\ next to the game

Then in the game Solo → Custom Songs. The list is read at launch, so restart the game after copying. The easy way is SideQuest or adb — step by step it is in the «⋯ → How to install into the game» menu.

Frequently asked questions

• Does my song go anywhere? Yes, to our server: it analyses the audio, builds the chart and packages the song, while the page only shows the result. The file is not passed on or shown to anyone else. Unless you press «Save project», the song's record lives on the server as a temporary one and is cleaned up by itself.
• Do I need an account? No account is needed to view ready charts (.synth and Beat Saber) and edit them manually in the timeline. To generate charts automatically, use the Full Auto batch mode, or save projects, you need to log in. There is no email at sign-up, so a password cannot be recovered — remember it.
• Why does saving take a few seconds? The server compresses the audio into the game's format (ffmpeg + OGG Vorbis): up to ~10 seconds for a four-minute song. The button shows which step it is on, and saving again with no changes is instant.
• The game does not see the song. Check the folder (above) and restart the game: the list is read at launch. You have to copy the .synth file itself, not an unpacked archive.
• What is «encrypt like the game does» for? The game reads both plain and encrypted packages; the checkbox brings the file closer to the official ones. If a song fails to open, try turning it off.
• I want it easier or harder. That is density and spread: generate again and compare in 3D. The «Custom» difficulty is the same generation — handy to keep for your own timeline edits.
• May I chart music I do not own? For personal use, yes. Publishing someone else's tracks without the rights holder's permission is not allowed.

Коротко. Beatmap Studio собирает из обычного аудиофайла кастомный уровень для Beat Saber: слушает трек, считает темп, раскладывает блоки по пяти сложностям (Easy, Normal, Hard, Expert, Expert+), показывает, как это будет в игре, и складывает папку с песней в ZIP — внутри Info.dat, файл на каждую сложность, song.egg и обложка. Тот же архив читают и Beat Saber, и Song Beater. Считает это наш сервер (поэтому алгоритмы и не видны в странице).

Первый раз: пять шагов

1. Аудио. Вкладка «Проект», её начало: перетащите файл (MP3, OGG, WAV, FLAC или M4A) либо нажмите «Демо-трек» — на встроенном треке видно, как всё работает.
2. Темп. Вкладка «Ритм и карта», верхняя часть: темп определяется сам. Если он вдвое больше или меньше — кнопки ÷2 и ×2, кнопка TAP подстраивает темп под щелчки.
3. Карта. Там же ниже — кнопка «Собрать карту»; плотность, арки, разброс и стены рядом. Чипы сложностей сверху: соберутся только отмеченные. «Другой вариант» меняет раскладку.
4. Проверка. «Предпросмотр» проигрывает уровень, «Таймлайн» — правка руками: перетаскивайте блоки, ставьте стены, тяните арки и цепочки (все блоки встают на сетку 4×3).
5. Файл. Там же, в «Проекте»: название, исполнитель, обложка → «Скачать песню для игры». Получится ZIP, внутри — папка с названием песни.

Куда положить папку

Beat Saber, ПК: ...\Beat Saber\Beat Saber_Data\CustomLevels\ — распакуйте туда папку песни, уровень появится в меню «Custom Levels».

Beat Saber, Quest: нужен мод SongCore (ModsBeforeFriday или BMBF), путь /sdcard/ModData/com.beatgames.beatsaber/Mods/SongCore/CustomLevels/.

Song Beater, ПК: ...\Song Beater\Custom songs\ — каждая песня своей папкой. Oculus: ...\CustomSongs\. Quest / Go: /sdcard/Android/data/com.Playito.SongBeater/CustomSongs/. ZIP игра не открывает: папку нужно распаковать.

adb push "./Название песни" /sdcard/ModData/com.beatgames.beatsaber/Mods/SongCore/CustomLevels/

Что умеет

• Пять сложностей Beat Saber и скорость полёта блоков (NJS) 10 / 10 / 12 / 15 / 17.
• Стены: половина поля (левая или правая), приседание (потолок), центр и углы. Длина стены — настройка «Длина стен»; стена никогда не накрывает блок — она укорачивается или убирается.
• Арки и цепочки: длинные «слайды» выгружаются арками (_sliders), цепочки — в burstSliders со числом звеньев.
• Правка руками, 3D-предпросмотр, таймлайн и сохранение проекта в аккаунте.
• Схема файлов 2.6.0 (по умолчанию) или 3.2.0 — переключатель в панели «Проект».

Чего нет

• Света (событий и Chroma): лайтшоу не пишется, уровень играется без авторской подсветки.
• Света чужой карты: события света при открытии ZIP пропускаются (с замечанием) — лайтшоу не переносится и не пишется.
• Режимов кроме Standard: OneSaber, 90/360 и прочие характеристики не читаются.
• Правки бомб (они показываются и сохраняются, но поставить или подвинуть их руками нельзя) и NJS-профилей на отдельные ноты.

Частые вопросы

Игра не видит уровень. Проверьте три вещи: папка распакована (не ZIP), внутри лежит Info.dat именно с таким именем, папка лежит в CustomLevels (Beat Saber) или CustomSongs (Song Beater).

Играется не та песня. Так бывает, когда Info.dat не совпадает с файлами сложностей или с именем аудио. Мы пишем согласованный набор, по умолчанию в схеме 2.6.0 — её читают и Song Beater, и старые сборки Beat Saber.

Почему много «точек» (блок без направления)? Направление реза выводится из движения руки по карте; там, где движения нет, остаётся «любое» — такой блок можно рубить в любую сторону. Если точек больше половины, карта плоская: поднимите плотность или поправьте руками.

Куда делись блоки при выгрузке? Если две ноты одной руки попадают в одну клетку, вторая сдвигается на соседнюю дорожку; стена перед блоком укорачивается. Это видно в «Замечаниях» к сложности.

Можно открыть чужую карту? Да, кнопка «Открыть готовый .synth» берёт ZIP с папкой песни: читаются схемы 2.x, 3.x и 4.x — блоки, резы, бомбы, стены, цепочки, арки и NJS. Карта маппера показывается как есть, правится в таймлайне (рез — шеврон внутри блока, бомбы — чёрные квадраты) и выгружается обратно: доли, клетки и резы возвращаются в файл теми же. Не переносятся только события света и режимы кроме Standard (OneSaber и подобные).

Что такое NJS? Note Jump Speed — с какой скоростью блоки летят на игрока: главная ручка «ощущения» карты. Мы берём значение _noteJumpMovementSpeed из открытой карты, а поле «Скорость полёта NJS» в панели выгрузки может задать одно значение для всех сложностей.

А если нужен Synth Riders? Это тот же сайт: переключатель игр — в шапке (?mode=synth открывает режим сразу). Формат файла определяется по содержимому, так что .synth откроется как Synth Riders, а ZIP с Info.dat — как карта Beat Saber.

In short. Beatmap Studio turns an ordinary audio file into a custom Beat Saber level: it listens to the track, finds the tempo, lays blocks out across five difficulties (Easy, Normal, Hard, Expert, Expert+) and packs a song folder into a ZIP — Info.dat, one file per difficulty, song.egg and a cover. The same archive is read by Beat Saber and by Song Beater. Our server does the counting — that is why the algorithms are not visible in the page.

First time: five steps

1. Audio. The «Project» tab, at its top: drop a file (MP3, OGG, WAV, FLAC, M4A) or hit «Demo track» to see how it works on the built-in song.
2. Tempo. The «Rhythm & chart» tab, its upper part: the tempo is detected. If it is twice off, use ÷2 / ×2; TAP taps the tempo in.
3. Chart. Further down the same tab press «Generate chart»; density, arcs, spread and walls are next to it. The difficulty chips decide what gets built; «Another variant» changes the layout.
4. Check. «Preview» plays the level, «Timeline» edits by hand — drag blocks, place walls, pull arcs and chains (everything snaps to the 4×3 grid).
5. File. Back in «Project»: name, artist, cover → «Download song for the game». You get a ZIP with a folder named after the song.

Where to put the folder

Beat Saber, PC: ...\Beat Saber\Beat Saber_Data\CustomLevels\ — unpack the song folder there and it shows up under «Custom Levels».

Beat Saber, Quest: needs the SongCore mod (ModsBeforeFriday or BMBF), path /sdcard/ModData/com.beatgames.beatsaber/Mods/SongCore/CustomLevels/.

Song Beater, PC: ...\Song Beater\Custom songs\ — one folder per song. Oculus: ...\CustomSongs\. Quest / Go: /sdcard/Android/data/com.Playito.SongBeater/CustomSongs/. The game does not open ZIPs: unpack the folder first.

adb push "./Song Name" /sdcard/ModData/com.beatgames.beatsaber/Mods/SongCore/CustomLevels/

What it can do

• Five Beat Saber difficulties and a note jump speed (NJS) of 10 / 10 / 12 / 15 / 17.
• Walls: half the field (left or right), crouch (ceiling), centre and corners. Wall length is the «Wall length» setting; a wall never covers a block — it gets shortened or dropped.
• Arcs and chains: long slides are exported as arcs (_sliders), chains go into burstSliders with a link count.
• Hand editing, 3D preview, timeline and saving the project to your account.
• File schema 2.6.0 (default) or 3.2.0 — the switch lives in the «Project» panel.

What it does not do

• Lighting (events and Chroma): no lightshow is written, the level plays without custom lighting.
• Light events of an imported map: they are skipped with a note — a lightshow is neither carried over nor written.
• Characteristics other than Standard: OneSaber, 90/360 and the rest are not read.
• Editing bombs (they are shown and kept, but cannot be placed or moved by hand) and per-note NJS profiles.

Frequently asked questions

The game does not list the level. Check three things: the folder is unpacked (not a ZIP), it contains Info.dat spelled exactly like that, and it sits in CustomLevels (Beat Saber) or CustomSongs (Song Beater).

The wrong song plays. That happens when Info.dat disagrees with the difficulty files or the audio name. We write a consistent set, in schema 2.6.0 by default — the one both Song Beater and older Beat Saber builds read.

Why so many dots (blocks with no cut direction)? The cut is derived from how the hand moves through the chart; where there is no movement the block stays «any direction». If more than half are dots the chart is flat — raise the density or fix it by hand.

Where did notes go on export? If two notes of one hand land in one cell, the second steps onto the free lane; a wall in front of a block gets shortened. The per-difficulty «Notes» column reports it.

Can I open somebody else's map? Yes — «Open an existing .synth» takes a ZIP with the song folder: schemas 2.x, 3.x and 4.x are read (blocks, cuts, bombs, walls, chains, arcs and NJS). The mapper's map shows up as is, is edited on the timeline (a cut is a chevron inside the block, bombs are black squares) and is exported back: beats, cells and cuts return to the file unchanged. Only light events and characteristics other than Standard (OneSaber and the like) are left out.

What is NJS? Note Jump Speed — how fast blocks fly at the player: the main «feel» knob of a map. We take _noteJumpMovementSpeed from the opened map, and the «Note jump speed (NJS)» field in the export panel can set one value for every difficulty.

What about Synth Riders? It is the same site: the game switch sits in the header (the ?mode=synth opens the right mode straight away). The file format is detected by content, so a .synth opens as Synth Riders and a ZIP with Info.dat as a Beat Saber map.