Самостоятельный клиент для режима osu!standard с открытым кодом. Написан с нуля на Rust: задержка как в stable, правила попаданий как в lazer, скины и реплеи от обоих.
A standalone open-source client for osu!standard. Written from scratch in Rust: stable-level latency, lazer's hit rules, skins and replays from both.
v0.1.2-alpha · 15 ноября 2026 · альфа для тестеров · Windows и Linuxv0.1.2-alpha · 15 November 2026 · alpha for testers · Windows and Linux
8000Гц: потолок частоты кадров и updateHz: frame and update rate ceiling
1:1с реплеями osu!lazer по судействуwith osu!lazer replays in judging
GPL-3открытый код на GitHubopen source on GitHub
{ ЧТО ТАКОЕ SLAM }{ WHAT IS SLAM }
Играется как lazer, ощущается как stablePlays like lazer, feels like stable
Правила судейства и скоринга перенесены из osu!lazer, поэтому его реплеи в SLAM дают тот же результат. Движок, потоки, рендер и звук свои: их задача — минимальная задержка от нажатия до звука и кадра.
Judging and scoring rules are ported from osu!lazer, so its replays give the same result in SLAM. The engine, threads, renderer and audio are SLAM's own, built for the shortest path from a key press to sound and frame.
Клиенту не нужны установленные stable или lazer: хватит папки с картами.
You don't need stable or lazer installed: a folder of beatmaps is enough.
Задержка на уровне stableStable-level latency
Попадание судится по времени события ввода, а не по кадру. Игровое время — позиция звука на выходе устройства с учётом его задержки.
A hit is judged by the input event's timestamp, not by the frame. Game time is the audio position at the device output, latency included.
Правила lazerLazer's rules
Хит-окна, слайдеры, здоровье и скоринг — как в osu!lazer. Каждое изменение проверяется на наборе настоящих лазерных реплеев.
Hit windows, sliders, health and scoring work as in osu!lazer. Every change is checked against a set of real lazer replays.
Скины stable и lazerStable and lazer skins
skin.ini всех версий, @2x, анимации. Счёт, комбо, здоровье и отсчёт берутся из скина; скин меняется прямо в паузе.
skin.ini of every version, @2x, animations. Score, combo, health and countdown come from the skin; switch skins right from the pause menu.
Своя библиотекаIts own library
Папка Songs из stable или любая папка с .osz. Поиск понимает запросы как в lazer (ar>9, [Insane]) и текст в другой раскладке.
osu!stable's Songs folder or any folder of .osz files. Search takes lazer-style queries (ar>9, [Insane]) and text typed in the wrong keyboard layout.
Офлайн, без BanchoOffline, no Bancho
SLAM не подключается к серверам osu! и ничего туда не отправляет. Реплеи своих попыток, даже проваленных, сохраняются в .osr.
SLAM never connects to the osu! servers and sends nothing there. Your plays, even failed ones, are saved as .osr replays.
в планахplanned
Плагины на LuauLuau plugins
Геймплейные моды, модули интерфейса и коннекторы к сторонним серверам — в песочнице, с правами и лимитами.
Gameplay mods, interface modules and connectors to third-party servers, sandboxed, with permissions and budgets.
{ ЗАМЕРЫ }{ MEASURED }
Измеряем, а не предполагаемMeasured, not assumed
14 400кадров в секунду на тестовой сцене из 500 спрайтов (Linux, X11)frames per second on the 500-sprite test scene (Linux, X11)
37 μsот события ввода до очереди update (p50)from input event to the update queue (p50)
0выделений памяти в шаге симуляцииmemory allocations per simulation step
48 / 49лазерных реплеев совпали или в допускеlazer replays matched or within tolerance
{ АРХИТЕКТУРА }{ ARCHITECTURE }
Потоки не ждут друг другаNo thread waits for another
Ввод, игра, отрисовка и звук живут в отдельных потоках и обмениваются данными без блокировок. Тяжёлая работа — диск, декодирование, звёзды, поиск — уходит в пул и приходит в кадр уже готовой.
Input, gameplay, drawing and audio run on separate threads and share data without locks. Heavy work (disk, decoding, star ratings, search) goes to a worker pool and reaches the frame already done.
input// главный поток ОСon os_event → timestamp_ns → spsc_ring
update// игра, судейство, HUDwake on input or1..8000 Hz → snapshot
draw// свежий снапшот, интерполяция, GPUtake latest snapshot → never waitsaudio// колбэк микшера: музыка и хитсаундыno alloc · no locks · no syscalls
workers// диск, декодирование, звёзды, поиск, глифыsend result → ready-made
Update пишет снапшоты в тройной буфер, draw всегда берёт последний. Ввод попадает в игру через кольцо без блокировок.
Update writes snapshots into a triple buffer, draw always takes the latest. Input reaches the game through a lock-free ring.
game_time = audio_position_at_output
− device_latency
+ global_offset × rate + beatmap_offset
hit_time = to_game_time(input_event.timestamp_ns)
// не время кадра: точность не зависит от FPSclock = CLOCK_MONOTONIC // Linux
| QueryPerformanceCounter // Windows
Отчёты звуковой карты сглаживаются в ровную шкалу времени. Офсеты считаются как в lazer, моды скорости меняют темп или частоту трека.
Reports from the audio device are smoothed into a steady timeline. Offsets work as in lazer; rate mods change the track's tempo or pitch.
deadline(n) = epoch + n × period// без дрейфаsleep waitable_timer // Windows
clock_nanosleep(ABSTIME) // Linuxspin last ~200 µspresent flip model + tearing // D3D11
swap_interval = 0// OpenGLupload ≤ 2 MB textures per frame
Лимитер держит абсолютные дедлайны: ошибка округления не копится, пропущенный кадр не догоняется. Частоты кадров и update меняются на лету.
The limiter keeps absolute deadlines: rounding error never builds up and missed frames are not chased. Frame and update rates change on the fly.
windows WASAPI shared | low-latency | exclusive
fallback exclusive → low-latency → shared
linux PipeWire quantum 128/48000 · ALSA hw:
+ USB driver delay from /proc/asound
samples decoded ahead → resampled to device ratemusic decode thread → ring → mixer callback
Хитсаунды декодируются заранее и играют с первого кадра следующего буфера. Устройство, бэкенд и размер буфера меняются без перезапуска.
Hitsounds are decoded ahead of time and start on the first frame of the next buffer. Device, backend and buffer size change without a restart.
Шестнадцать крейтов, у каждого своя границаSixteen crates, each with a clear boundary
Ядро с правилами игры не знает ни про окно, ни про GPU, ни про звук. Поэтому оно детерминировано и тестируется целиком без графики.
The core with the game rules knows nothing about windows, the GPU or audio. That keeps it deterministic and fully testable without graphics.
slam-ipcJSON-RPC для внешнего редактора картJSON-RPC for an external beatmap editor
slam-appточка входа, сборка всего вместе, настройкиentry point, wiring, settings
slam-shader-buildшейдеры на WGSL → GLSL и HLSL при сборкеWGSL shaders → GLSL and HLSL at build time
slam-testkitсчётчик выделений памяти для тестовallocation counter for tests
{ ТЕХНИЧЕСКИЕ РЕШЕНИЯ }{ TECHNICAL DECISIONS }
Что выбрано и почемуWhat was chosen and why
Каждое решение записано в репозитории вместе с отвергнутыми вариантами. Если решение меняется, сначала пишется новое.
Every decision is written down in the repository together with the rejected options. When a decision changes, a new one is written first.
Rust
Предсказуемая производительность без сборщика мусора и паузы в неподходящий момент. Ноль выделений памяти в горячих путях проверяется тестами.
Predictable performance with no garbage collector pausing at the wrong moment. Zero allocations on hot paths is enforced by tests.
Lazer как справочник правилLazer as the rulebook
Из lazer переносятся формулы и судейство, но не устройство движка. Поведение stable, которого нет в lazer, берётся из McOsu.
Formulas and judging are ported from lazer, its engine design is not. Stable behaviour that lazer lacks comes from McOsu.
Рендер: OpenGL и Direct3D 11Renderer: OpenGL and Direct3D 11
Шейдеры пишутся один раз на WGSL и переводятся при сборке. На Windows по замерам основным стал OpenGL, Direct3D 11 — запасной; Vulkan не понадобился.
Shaders are written once in WGSL and translated at build time. On Windows, measurements made OpenGL the default and Direct3D 11 the fallback; Vulkan wasn't needed.
Звук: WASAPI и PipeWireAudio: WASAPI and PipeWire
Exclusive-режим в обход системного микшера на Windows, маленький квантум PipeWire на Linux. Задержку USB-драйвера, которую PipeWire не сообщает, SLAM добавляет сам.
Exclusive mode bypasses the system mixer on Windows; a small PipeWire quantum on Linux. SLAM adds the USB driver delay PipeWire doesn't report.
Текст: свои MSDF-глифыText: own MSDF glyphs
Глифы любого размера остаются чёткими. Генерация идёт в отдельном потоке, кадр её не ждёт.
Glyphs stay sharp at any size. They are generated on a separate thread, the frame never waits for them.
Два языка с первого дняTwo languages from day one
Все строки идут через ключи Fluent, русский и английский переключаются на лету.
Every string goes through Fluent keys; Russian and English switch on the fly.
Только osu!standardosu!standard only
Один режим, сделанный хорошо. Редактора карт и скачивания карт внутри клиента не будет.
One mode, done well. No in-client beatmap editor and no beatmap downloads.
{ ДОРОЖНАЯ КАРТА }{ ROADMAP }
Десять этапов до бетыTen milestones to the beta
Этап закрыт, только когда его критерии проверены тестами или замером. Каждый закрытый этап поднимает версию: M2 стал 0.1, M3 станет 0.2.
A milestone closes only when its criteria are proven by tests or measurements. Each closed milestone bumps the version: M2 became 0.1, M3 will be 0.2.
M0
Фундамент движкаEngine foundation
Окно, потоки, лимитер кадров, рендер и звук. Стек проверен на целевых цифрах до того, как на него легло всё остальное.
Window, threads, frame limiter, rendering and audio. The stack hit its target numbers before anything else was built on it.
готовоdone
M1
Ядро без графикиCore without graphics
Форматы карт и реплеев, правила osu!standard, базовые моды и симулятор реплеев без графики.
Beatmap and replay formats, osu!standard rules, base mods and a headless replay simulator.
готовоdone
M2
Играбельный геймплейPlayable gameplay
Карты играются от начала до конца: объекты, хитсаунды, офсеты, выбор карты, результаты, настройки. Вышел как 0.1.0.
Maps play from start to finish: objects, hitsounds, offsets, song select, results, settings. Shipped as 0.1.0.
готовоdone
M3
СкиныSkins
Уже есть: HUD из скина, отсчёт, стрелки и pass/fail в перерывах. Дальше: горячая перезагрузка скинов, импорт .osk, сборка скина из элементов разных скинов и раскладки HUD stable, lazer и SLAM.
Done so far: HUD from the skin, countdown, warning arrows and pass/fail in breaks. Next: skin hot reload, .osk import, building a skin from elements of different skins, and stable, lazer and SLAM HUD layouts.
сейчасnow
M4
Библиотека и выбор песниLibrary and song select
Своё хранилище на SQLite, импорт из stable и lazer, вложенные коллекции, офсет карты, локальные профили. Цель — быстрая работа на 100 000 сложностей.
Own SQLite storage, import from stable and lazer, nested collections, per-map offset, local profiles. The target is staying fast at 100,000 difficulties.
0.3
M5
HUD
Полный набор элементов HUD, pp-счётчик, редактор раскладки: положение, размер, поворот и спрайт любого элемента, свои шрифты.
A full set of HUD components, a pp counter, a layout editor (position, size, rotation and sprite of any element), custom fonts.
0.4
M6
РеплеиReplays
Просмотр реплеев stable и lazer с перемоткой вперёд и назад и скоростью воспроизведения. Свои реплеи открываются в lazer.
Watching stable and lazer replays with seeking both ways and playback speed. Your own replays open in lazer.
0.5
M7
Моды, настройки, экспортMods, settings, export
Экспорт .osz, .osk, .osr, перенос всех настроек одним файлом, мастер калибровки офсета.
Export of .osz, .osk, .osr, all settings in one file, an offset calibration wizard.
0.6
M8
ПлагиныPlugins
Luau в песочнице: геймплейные моды, модули интерфейса, коннекторы к серверам. Встроенный Hidden будет переписан как пример плагина.
Sandboxed Luau: gameplay mods, interface modules, server connectors. The built-in Hidden will be rewritten as an example plugin.
0.7
M9
Темы, языки, редактор, релизThemes, languages, editor, release
Свои темы, языковые пакеты, API для внешнего редактора карт, установщик для Windows — и первая бета.
Custom themes, language packs, an API for an external beatmap editor, a Windows installer, and the first beta.
бетаbeta
…
ПозжеLater
macOS, ASIO, каталог плагинов, точный профиль судейства stable начиная со спиннеров, Vulkan — если понадобится.
macOS, ASIO, a plugin catalogue, an exact stable judging profile starting with spinners, Vulkan if it is ever needed.
{ СКАЧАТЬ }{ DOWNLOAD }
Альфа 0.1.2 для тестеровAlpha 0.1.2 for testers
Многого ещё нет, возможны вылеты. Если что-то сломалось — напиши в Discord или открой issue на GitHub, это правда помогает.
A lot is still missing and crashes are possible. If something breaks, tell me on Discord or open an issue on GitHub; it really helps.