PGN-Dateien: Schachpartien lesen, erstellen und teilen

PGN, kurz für Portable Game Notation, ist ein Klartextformat zum Speichern von Schachpartien. Ein PGN-Datensatz verbindet Tag-Paare wie Spielernamen und Ergebnis mit algebraischem Zugtext, Kommentaren und optionalen Varianten. Menschen können ihn lesen, und die meisten Schachprogramme können ihn importieren.

Dieser Leitfaden gehört zur Sammlung der Schachwerkzeuge. Verbinde einen sauberen PGN-Export mit der Checkliste zur Partienanalyse, um sowohl die Züge als auch die Überlegungen hinter kritischen Entscheidungen zu bewahren.

Die zwei Teile einer PGN-Partie

Ein PGN-Datensatz enthält:

1. Tag-Paare in eckigen Klammern; und
2. Zugtext mit nummerierten Zügen und dem Ergebnis.

Beispiel:

[Event "Training Game"]
[Site "Online"]
[Date "2026.07.16"]
[Round "1"]
[White "Player A"]
[Black "Player B"]
[Result "1-0"]

1. e4 e5 2. Nf3 Nc6 3. Bb5 a6 1-0

Die Leerzeile zwischen Tags und Zugtext verbessert Kompatibilität und Lesbarkeit.

Die sieben Standard-Tags

Die Standardliste besteht aus:

• Event: Turnier oder Partiename;
• Site: Ort oder Plattform;
• Date: normalerweise YYYY.MM.DD;
• Round: Rundenkennung;
• White: Spieler mit Weiß;
• Black: Spieler mit Schwarz; und
• Result: 1-0, 0-1, 1/2-1/2 oder *.

Zusätzliche Tags können Wertungen, Eröffnungscodes, Bedenkzeiten, Beendigungsgrund, Kommentator oder andere Metadaten enthalten. Die Unterstützung unterscheidet sich je nach Software.

Der Zugtext verwendet algebraische Notation

Züge wie e4, Nf3, Bxc6, O-O und e8=Q folgen der algebraischen Notation. Zugnummern ordnen die weißen und schwarzen Züge.

Das abschließende Ergebnissymbol im Zugtext muss mit dem Tag Result übereinstimmen. Lerne die Zugsymbole in der algebraischen Schachnotation.

Kommentare

Geschweifte Klammern speichern Kommentare:

12. d5 {Weiß schließt das Zentrum und gewinnt Raum am Damenflügel.}

In manchen PGN-Zusammenhängen kann ein Semikolon einen Kommentar bis zum Zeilenende einleiten. Geschweifte Klammern sind für übertragbare Anmerkungen eindeutiger.

Nützliche Kommentare erklären:

• die Drohung;
• Kandidatenzüge;
• die Bauernstruktur;
• die Zeit auf der Uhr;
• die Bewertung in Worten; und
• die Lektion aus einem Fehler.

Fülle die Datei nicht mit unerklärten Engine-Zahlen.

Varianten

Runde Klammern speichern alternative Varianten:

10. Re1 (10. d4 exd4 11. cxd4) 10...O-O

Varianten können verschachtelt sein, doch tiefe Verschachtelungen werden schwer lesbar. Behalte die wichtigste lehrreiche Alternative und entferne Äste, die keine Entscheidung erklären.

Anmerkungssymbole und NAGs

Menschenlesbare Symbole sind !, ?, !? und ?!. Numeric Annotation Glyphs (NAGs) verwenden in softwareorientierten PGNs Codes wie $1 für einen guten Zug.

Anwendungen können dasselbe Symbol unterschiedlich darstellen. Nutze einen Kommentar, wenn die Begründung wichtig ist.

Aus einer eigenen Stellung beginnen

Eine Partie, die nicht aus der normalen Anfangsstellung beginnt, verwendet Einrichtungs-Tags:

[SetUp "1"]
[FEN "8/8/8/4k3/8/4K3/4P3/8 w - - 0 1"]

Die FEN muss alle sechs Felder enthalten, und der Zugtext muss aus dieser Stellung legal sein. Lies den Leitfaden für FEN-Stellungen, bevor du ein PGN mit eigener Startposition erstellst.

PGN im Vergleich zu FEN

• PGN speichert eine Partie, Züge, Metadaten, Kommentare und Varianten.
• FEN speichert die Momentaufnahme einer Stellung und einen begrenzten Zustand.

Nutze PGN für Analyse und Wiedergabe. Verwende FEN, wenn du eine einzelne Aufgabe oder Analysestellung teilst.

Eine PGN-Datei sicher importieren

Prüfe vor dem Import:

1. ob die Datei Klartext enthält;
2. ob Tags private Informationen enthalten;
3. ob die Ergebnisangaben übereinstimmen;
4. ob alle Züge legal sind;
5. ob eine eigene FEN-Startstellung korrekt ist;
6. ob die Originaldatei erhalten bleibt; und
7. ob die Zielanwendung Kommentare und Varianten unterstützt.

Ein Parser kann eine fehlerhafte Partie zurückweisen, obwohl andere Partien in derselben Datei gültig bleiben.

Häufige Syntaxprobleme

• Fehlendes Anführungszeichen oder fehlende schließende Klammer in einem Tag.
• Resultat-Tag und abschließendes Ergebnis im Zugtext stimmen nicht überein.
• Illegaler oder mehrdeutiger algebraischer Zug.
• Nicht ausgeglichene Kommentarklammern oder Variantenklammern.
• Eigene Startposition ohne SetUp "1".
• Unvollständige FEN.
• Nicht standardmäßige Zeichenkodierung.
• Mehrere Partien ohne klare Trennung.

Validiere die Datei nach manueller Bearbeitung.

Teilen und Datenschutz

PGN-Tags können Namen, Benutzernamen, Veranstaltungsorte, Daten, Wertungen und Anmerkungen offenlegen. Vor der Veröffentlichung:

• entferne personenbezogene Daten, die für die Analyse nicht nötig sind;
• hole für private Kommentare eine Erlaubnis ein;
• lege weder Identität noch Zeitplan eines Kindes offen;
• prüfe die Plattformbedingungen zur Wiederverwendung von Partiedaten; und
• bewahre vorgeschriebene Quellenangaben.

Klartext lässt sich leicht kopieren. Deshalb ist die Datenschutzprüfung besonders wichtig.

Ein nützlicher Ablauf für Anmerkungen

1. Exportiere die Originalpartie.
2. Ergänze deine Gedanken ohne Engine.
3. Markiere kritische Stellungen.
4. Füge ein oder zwei Kandidatenvarianten hinzu.
5. Prüfe sie mit einer Engine.
6. Ersetze rohe Bewertungen durch Erklärungen.
7. Speichere eine neue kommentierte Kopie.

Lass das Original unverändert, damit Zugverlauf und Metadaten wiederhergestellt werden können.

Häufige Fragen

Kann eine PGN-Datei mehrere Partien enthalten?

Ja. Sie werden als aufeinanderfolgende PGN-Datensätze mit jeweils eigenen Tags und eigenem Zugtext gespeichert.

Ist PGN ein Video oder ein Brettbild?

Nein. Es ist Text. Schachsoftware rekonstruiert das Brett aus den Zügen.

Kann PGN Analysevarianten speichern?

Ja. Runde Klammern enthalten rekursive Anmerkungsvarianten, geschweifte Klammern enthalten Kommentare.

Warum lässt sich meine PGN-Datei nicht importieren?

Prüfe die Anführungszeichen der Tags, die Übereinstimmung des Ergebnisses, ausgeglichene geschweifte und runde Klammern, legale Notation sowie jede eigene FEN.

Referenz: Portable Game Notation Specification.