ParlorNet
Turn-based game server for any computer, old or new
Clients | Protocols | Browsers | Telnet programs | Docs | Source

fiveinarow/1 (draft)

Two players. Single-step moves (no staged). Flag nomoves: every empty point is a legal move, so there is no move list (M); a client may check a move with CHK.

Rulesets:

In both, seat 0 plays first, the players alternate one stone a turn, there is no passing, no opening restriction and no swap, and the game is a draw when the board is full with no winning line.

Options: size= (the board is size by size points, 9 to 19, default 15). The time per turn is the table's (turn=, protocol.md).

The ruleset is the table's (NEW fiveinarow standard); the plugin reads it from the rules field of the new request and plays freestyle when the field is absent.

Colours are not part of the contract: seat 0 and seat 1, with a frontend free to show them as black and white (seat 0 black, as is usual for the first player), X and O, or anything else.

Static geometry (flag G)

LineMeaning
BRD w hThe board: w columns by h rows of points (square: w = h = size).
RUL rulesThe ruleset, freestyle or standard, so a frontend can say what wins.

Points

A point is a column letter and a row number, h8: columns a to s from the left, rows 1 to 19 from the top, as far as the board goes (a-o and 1-15 on the standard board, whose centre is h8). Input is case-insensitive.

View lines

LineMeaning
P seat pt pt ...The stones of one seat, as a list of points in the order they were played. A seat with many stones has several P lines, each at most 78 characters; a client appends them. No P line before the seat's first stone.
C n0 n1Stones per seat.
L seat ptThe last stone played (absent before the first move).
F pt pt ...The winning line, once the game is won: its points from one end to the other (five, or up to nine in freestyle).
W seatWhose turn it is, -1 once the game is over.
T seat pointsScores (common line; not sent).

The stones are a coordinate list, not a grid: a board is mostly empty for most of a game (protocol.md, sparse structures). Since seat 0 plays first and the players alternate, the order of the P lists also gives every stone's move number: seat 0's k-th stone is move 2k-1, seat 1's k-th is move 2k (counting from 1).

Move tokens

One point per move: MOV 3 h8. The point must be on the board and empty. Errors: no such point, that point is taken, not your turn, the game is over. CHK 3 h8 answers OK wins for a move that wins and OK for any other legal move.

Events

Size

Full view (with V, CLK, the geometry and S): about 60 bytes at the start, about 200 bytes after 40 stones, at most about 900 bytes for a full 15 by 15 board (15 P lines) and about 1430 bytes for a full 19 by 19 board (21 P lines). A typical event is 10-15 bytes (EVT 3 41 PUT 0 h8); the winning move's events are about 40 bytes.

Frontends

This doc on GitHub


 These pages cover every ParlorNet server. | Source code | ParlorNet is free software.