Was ist das OSZ-Dateiformat?
Eine .osz-Datei ist ein Beatmap-Paket für osu!, das kostenlose Rhythmusspiel, das von Dean Herbert (peppy) entwickelt und von ppy Pty Ltd vertrieben wird. Strukturell ist eine .osz-Datei ein Standard-ZIP-Archiv, das mit der Endung .osz umbenannt wurde - wenn man sie wieder in .zip umbenennt und mit einem beliebigen Archivierungstool öffnet, wird der Inhalt sofort sichtbar.
In einem typischen .osz-Paket finden Sie:
- Eine oder mehrere
.osu-Beatmap-Definitionsdateien (UTF-8-Text, interne Formatversion 14) - Eine Tonspur, normalerweise
.mp3oder.ogg - Ein Hintergrundbild (
.pngoder.jpg) - Optionale Storyboard-Skripte und benutzerdefinierte Hitsound-Samples im Format
.wavoder.ogg
Wenn der osu!-Client eine .osz-Datei öffnet, extrahiert er das Archiv automatisch in den Ordner „Songs“ und registriert alle enthaltenen Schwierigkeitsgrade. Beatmaps werden über die osu!-Website verbreitet; das Klicken auf einen Download-Link dort veranlasst den Client, die Datei direkt zu importieren. Der osu!lazer-Client, der 2024 den stabilen Status erreichte, akzeptiert ebenfalls .osz-Importe unter Windows, macOS, Linux, Android und iOS.
Die Integrität wird mittels CRC-32-Prüfsummen pro ZIP-Eintrag und MD5-Hashes pro .osu-Datei verifiziert, wobei letztere zur Validierung von Scores verwendet werden, die an das Online-Ranglistensystem übermittelt werden. Die Paketgrößen liegen in der Regel zwischen 2 MB und 150 MB, abhängig von der Audiolänge und der Anzahl der enthaltenen Schwierigkeitsgrade.
Sicherheit
RISIKO: LOWOSZ-Dateien enthalten nur Audio, Bilder und reine Textdateien im Format .osu - keine ausführbaren Dateien. Geringes Risiko. Laden Sie Dateien nur von der offiziellen Website osu.ppy.sh herunter, um manipulierte Dateien zu vermeiden. Community-Mirror-Seiten bündeln .osz-Dateien manchmal mit werbebelasteten Downloadern - nutzen Sie den In-Game-Download des offiziellen osu!-Clients oder die offizielle Website.
Formatdetails
kurz gefasstProgramme zum Öffnen von OSZ-Dateien
Windows2 apps
osu!
Kostenlos Doppelklicken Sie auf die .osz-Datei; osu! importiert und extrahiert sie automatisch in den Ordner „Songs“. 
7-Zip
Open Source Rechtsklick → Archiv öffnen (als ZIP behandeln), um den Inhalt ohne Installation von osu! zu prüfen. 
macOS1 app
osu! (lazer)
Kostenlos Laden Sie osu!lazer für macOS herunter; Datei → Importieren von, wählen Sie die .osz-Datei aus. 
Linux1 app
osu! (lazer)
Kostenlos Laden Sie osu!lazer für macOS herunter; Datei → Importieren von, wählen Sie die .osz-Datei aus. 
Android1 app
osu!lazer (Android)
Kostenlos Installieren Sie osu!lazer über Google Play oder die osu!-Website; öffnen Sie die .osz-Datei zum Importieren.
osu!lazer (iOS)
Kostenlos Installieren Sie osu!lazer aus dem App Store; verwenden Sie die Dateien-App, um die .osz-Datei zu öffnen und an osu!lazer zu übergeben. Technische Details
technische Spezifikation| Container-Format | Standard-ZIP-Archiv; Magic Bytes `50 4B 03 04` bei Offset 0, identisch mit jeder `.zip`-Datei |
| Internes Beatmap-Format | `.osu` UTF-8-Textdateien; aktuelle interne Formatversion 14 (seit 2013); ältere Maps können die Versionen 9-13 verwenden |
| Audiokodierung | Typischerweise MP3 (128-320 kbps) oder OGG Vorbis (128-192 kbps); keine strikte Kodierungsbeschränkung durch das Format |
| Bildformat | PNG oder JPEG für Hintergrundgrafiken; keine erzwungene Auflösungsbeschränkung |
| Kompression | DEFLATE pro Eintrag (ZIP); Audio- und Bilddateien werden oft mit der ZIP-Methode STORED (unkomprimiert) gespeichert |
| Beatmap-Integrität | MD5-Hash pro `.osu`-Datei zur Validierung der Online-Rangliste; CRC-32 pro ZIP-Eintrag (Standard-ZIP) |
| Typische Paketgröße | 2 MB - 150 MB, abhängig von der Audiolänge und der Anzahl der enthaltenen Schwierigkeitsgrade |
| Typische Dateianzahl | 10-50 Dateien pro Paket: eine `.osu` pro Schwierigkeitsgrad plus gemeinsam genutzte Audio-, Hintergrund- und Hitsound-Assets |
| MIME-Typ | `application/x-osu-beatmap-archive` (vom osu!-Client registriert); `application/zip` wird ebenfalls akzeptiert |
| Plattformunterstützung | Windows, macOS, Linux (osu!stable und osu!lazer); Android und iOS (osu!lazer, stabil seit 2024) |
| Importverhalten | Der osu!-Client extrahiert beim Öffnen der Datei automatisch in den Ordner „Songs“; keine manuelle Extraktion durch den Benutzer erforderlich |
| Optionales Storyboard | `.osb`-Storyboard-Skript oder eingebetteter Storyboard-Abschnitt in `.osu`; eigene Skriptsprache für Animationen und Effekte |
| Hitsound-Samples | WAV- oder OGG-Audiodateien im Paket enthalten; überschreiben die Standard-Sounds des Spiels pro Beatmap |
| Byte-Reihenfolge | Little-endian (Standard-ZIP-Struktur) |
| Veröffentlicht | 2007 (osu! initial release, September 2007) |
| Neueste Version | N/A (format has not been versioned externally; osu! file format v14 internally for .osu files) |
| Spezifikation | osu.ppy.sh |
OSZ-Konvertierungen
Community Q&A
von Nutzern gefragtNoch keine Fragen - stellen Sie die erste Frage zu OSZ-Dateien.
