O formato PGN explicado: como ler e escrever notação de xadrez

Uma explicação direta do padrão PGN: cabeçalhos, texto dos lances, anotações e resultados para ler, criar ou arrumar qualquer arquivo de partida.

O PGN — Portable Game Notation — é o formato em texto puro que praticamente todo programa de xadrez no mundo utiliza para salvar partidas. Ele pode parecer confuso na primeira vez que você o abre em um bloco de notas, mas sua lógica é simples quando você entende a divisão das partes. Veja para que serve cada elemento de um arquivo PGN.

As duas seções de todo arquivo PGN

Uma partida em PGN tem sempre duas partes bem definidas: um bloco de etiquetas de cabeçalho (tag pairs) no topo, e o texto dos lances (movetext) abaixo dele. As etiquetas identificam os dados da partida; o texto dos lances é o jogo propriamente dito.

Etiquetas de cabeçalho (Tag pairs)

As etiquetas seguem o padrão [Event "Campeonato Mundial"] — um nome entre colchetes seguido do valor entre aspas. A norma oficial do PGN define uma lista essencial de sete etiquetas conhecida como Seven Tag Roster:

• Event — o nome do torneio ou do confronto.
• Site — a cidade ou local da partida.
• Date — no formato AAAA.MM.DD, usando ?? para dados desconhecidos.
• Round — o número da rodada, se houver.
• White e Black — os nomes dos jogadores.
• Result — 1-0, 0-1, 1/2-1/2 ou * se a partida ainda estiver em andamento.

Quase todos os programas exportam campos adicionais, como ECO (código da abertura), WhiteElo, BlackElo ou TimeControl. Nenhuma dessas etiquetas extras é obrigatória para que o arquivo seja lido por um analisador — a engine só precisa da sequência de lances —, mas preenchê-las ajuda a manter suas partidas bem catalogadas.

O texto dos lances (Movetext)

Logo após as etiquetas começam os lances reais, redigidos na notação algébrica padrão com a numeração correspondente:

1. e4 e5 2. Nf3 Nc6 3. Bb5 a6 4. Ba4 Nf6 5. O-O Be7 1-0

Cada lance das Brancas vem acompanhado do seu número e ponto; a resposta das Negras vem na sequência direta sem número (embora a notação 5...Be7 também seja válida e comum quando um comentário separa os lances). O texto termina obrigatoriamente com o resultado da partida, repetindo a etiqueta Result.

Comentários e anotações

Comentários em texto livre são escritos entre chaves: 3. Bb5 {Abertura Ruy Lopez}. Variantes secundárias calculadas pelo anotador entram entre parênteses e podem ter subníveis. Os símbolos numéricos de anotação (NAG), como $1 (bom lance, “!”) ou $4(erro grave, “??”), oferecem um jeito universal de rotular a qualidade dos lances sem depender de idioma. A maioria das engines limpa esses comentários automaticamente para analisar apenas a variante principal.

Um exemplo mínimo e perfeitamente válido

Além dos campos básicos, as etiquetas são opcionais e podem até ficar quase vazias. O exemplo a seguir já é um PGN oficial e completo:

[Event "?"] [Site "?"] [Date "????.??.??"] [Round "?"] [White "?"] [Black "?"] [Result "*"] 1. e4 e5 *

Por essa razão, digitar uma planilha manuscrita no computador funciona perfeitamente: você não precisa preencher cada etiqueta com perfeição para que uma ferramenta processe e analise a partida. Veja mais exemplos de PGN prontos para usar com jogos completos para copiar.

Erros de formatação mais comuns

Alguns tropeços travam parsers mais rígidos: usar notação descritiva antiga em vez da algébrica (P4R em vez de e4), esquecer de fechar chaves ou parênteses de comentários, e não incluir o resultado no fim dos lances. Um leitor tolerante releva etiquetas faltantes, mas linhas de lances quebradas são a causa número um de rejeição no upload.

Com o arquivo pronto, cole-o no Chesslume para receber uma análise gratuita do Stockfish — sem complicações técnicas e sem precisar ser um perito no formato.