¿Por qué un formato independiente?

El formato estándar para registros de partidas de ajedrez bidimensional es PGN (Portable Game Notation), un formato de texto sin formato desarrollado en la década de 1990 cuyo lenguaje de movimientos es la Notación Algebraica Estándar (SAN). SAN está diseñado para un tablero de 8×8: especifica únicamente la casilla de destino, omite la casilla de origen y usa un sistema de desambiguación apropiado para esa geometría.

Raumschach requiere algo distinto. La partida se juega en un tablero de 5×5×5 de 125 casillas distribuidas en cinco niveles. Cada casilla requiere tres coordenadas — nivel, columna y fila — y la notación IRF registra siempre tanto el origen como el destino de cada movimiento, precedido por la figurina Unicode de la pieza que se mueve. El juego también introduce símbolos — jaque de tablero (††), jaque espacial (†††) y ahogado (≡) — que no tienen equivalentes en PGN. Intentar analizar la notación IRF como SAN produce errores o lecturas silenciosamente incorrectas.

Por ello, RGN toma prestadas las convenciones de contenedor de PGN — las cabeceras de etiquetas entre corchetes, la numeración de movimientos, el token de resultado y la sintaxis de comentarios — mientras especifica su propio lenguaje de movimientos. El formato es autoidentificable: la etiqueta obligatoria [Variant "Raumschach-Normal-Form"] indica claramente a cualquier lector o software que el texto de movimientos es tridimensional y no debe analizarse como SAN. Los archivos RGN son texto UTF-8 sin formato y pueden abrirse en cualquier editor de texto.

Formato del archivo

Sección de cabecera

El archivo comienza con una serie de líneas de pares de etiquetas. Cada línea tiene la forma:

Las etiquetas deben aparecer una por línea, al inicio del archivo, antes de cualquier texto de movimientos. Se definen las siguientes etiquetas:

Se pueden incluir etiquetas adicionales para partidas por correspondencia o partidas anotadas: [Round], [Annotator], [WhiteElo], [BlackElo]. Cualquier etiqueta no reconocida es ignorada por las herramientas IRF.

Sección de movimientos

Una línea en blanco separa la sección de cabecera de la sección de movimientos. Los movimientos se escriben en Notación Algebraica de Figurinas IRF, en forma completa de origen–destino:

Los pares de movimientos se agrupan por número de movimiento completo de la manera estándar: 1. MovimientoBlancas MovimientoNegras. Se pueden insertar comentarios entre movimientos usando llaves: { texto del comentario }. La sección de movimientos concluye con el token de resultado en su propia línea, que coincide con el valor de la etiqueta [Result].

Ejemplo completo

A continuación se muestra una partida ilustrativa corta en formato RGN. Las siete etiquetas requeridas están presentes. La partida termina en jaque espacial en el movimiento 12.

Guardar una partida desde raumschach.org

El juego web en raumschach.html genera un archivo RGN completo automáticamente al concluir una partida. No se requiere transcripción manual.

1. Juega una partida hasta el final (jaque espacial, ahogado, tablas por regla de movimientos o tiempo agotado).
2. Cuando aparezca la pantalla de fin de partida, se mostrará la lista completa de movimientos. Haz clic en Descargar .rgn.
3. Tu navegador guarda un archivo llamado raumschach_YYYYMMDD.rgn en tu carpeta de descargas. El archivo contiene todas las etiquetas de cabecera completadas con los metadatos de la partida: fecha, jugadores, control de tiempo y motivo de terminación.
4. El archivo está listo para cargarlo en la herramienta de análisis o enviarlo a la IRF.

Analizar una partida en analysis.html

La herramienta Análisis de Raumschach acepta archivos RGN directamente. Al cargar un archivo, se completa automáticamente la lista de movimientos y se muestra la información de cabecera de la partida — jugadores, fecha, control de tiempo y motivo de terminación — sobre el tablero de análisis.

1. Abre analysis.html.
2. Haz clic en Cargar archivo .rgn. Selecciona tu archivo .rgn en el selector de archivos.
3. La lista de movimientos se extrae del archivo y se coloca en el cuadro de entrada. Los metadatos de la partida aparecen en una franja sobre el cuadro.
4. Establece la potencia del motor con el control deslizante y luego presiona Analizar →.
5. El tablero avanza a la posición final. Retrocede por la partida con las teclas de flecha o haciendo clic en los movimientos de la tabla. El motor Raumfischer evalúa cada movimiento y señala automáticamente los errores graves (??), errores (?) y jugadas dudosas (?!).

Alternativamente, si no tienes el archivo RGN, puedes pegar la lista de movimientos sin formato directamente en el cuadro de texto. La herramienta de análisis acepta listas de movimientos simples así como la entrada RGN completa; si se pega una lista de movimientos simple, simplemente no aparecerá la cabecera de metadatos de la partida.

Enviar una partida a la IRF

Las partidas con clasificación deben enviarse al administrador de la IRF como registros de partidas completos. El archivo RGN satisface automáticamente todos los requisitos de envío.

1. Asegúrate de que el archivo RGN esté completo: las siete etiquetas requeridas deben estar presentes, y los nombres IRF de ambos miembros deben aparecer en las etiquetas [White] y [Black].
2. Verifica que la etiqueta [Result] coincida con el resultado real de la partida.
3. Adjunta el archivo .rgn a un correo electrónico y envíalo al administrador de la IRF a través de la página de contacto. El asunto debe indicar: Envío de partida — [tu nombre del miembro] — [fecha].
4. El administrador confirmará la recepción, asignará una actualización de clasificación a la partida y añadirá el resultado a la lista de clasificación IRF.

Relación con PGN

RGN es un descendiente especializado de PGN, no una extensión de este. Ambos formatos comparten la misma estructura externa — etiquetas entre corchetes, numeración de movimientos con punto, comentarios entre llaves y un token de resultado — por lo que cualquier lector familiarizado con PGN encontrará un archivo RGN inmediatamente legible. Las diferencias son las siguientes.

• La notación de movimientos RGN usa figurinas Unicode de piezas seguidas de coordenadas completas de origen–destino; la notación de movimientos PGN (SAN) usa letras de piezas y solo la casilla de destino.
• Las coordenadas RGN son tridimensionales (nivel, columna, fila); las coordenadas SAN son bidimensionales.
• RGN define tres sufijos relacionados con el jaque (†, ††, †††) además del único † usado en PGN.
• RGN requiere [Variant "Raumschach-Normal-Form"]; PGN asume ajedrez estándar cuando no hay etiqueta de variante.
• Los archivos RGN usan la extensión .rgn, no .pgn, para evitar confusiones y lecturas incorrectas por software PGN.

Los archivos RGN no deben renombrarse a .pgn. Ningún lector PGN existente los analizará correctamente, y los resultados serían silenciosamente incorrectos en lugar de visiblemente erróneos.

Compatibilidad con texto sin formato

Dado que RGN es texto UTF-8 sin formato, puede redactarse, leerse o editarse en cualquier editor de texto. Los caracteres especiales — las figurinas de piezas (♔︎–♙︎, U+2654–U+2659), el guión medio, los símbolos de daga y el signo de igualdad para la promoción — deben almacenarse como sus puntos de código Unicode en lugar de escapados. El archivo debe usar terminaciones de línea Unix (LF) cuando sea posible, aunque las terminaciones de Windows (CRLF) también son aceptadas por las herramientas IRF.

Un archivo RGN mínimo válido requiere solo las siete etiquetas de cabecera requeridas y al menos un movimiento. Una partida en curso que aún no ha concluido debe usar [Result "*"] y omitir la etiqueta [Termination].