Co to jest format pliku OSZ?
Plik .osz to pakiet mapy do osu!, darmowej gry rytmicznej stworzonej przez Deana Herberta (peppy) i dystrybuowanej przez ppy Pty Ltd. Strukturalnie plik .osz to standardowe archiwum ZIP ze zmienionym rozszerzeniem na .osz - przywrócenie rozszerzenia .zip i otwarcie go dowolnym narzędziem do archiwizacji natychmiast ujawnia zawartość.
Wewnątrz typowego pakietu .osz znajdziesz:
- Jeden lub więcej plików definicji mapy
.osu(tekst UTF-8, wewnętrzna wersja formatu 14) - Ścieżkę dźwiękową, zazwyczaj
.mp3lub.ogg - Obraz tła (
.pnglub.jpg) - Opcjonalne skrypty storyboardu oraz niestandardowe próbki dźwięków uderzeń (hitsounds) w formacie
.wavlub.ogg
Gdy klient osu! otwiera plik .osz, automatycznie wypakowuje archiwum do folderu Songs i rejestruje wszystkie dołączone poziomy trudności. Mapy są dystrybuowane przez stronę internetową osu!; kliknięcie tam linku pobierania powoduje, że klient bezpośrednio importuje plik. Klient osu!lazer, który osiągnął status stabilny w 2024 roku, również akceptuje importy .osz na systemach Windows, macOS, Linux, Android oraz iOS.
Integralność jest weryfikowana za pomocą sum kontrolnych CRC-32 dla każdego wpisu ZIP oraz skrótów MD5 dla każdego pliku .osu, przy czym te ostatnie służą do walidacji wyników przesyłanych do systemu rankingowego online. Rozmiary pakietów zazwyczaj wahają się od 2 MB do 150 MB, zależnie od długości dźwięku i liczby dołączonych poziomów trudności.
Bezpieczeństwo
RYZYKO: LOWPliki OSZ zawierają wyłącznie dźwięk, obrazy i tekstowe pliki .osu - brak plików wykonywalnych. Niskie ryzyko. Pobieraj tylko z oficjalnej strony osu.ppy.sh, aby uniknąć zmodyfikowanych plików. Nieoficjalne strony z mirrorami czasem dołączają do plików .osz instalatory z oprogramowaniem reklamowym - używaj wbudowanego pobierania w kliencie osu! lub oficjalnej strony.
Szczegóły formatu
w pigułceProgramy otwierające pliki OSZ
Windows2 apps
osu!
Darmowy Kliknij dwukrotnie plik .osz; osu! automatycznie go zaimportuje i wypakuje do folderu Songs. 
7-Zip
Open-source Prawy przycisk myszy → Otwórz archiwum (traktuj jako ZIP), aby przejrzeć zawartość bez instalowania osu!. 
macOS1 app
Linux1 app
Android1 app
osu!lazer (Android)
Darmowy Zainstaluj osu!lazer z Google Play lub strony osu!; otwórz plik .osz, aby zaimportować.
osu!lazer (iOS)
Darmowy Zainstaluj osu!lazer z App Store; użyj aplikacji Pliki, aby otworzyć .osz i przekazać go do osu!lazer. Szczegóły techniczne
specyfikacja| Format kontenera | Standardowe archiwum ZIP; magiczne bajty `50 4B 03 04` pod offsetem 0, identyczne jak w każdym pliku `.zip` |
| Wewnętrzny format mapy | Pliki tekstowe UTF-8 `.osu`; obecna wewnętrzna wersja formatu to 14 (od 2013 r.); starsze mapy mogą używać wersji 9-13 |
| Kodowanie dźwięku | Zazwyczaj MP3 (128-320 kbps) lub OGG Vorbis (128-192 kbps); format nie narzuca ścisłych limitów kodowania |
| Format obrazu | PNG lub JPEG dla grafik tła; brak wymuszonego limitu rozdzielczości |
| Kompresja | DEFLATE dla każdego wpisu (ZIP); pliki audio i obrazy są często przechowywane metodą ZIP STORED (bez kompresji) |
| Integralność mapy | Skrót MD5 dla każdego pliku `.osu` używany do walidacji rankingu online; CRC-32 dla każdego wpisu ZIP (standard ZIP) |
| Typowy rozmiar pakietu | 2 MB - 150 MB zależnie od długości dźwięku i liczby dołączonych poziomów trudności |
| Typowa liczba plików | 10-50 plików na pakiet: jeden `.osu` na poziom trudności plus wspólne zasoby audio, tła i dźwięków uderzeń |
| Typ MIME | `application/x-osu-beatmap-archive` (zarejestrowany przez klienta osu!); `application/zip` również akceptowany |
| Obsługa platform | Windows, macOS, Linux (osu!stable i osu!lazer); Android i iOS (osu!lazer, stabilny od 2024 r.) |
| Zachowanie przy imporcie | Klient osu! automatycznie wypakowuje do folderu Songs przy otwarciu pliku; nie jest wymagana ręczna ekstrakcja przez użytkownika |
| Opcjonalny storyboard | Skrypt storyboardu `.osb` lub sekcja storyboardu wewnątrz `.osu`; niestandardowy język skryptowy dla animacji i efektów |
| Próbki dźwięków uderzeń | Pliki audio WAV lub OGG dołączone do pakietu; nadpisują domyślne dźwięki gry dla danej mapy |
| Kolejność bajtów | Little-endian (standardowa struktura ZIP) |
| Wydano | 2007 (osu! initial release, September 2007) |
| Najnowsza wersja | N/A (format has not been versioned externally; osu! file format v14 internally for .osu files) |
| Specyfikacja | osu.ppy.sh |
Konwersje OSZ
Pytania i odpowiedzi społeczności
pytania użytkownikówBrak pytań - bądź pierwszą osobą, która zapyta o pliki OSZ.
