Формат TRF: как устроен файл отчёта о шахматном турнире

Формат появился как способ передать турнир целиком одним текстовым файлом: и параметры соревнования, и всех участников, и каждую сыгранную партию. Используется он в двух сценариях.

• Отчёт в федерацию. Организатор выгружает завершённый турнир и отправляет файл на обсчёт рейтинга.
• Обмен с движком жеребьёвки. Программа отдаёт движку текущее состояние турнира в TRF и получает пары следующего тура. Именно так работает bbpPairings.

Отсюда две разновидности файла. Для жеребьёвки достаточно минимума - номера игроков, очки и история туров. Для отчёта нужна заполненная шапка и полные данные каждого участника: без ID ФИДЕ, пола и даты рождения отчёт не примут.

Актуальная версия - TRF-2026, при этом сохраняется совместимость со старым вариантом TRF(bx).

Файл начинается со строк описания турнира. Каждая начинается с трёхзначного кода, дальше идёт значение.

Строки XXR и XXC - служебные, они нужны движку жеребьёвки. Без XXC движок не знает, каким цветом играет первый номер в первом туре, и отказывается считать пары.

Контроль времени записывается в принятом виде: 10'+5" означает 10 минут на партию и 5 секунд добавки на ход.

Главная часть файла - по одной строке 001 на каждого участника. Здесь важно понимать: поля определяются позициями символов, а не пробелами. Лишний пробел сдвигает колонку, и файл читается неправильно.

Имена пишутся латиницей: формат считает символы, а кириллица в кодировке UTF-8 занимает по два байта на букву и разъезжает колонки у тех, кто читает файл побайтово. Идентичность игрока в отчёте несут ID ФИДЕ и код федерации, а не написание фамилии - поэтому транслитерация не проблема.

После основных полей идёт история партий - по блоку на каждый тур. В блоке номер соперника, цвет и результат.

Коды результатов:

• 1 - победа, 0 - поражение, = - ничья;
• U - пропуск тура, назначенный жеребьёвкой, с полным очком;
• + и - - победа и поражение за неявку: такие партии учитываются в таблице, но не идут в обсчёт рейтинга.

Важная деталь: результат записывается с точки зрения самого игрока, а не белых. Если вы пишете свою программу, это первое место, где обычно возникает ошибка - партия отражается в двух строках, и у соперников коды должны быть зеркальными.

Вторая частая ошибка - ссылка на снятого участника. Если игрока убрали из турнира, а история партий на него ссылается, движок споткнётся. Корректный выход - записать такую партию как игру без соперника: 0000 и прочерк вместо цвета.

Иногда турнир начисляет очки не по классической схеме: например, 3 за победу и 1 за ничью. Для таких случаев в формате есть расширения - коды вида BBW, BBD, BBL, задающие свои значения за победу, ничью и поражение, а также коды для пропусков и неявок.

Для обычного турнира они не нужны, но полезно знать об их существовании: встретив такую строку в чужом файле, вы поймёте, почему сумма очков не сходится с привычной арифметикой.

Вручную такой файл собирают только в исключительных случаях: одна ошибка в колонке - и отчёт разъезжается. Обычно его выгружает турнирная программа.

В приложении Vibe Chess завершённый турнир выгружается в TRF одним нажатием: шапка собирается из параметров события, данные игроков - из их профилей, история туров - из сыгранных партий. Чтобы отчёт получился полным, участники заполняют в профиле раздел стандартов ФИДЕ и ФШР: ID ФИДЕ, код ФШР, звание, пол, дату рождения и федерацию.

Тот же формат используется и внутри приложения для жеребьёвки: перед каждым туром состояние турнира отдаётся движку bbpPairings, который возвращает пары. То есть отчёт не «собирается в конце» - он живёт с турниром всё время.

• число туров в XXR совпадает с фактически сыгранным;
• у всех участников заполнены ID ФИДЕ или код федерации, если турнир рейтинговый;
• имена латиницей, длина не выходит за отведённые позиции;
• сумма очков в строке совпадает с историей туров;
• нет ссылок на игроков, которых нет в файле;
• результаты зеркальны у обоих соперников;
• контроль времени записан в принятом формате;
• указан главный судья.

Что ещё входит в пакет документов - комплект документов организатора.