| ParlorNet Turn-based game server for any computer, old or new | |
| Clients | Protocols | Browsers | Telnet programs | Docs | Source |
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.
| Line | Meaning |
|---|---|
| BRD w h | The board: w columns by h rows of points (square: w = h = size). |
| RUL rules | The ruleset, freestyle or standard, so a frontend can say what wins. |
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.
| Line | Meaning |
|---|---|
| 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 n1 | Stones per seat. |
| L seat pt | The 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 seat | Whose turn it is, -1 once the game is over. |
| T seat points | Scores (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).
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.
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.
| These pages cover every ParlorNet server. | Source code | ParlorNet is free software. |