Set of games
A single game info and move information
Player information
Name of the player of the white pieces. The name is given as they would appear in a telephone directory. Family, or last name, first. If a first name or first initial is available, it is seperated from the family name by a comma and a space. Finally, one or more middle initialsmay appear. If the name is unknown, a single question mark should appear as the value. The intent is to allow meaningful sorting of the value that is independent of regional name formation customs. A player who is also a computer program should have appropriate version information listed after the name of the program. The format used in the FIDE Rating Lists is appropriate for use for player name data.
Optional Elo rating. This is used for FIDE Elo ratings. Form is 4 digits, like 2899.
Optional USCF rating. This is used for USCF (United States Chess Federation) ratings. Form is 4 digits, like 2048.
The country for which the player was playing. Usually specified for Olympiads, or other international events.
Optional FIDE title. This is the standard abbreviations for FIDE titles. Accepted values are FM, IM, or GM.
Optional player's email address.
Optional URL for this player.
Optional description of the player type. The value "human" should be used for a person, while the value "program" should be used for algorithmic/computer players.
A time control consists of a limited number of moves, and a time period in which those moves must be completed.
The number of moves in the control period.
The time period in which the number of moves must be completed. If no moves are specified, then all moves must be completed within the specified time. This is called "Sudden Death".
The number of hours in which to make the number of moves.
The number of minutes in which to make the number of moves.
The number of seconds in which to make the number of moves.
A move element.
Optional text that should preceed the move.
The piece being moved.
The square being moved from.
The square being moved to.
Excellent move
Good move
Interesting move
Dubious move
Bad move
Losing move
A NAG is a Numeric Annotation Glyph. A non-negative integer from 0 to 255.
An optional minimum move display, eg: e4, Nf3, etc.
Optional text that should suffix the move.
Optional datetime of the move.
A variation of the current move. Consists of 1 or more moves, with optional end result tag.
Any description that should preceed that variation.
The moves of the variation.
An optional ending tag.
Any description that should suffic the variation.
The board squares
The possible score types enumeration.
The possible pieces used.
white pawn
white rook
white knight
white bishop
white queen
white king
black pawn
black rook
black knight
black bishop
black queen
black king
A single chess game.
defines the black and white player contents
Event related information. At least the name is required.
Name of the Event
The name of the sponsor of the Event.
This includes city and region names along with the IOC standard name for the country.
The playing round ordinal of the game
This is used for the stage of a multi-stage event, such as "preliminary" or "Semifinal".
This is used for the playing section of the event, such as "open" or "reserve".
The board number in a team event or simultaneous exhibition.
This is the starting date of the event.
Starting date of the game. Note this is not necessarily the same of the starting date of the event.
List of White player or players. At least 1 player is required.
White player information
List of Black player or players. At least 1 player is required.
Black player information
Opening information is optional.
The name of the opening
A major variation of the opening
The Encyclopedia of Chess Openings code. Form is Xdd where X is A-E, and dd is 2 digits.
The New in Chess code.
The types of time controls are: Elapsed, Incremental, SandClock.
This is the list of Time Controls used for this game. Usually there is more than 1, except for blitz games.
A specified Time Control for a period
An incremental time period, where an initial time allocation is provided, and then additional time is added for each move.
The initial number of minutes or seconds allocated for the period.
The initial number of minutes allocated.
The initial number of seconds allocated.
The number of extra seconds added after each move is made.
A SandClock, also called Hourglass. The time control is implemented as if a sandclock were set at the start of the period with an equal amount of sand in each of the two chambers and the players invert the sandclock after each move with a time forfeit indicated by an empty upper chamber. The time is specified in seconds.
Identifies the annotator or annotators of the game.
Gives the playing mode of the game.
Gives the number of ply (moves) in the game.
A description of initial board position in Forsyth-Edwards Notation.
An enumeration of the color that is on move: white or black.
Enumeration of the available castling square KQ for white Kingside/Queenside, kq for black Kingside/Queenside.
The target square, if any, of an EnPassant capture.
This represents the halfmove clock. The number is the count of halfmove (or ply) since the last pawn advance or capturing move. The value is used for the fifty move draw rule.
The halfmove ply count.
A description of the board contents, encoded in Forsyth notation. White pieces are identified by uppercase piece letter ("PNBRQK"). Black pieces are identified by lowercase piece letter ("pnbrqk"). Empty squares are represented by digits 1 though 8, and a slash ('/') is used to seperate data of adjacent ranks.
Any textual description of the game that should preceed it.
Any textual description of the game that should suffix it.
A sequences of moves, ended by a end tag.
A list of chess moves.
A game ending notation.
A game ending element.
The score is the result of the game. It is always one of four possible values: "1-0" (White wins), "0-1" (Black wins), "1/2-1/2" (drawn game), and "*" (game still in progress, game abandoned, or result otherwise unknown).
Enumeration of the reasons for the conclusion of the game.
adandoned game
result due to third party adjudication process
losing player called to greater things, one hopes
game concluded due to unforeseen circumstances
game terminated in a normal fashion
administrative forgeit due to losing player's failure to observe either the Laws of Chess or the event regulations
loss due to losing player's failure to meet time control requirements
game not terminated