Что такое формат файла OSZ?
Файл .osz представляет собой пакет карт для osu!, бесплатной ритм-игры, разработанной Дином Гербертом (peppy) и распространяемой ppy Pty Ltd. Структурно файл .osz является стандартным архивом ZIP, переименованным с расширением .osz - если вернуть ему расширение .zip и открыть любым архиватором, содержимое станет доступно мгновенно.
Внутри типичного пакета .osz вы найдете:
- Один или несколько файлов определений карт
.osu(текст UTF-8, внутренняя версия формата 14) - Аудиодорожку, обычно в формате
.mp3или.ogg - Фоновое изображение (
.pngили.jpg) - Дополнительные скрипты сторибордов и пользовательские сэмплы звуков попаданий в форматах
.wavили.ogg
Когда клиент osu! открывает файл .osz, он автоматически распаковывает архив в папку «Songs» и регистрирует все включенные уровни сложности. Карты распространяются через веб-сайт osu!; нажатие на ссылку для скачивания инициирует прямой импорт файла клиентом. Клиент osu!lazer, достигший стабильного статуса в 2024 году, также поддерживает импорт .osz на Windows, macOS, Linux, Android и iOS.
Целостность проверяется с помощью контрольных сумм CRC-32 для каждой записи ZIP и хешей MD5 для каждого файла .osu, последние используются для проверки результатов, отправляемых в систему онлайн-рейтинга. Размер пакетов обычно варьируется от 2 МБ до 150 МБ в зависимости от длительности аудио и количества включенных уровней сложности.
Безопасность и защита
РИСК: LOWФайлы OSZ содержат только аудио, изображения и текстовые файлы .osu - в них нет исполняемого кода. Риск низкий. Скачивайте только с официального сайта osu.ppy.sh, чтобы избежать поддельных файлов. Сторонние зеркала иногда упаковывают файлы .osz в загрузчики с рекламным ПО - используйте внутриигровую загрузку клиента osu! или официальный сайт.
Детали формата
в двух словахПрограммы, открывающие файлы OSZ
Windows2 apps
osu!
Бесплатно Дважды щелкните по файлу .osz; osu! автоматически импортирует и извлечет его в папку «Songs». 
7-Zip
Открытый код Правой кнопкой мыши → «Открыть архив» (обрабатывать как ZIP), чтобы просмотреть содержимое без установки osu!. 
macOS1 app
Linux1 app
Android1 app
osu!lazer (Android)
Бесплатно Установите osu!lazer из Google Play или с сайта osu!; откройте файл .osz для импорта.
osu!lazer (iOS)
Бесплатно Установите osu!lazer из App Store; используйте приложение «Файлы», чтобы открыть .osz и передать его в osu!lazer. Технические подробности
глубокая спецификация| Формат контейнера | Стандартный архив ZIP; магические байты `50 4B 03 04` по смещению 0, идентичен любому файлу `.zip` |
| Внутренний формат карты | Текстовые файлы `.osu` в кодировке UTF-8; текущая внутренняя версия формата 14 (с 2013 года); старые карты могут использовать версии 9-13 |
| Кодирование аудио | Обычно MP3 (128-320 кбит/с) или OGG Vorbis (128-192 кбит/с); формат не накладывает строгих ограничений на кодирование |
| Формат изображений | PNG или JPEG для фонового арта; ограничений по разрешению нет |
| Сжатие | DEFLATE для каждой записи (ZIP); аудио и изображения часто хранятся методом ZIP STORED (без сжатия) |
| Целостность карты | Хеш MD5 для каждого файла `.osu` используется для валидации в онлайн-рейтинге; CRC-32 для каждой записи ZIP (стандарт ZIP) |
| Типичный размер пакета | 2 МБ - 150 МБ в зависимости от длины аудио и количества уровней сложности |
| Типичное количество файлов | 10-50 файлов в пакете: один `.osu` на каждый уровень сложности плюс общие ресурсы аудио, фона и звуков |
| MIME-тип | `application/x-osu-beatmap-archive` (зарегистрирован клиентом osu!); также принимается `application/zip` |
| Поддержка платформ | Windows, macOS, Linux (osu!stable и osu!lazer); Android и iOS (osu!lazer, стабилен с 2024 года) |
| Поведение при импорте | Клиент osu! автоматически извлекает содержимое в папку «Songs» при открытии файла; ручная распаковка пользователем не требуется |
| Опциональный сториборд | Скрипт сториборда `.osb` или встроенная секция сториборда в `.osu`; собственный язык сценариев для анимаций и эффектов |
| Сэмплы звуков | Аудиофайлы WAV или OGG, упакованные в пакет; переопределяют стандартные звуки игры для конкретной карты |
| Порядок байтов | Little-endian (стандартная структура ZIP) |
| Выпущен | 2007 (osu! initial release, September 2007) |
| Последняя версия | N/A (format has not been versioned externally; osu! file format v14 internally for .osu files) |
| Спецификация | osu.ppy.sh |
Конвертации OSZ
Вопросы и ответы сообщества
спрошено пользователямиВопросов пока нет - станьте первым, кто спросит о файлах OSZ.
