Status: research notes, 2026-11-21. Every fact carries a source tag like [S3] (list at the end). Anything not settled by a source is marked UNVERIFIED. Static analysis only: nothing was run and no connection was made.
Method: the GameMaster Developer's Kit (programming manual and the Pascal source of every User Kit rulebook) was found on the "Ian and Stuart's One" CD in a folder of Rhys Hollow's work, together with the later rulebooks Isolation (with source), Gravity Wars and Crystal Ball [S1][S9]. A second copy of the Dev Kit (Disc to the Future Part II, 1992) has byte-identical sources and manual [S10]. The GameMaster 1.0.0 application has no source; its 68k code keeps MacsBug routine names and was disassembled with Homebrew's capstone cstool [S4]. Offsets below such as CODE 3 0x2b06 are within a CODE resource after its 4-byte header. Files, URLs and sha256 are in a working folder outside the repository; the earlier copies are in the working folders for Dots and Boxes and Naval Combat.
- Thirteen rulebooks are known: the ten of the User Kit (December 1991), Isolation (February 1992), Gravity Wars (August-September 1992) and Crystal Ball (December 1993). An "Empire" rulebook was announced and never released (section 1).
- Three of them are ParlorNet games: Dots&Boxes, BattleShips (Naval Combat) and Othello (Reversi). Simple Talk is chat and Crystal Ball is an opponent-finding lobby; both are worth serving too.
- The rulebook layer is fully documented by source. A rulebook exchanges at most 250-character strings with its remote twin; Dots&Boxes sends M + one digit + six digits, BattleShips sends fleet strings, two-digit shots, Fire and Done, Othello sends two digits (section 3).
- The session layer is recovered from the binary. Messages are Pascal strings with a one-byte prefix, # for the rulebook and ~ for GameMaster's own control texts. A call is a TCP connection to port 918 carrying a fixed 786-byte call record. The callee answers with a text and a 10-byte address, and the caller then opens a second TCP connection to that address. It uploads the game state there and keeps that connection for play (section 2).
- Verdict: one ParlorNet server extension can be the remote GameMaster for Dots&Boxes, BattleShips and Othello, as the callee. The Mac user types the parlor's name or address in Connect; no DNS tricks are needed. It needs TCP port 918 published, a second published port for the game connection, and the parlor's public IPv4 address in its configuration. The ParlorNet types need small additions: a 13 by 11 Dots and Boxes board with a majority win, and a fixed six-shot salvo for Naval Combat (section 4). Rulebook code is never sent or accepted.
| Rulebook | Author | Date | ID string (GMRZ) | Version | Game | ParlorNet game |
| Othello | Rhys Hollow | Dec 1991 | Othello [RHS] | 0.2.0 | Othello on 8x8, local or remote | Reversi |
| Connect 4 | Rhys Hollow | Dec 1991 | Connect 4 [RHS] | 0.1.0 | Connect Four | no |
| BattleShips | Rhys Hollow | Dec 1991 | BattleShips [RHS] | 0.2.0 | Battleship with a 6-shot salvo, remote only, no saving | Naval Combat |
| Chess | Quinn | Dec 1991 | Eskimo Chess | 1.0.0 | Chess | no |
| TicTacToe | Quinn | Dec 1991 | Eskimo TicTacToe | 1.0.0 | noughts and crosses, the programmers' example | no |
| DerfBall | Peter N. Lewis | Dec 1991 | Fred [PNL] | 1.0.0 | real-time sliding-pipe ball game | no |
| Dots&Boxes | Peter N. Lewis | Oct-Dec 1991 | Dots&Boxes [PNL] | 1.0.0 | Dots and Boxes, 13 by 11 boxes | Dots and Boxes |
| Global Thermonuclear War | Peter N. Lewis | Dec 1991 | Global Thermonuclear War [PNL] | 1.0.0 | a joke after WarGames | no |
| Simple Talk | Peter N. Lewis | Dec 1991 | Simple Talk [PNL] | 1.0.0 | a copy of Unix talk | chat |
| File Transfer | Peter N. Lewis | Dec 1991 | File Transfer [PNL] | 1.0.0 | file transfer, remote only | no |
| Isolation | Rhys Hollow | 24 Feb 1992 (Info-Mac 13 May 1992) | Isolation [RHS] | 1.3.0 (connects to 1.2.0) | move a piece, then destroy a square, on 6x8 | no |
| Gravity Wars | Rhys Hollow | 9 Aug-21 Sep 1992 | Gravity Wars [RHS] | 1.4.5 | port of the Amiga Gravity Wars: missiles by angle and speed among planets | no (see clients-cannonfire.md) |
| Crystal Ball | Rhys Hollow | 16 Dec 1993 | PlayMe [RHS] | 1.0.0 | opponent finder: connects to a "Spirit World" server | lobby |
| Empire | Marcus Jager | announced only ("If Jager ever finishes") | - | - | - | - |
Sources: the User Kit list and authors in the manual [S1] ?1.3 and ?7.1 and in Rulebooks.doc [S5]; the ID strings, versions and memory sizes decoded from each rulebook's GMRZ 128 resource with the layout of [S1] ?3.3 [S4]; Isolation [S6], Gravity Wars [S7], Crystal Ball [S8]; the folder summary lists the Dev Kit, the User Kit "with 10 or so rulebooks", Isolation, Gravity Wars and Crystal Ball, with the Spirit World site list SWsites.txt [S9]. The same files are on many 1992-96 CDs (BMUG, BBS in a Box, Info-Mac 1994-01, MacFormat, Ultra Mac Games) and on the UMich archive as gamemaster1.0.cpt.hqx, gmcrystalball.cpt.hqx and crystalball1.0.sit.hqx [S12][S15]. No other rulebook was found in those listings (UNVERIFIED absence; Wayback copies of redback.cs.uwa.edu.au's FTP were not checked).
A rulebook is a file of type GMRB, creator GMST, with an empty data fork. Its code is PROC 128, called as procedure Main(var gameevent: gameEventRecord) for every event GameMaster sends it; its header is GMRZ 128: name (Str63), author and copyright (Str127 each), ID string (Str63), four BCD versions (rulebook, oldest compatible rulebook, GameMaster written for, oldest GameMaster), two memory sizes and flags (disallow save, connect, restart, swap; no idle; no sleep-query) [S1] ?2, ?3.
From the application's code [S4] unless another source is given. GameMaster 1.0.0 announces itself as version 0x0100; the rulebooks ask for 0.2.0 to 1.0.0 [S4].
- TCP: GameMaster listens on port 918 (INITTCPDAEMON, CODE 2) and calls port 918 (PLACECALL); the Connect dialog has an address field and no port field (clients-dotsandboxes.md, [S14]). The MacTCP code is Peter Lewis's [S1].
- AppleTalk: ADSP connections; machines register and are looked up with NBP type GameMaster (SETUPMACHINEINFO, FINDNAMES, CODE 2) in a zone chosen in the Connect dialog [S4][S5].
- Each open connection is a 0x118-byte record tagged GMMG, with a kind byte at +0x10a: 1 TCP, 2 ADSP (OPENPASSIVESPECIAL, PLACECALL) [S4].
SENDPORTSTRING (CODE 1 0x267c) sends a Pascal string: one length byte, then a prefix character, then the text. The prefix is ~ (0x7e) for GameMaster's own messages and # (0x23) for rulebook messages. GETPORTSTRING (CODE 1 0x2748) reads the length byte and then that many bytes, sets a flag when the first is ~, and passes on the rest [S4]. A rulebook message is therefore
len '#' text... len = 1 + length(text); text at most 250 characters [S1] ?5.7
and arrives at the other side's rulebook as ge_MessageReceived with the same text [S1] ?5.4. Rulebook texts may contain any byte values (they are Pascal strings, not lines).
Control texts (~ prefix), all from the code [S4]:
| Text | Sent by | Meaning |
| Send Game Across Port : | callee | rulebook found and loaded; followed at once by a 10-byte address (below) |
| Send Code Please / Dont Send Code | callee | callee lacks the rulebook (or has an older one) and the user accepted / refused to learn it |
| Go away, I'm old | callee | the caller needs a newer GameMaster than the callee's |
| Not Enough Mem | callee | no memory for the game; connection closed |
| Just a moment, I'll see | callee | the game has arrived; the callee's user is being asked "Anyone for <game>?" (Play / No) |
| Play it Sam / sorry, not interested | callee | the user's answer |
| Request to swap / Swap / Dont Swap | either | swap sides, and the answers |
| Request to restart / Restart / Dont Restart | either | restart, and the answers |
| Beep Beep Beep Beep Beep | either | disconnect (sent before closing) |
- Call record. The caller connects to port 918 and, once connected, asks its rulebook to flatten the game (ge_Flatten) and sends one 786-byte (0x312) record (DOWINDOW, CODE 3 0x33a4-0x3478):
| Offset | Size | Field |
| 0x000 | 4 | size of the game state that will follow (GetHandleSize of the game handle) |
| 0x004 | 64 | Str63 copied from a GameMaster global that no code in 1.0.0 writes, so empty in practice; the callee drops the call unless it equals its own copy (DODAEMON, CODE 3 0x2622). Purpose UNVERIFIED |
| 0x044 | 2 | caller's GameMaster version (0x0100) |
| 0x046 | 2 | required GameMaster version (from the rulebook's GMRZ); the callee answers Go away, I'm old if it is higher than its own |
| 0x048 | 2 | rulebook version |
| 0x04a | 2 | oldest compatible rulebook version |
| 0x04c | 64 | rulebook ID string (Str63), e.g. Dots&Boxes [PNL] |
| 0x08c | 64 | a second Str63 from the rulebook record, probably the rulebook's name (UNVERIFIED) |
| 0x0cc | 256 | the caller's own address as text (GETMYADDRESS) |
| 0x1cc | 326 | the caller's connection record (kind byte, then address data; contents beyond the kind UNVERIFIED) |
The callee (DODAEMON state 1, CODE 3 0x25f4) reads exactly 786 bytes, checks the two fields above, then looks the rulebook up by ID string and version.
- Answer. If the callee has a compatible rulebook it loads it, opens a second, passive TCP connection on a free local port (NEWPASSPORT and OPENPASSIVESPECIAL, CODE 3 0x221c, CODE 2 0x3a2e) and sends ~Send Game Across Port : followed by a raw 10-byte address on the first connection:
byte 0 1 = TCP (2 = ADSP)
byte 1 0
bytes 2-5 the callee's IPv4 address (as MacTCP reports it)
bytes 6-9 the local port, as a 32-bit big-endian number
Otherwise it offers to learn the rulebook (~Send Code Please, after which the caller sends a 68-byte header and the rulebook file in 8000-byte pieces, CODE 3 0x2c92-0x2dc6) or refuses (~Dont Send Code).
- Game upload. The caller reads the 10 bytes, closes the port-918 connection, connects to the given address and port, sends the flattened game state there in 8000-byte pieces with no further header, and from then on uses that connection for the game ($bc of the game record is set to it, CODE 3 0x3370). It sends ge_ConnectionMade to its own rulebook at once.
- Callee start. The callee receives exactly the announced number of bytes on the second connection, makes the game window, sends its rulebook ge_OldGame with the received state, then ge_Swap (so the two sides play different players), then ge_ConnectionMade [S1] ?6.7 [S4] (CODE 3 0x2920-0x2b1a). It sends ~Just a moment, I'll see, closes the port-918 connection and asks its user; the answer goes out as ~Play it Sam or ~sorry, not interested (HANDLEMYALERT).
- Play. Rulebook messages travel as # strings on the second connection until one side sends ~Beep Beep Beep Beep Beep and closes, or the connection drops (the rulebook gets ge_ConnectionLost).
So the caller always uploads its current game, which may be a saved game in progress, and the callee plays the other side of it.
Crystal Ball is a rulebook that, connected to a "Spirit World" server, lists the people at that server with their name, address and preferred rulebook; the user then connects a game to an address from the list by hand [S8]. A Spirit World was run at redback.cs.uwa.edu.au (a saved connected game, "Redback Spirit World", ships with the rulebook) and Rhys Hollow kept a list of sites in SWsites.txt [S8][S9]. Since Crystal Ball connects through GameMaster, a Spirit World is something that speaks the session layer above as the callee. From the rulebook's code [S4-CB]:
- Crystal Ball sends no messages of its own. Its player name and preferred rulebook travel in its game state, which is uploaded at connect (FLATTEN copies the two text fields into the record; exact offsets UNVERIFIED). The caller's address is in the call record.
- The server sends A + a 192-byte entry to add a player and R + a 192-byte entry to remove one; an entry is three Str63 fields, very probably player, address and rulebook in the order of the list columns (UNVERIFIED order).
No Spirit World server program was found.
All from the rulebook sources [S3] (Pascal, read for facts only), with the record sizes checked against the 68k code [S4].
- Board: 13 boxes across, 11 down (col_max = 13, row_max = 11), so 14 by 12 dots; fixed size.
- A move is 8 characters: M, then 0 for a horizontal line or 1 for a vertical one, then the row and the column as three digits each (SendMove). DoMove rejects any other length or first character.
- Horizontal (M0rrrccc): the line on dot row r (0-11) between dot columns c-1 and c (c 1-13).
- Vertical (M1rrrccc): the line on dot column c (0-13) between dot rows r-1 and r (r 1-11).
- Taking a box gives another move; there is no message for it, both sides apply the rule.
- The game ends when one player has more than half the boxes (72 of 143); after that the window ignores clicks.
- Grey (first_player) moves first. A new game sets the local player to grey, so a caller with a new game plays grey and moves first; the callee is black after the swap.
- Game state (568 bytes, SetHandleSize(..., 0x238) in GAMENEW): a 4-byte pointer (ignore), box counts for none/black/grey (3 x 16-bit), lines[vertical][row 0-11][column 0-13] (2 x 12 x 14 bytes from offset 0x0a; COUNTLINES reads horizontal lines at 0x0a + 14r + c and vertical ones at 0xb2 + 14r + c), board[row 1-11][column 1-13] (rows padded to 14 bytes, from 0x15a), then at 0x1f4 the local player, at 0x1f5 the player to move, at 0x1f6 the connection state and at 0x1f7 the play state, then the score text (Str63). Pieces: 0 none, 1 black, 2 grey. The offsets of 0x1f4 and 0x1f6 are from the code; the others are derived from the declarations (UNVERIFIED until a capture).
- 10 by 10 grids; fleet: carrier 5, battleship 4, submarine 3, destroyer 3, tug 2, straight, not overlapping (touching allowed). Each turn is a salvo of 6 shots (maxshots = 6), not reduced by losses.
- Placing: when the player presses Sail, the rulebook sends the whole fleet as one 15-character string: for carrier, battleship, submarine, destroyer, tug in that order, the column digit, the row digit ('0'-'9') and h or v. Each side therefore learns the other's fleet at the start and computes hits locally.
- Shooting: each click on the opponent's grid sends two characters, column digit and row digit; clicking a marked square again unmarks it and sends the same two characters, so the receiver toggles. When six are marked the player presses Fire and the rulebook sends Fire; both sides then reveal those squares.
- After the reveal the firing side's user presses OK and its rulebook sends Done; the receiving side's user presses OK to start its own salvo. The caller (who keeps mymove) fires first; the callee's ge_Swap clears it.
- Resync exists for restarts. The game ends when a fleet is sunk; saving is disallowed.
- A move is two characters, column digit and row digit ('0'-'7'); passes are not sent (both sides compute them in NextMove). White moves first and a new game makes the local player white, so a caller with a new game plays white.
Connect 4, Chess, TicTacToe, Isolation and Gravity Wars follow the same pattern (strings built by the rulebook). Gravity Wars sends aim, planets, explosion, abort and restart messages (SENDAIM, SENDPLANETS, SENDEXPLOSION, SENDABORT, SENDRESTART) and both machines fly the missile [S7][S4]; it is not ParlorNet's Cannon Fire (planets and gravity instead of a terrain).
Yes, as the callee, for Dots and Boxes, Naval Combat and Reversi. The extension:
- Listens on TCP 918, reads the 786-byte call record, checks the required GameMaster version and the ID string and version against the rulebooks it supports (Dots&Boxes [PNL] 1.0.0, BattleShips [RHS] 0.2.0, Othello [RHS] 0.2.0; Simple Talk and Crystal Ball optionally). For anything else it answers ~Dont Send Code (the Mac shows "Game refused"). It never asks for or accepts rulebook code.
- Answers ~Send Game Across Port : with the parlor's public IPv4 address and a second published port, accepts the caller's second connection there, and reads the announced number of bytes of game state.
- Seats the caller at a ParlorNet table of that game. The caller's identity is only the name in its uploaded state and its address. On a parlor that needs passwords, the account would have to be matched another way (for example a Simple Talk exchange first, or a name-only parlor), to be decided.
- Plays the other side: sends ~Just a moment, I'll see, then ~Play it Sam once a ParlorNet opponent is seated (or ~sorry, not interested). It translates # messages into moves and ParlorNet moves into # messages, answers ~Request to restart and ~Request to swap (or refuses them), and sends ~Beep Beep Beep Beep Beep when the table ends.
Rules to settle in the ParlorNet types:
- Dots and Boxes: the client draws only 13 by 11, while dotsandboxes/1 allows 3 to 9 boxes each way. It also stops at a majority (72 boxes) while dotsandboxes/1 plays every box. The type needs a 13x11 size and an end at a majority for these tables, or the extension ends the table when the client does.
- Naval Combat: the classic fleet matches (5, 4, 3, 3, 2). The client fires a fixed salvo of six shots per turn, while navalcombat/1 has one shot per turn (with a planned per-ship salvo). The type needs a fixed six-shot salvo option. The client also receives the ParlorNet player's whole fleet at the start, because the rulebook computes hits itself. The server still decides every hit, but a modified Mac client could show the opponent's fleet; ParlorNet players at such tables should be told.
- Reversi: standard 8x8; colours are mapped (the rulebook's white moves first).
- A caller with a saved game in progress uploads that position; the extension can accept only fresh games, or set up the table from the state.
Reachability: MacTCP users type the parlor's host name or address; GameMaster resolves it with the ordinary DNR. Port 918 is fixed in the client (a privileged port on the host; the container maps it). Macs on AppleTalk only would need an AppleTalk bridge that registers NBP type GameMaster and forwards ADSP to TCP; that is separate work and not needed for MacTCP users. ParlorNet never needs to call out to a Mac.
Confidence: high on the rulebook layer (source), medium-high on the session layer (68k code read by hand). The cheapest confirmation is two GameMaster copies under an emulator with a logging relay on port 918 and on the second port; both copies of the application have identical resources [S4][S10], so the binary is a known-good copy.
- The purpose of the call record's field at 0x004 and the exact contents of 0x08c and 0x1cc.
- How the ADSP path carries the 10-byte address (kind 2) and whether NBP object names are the owner names.
- Dots&Boxes record offsets other than 0x1f4/0x1f6 and the total size.
- Crystal Ball's record offsets for name and rulebook, and the field order of the 192-byte entries.
- Whether any rulebook other than the thirteen above was published, and whether GameMaster 2 (announced in the Gravity Wars notes as "3 or 4 months off", September 1992) was released [S7].
- [S1] Rhys Hollow and Quinn, "Programming GameMaster Rule Books", version 1.0b3, 2 December 1991 (GM Dev Kit, Programming Manual/Programming GM Rule Books (txt)), https://discmaster.textfiles.com/browse/5566/Ian%20and%20Stuart's%20One%20(Australia).iso/Australasian%20Legends/Community/Rhys%20Hollow/GameMaster/GM%20Dev%20Kit/Programming%20Manual
- [S2] "GameMaster Developers Kit" distribution note (Dev Kit Distribution, 8 Dec 1991), same folder's parent.
- [S3] Rulebook sources in the Dev Kit, Rulebook Sources/: Dots&Boxes.p (Peter Lewis, Oct 1991), BattleShips.p and BattleShipsTypes.unit, Othello.p, OthelloPlay.unit, OthelloTypes.unit (Rhys Hollow, 1991), https://discmaster.textfiles.com/browse/5566/Ian%20and%20Stuart's%20One%20(Australia).iso/Australasian%20Legends/Community/Rhys%20Hollow/GameMaster/GM%20Dev%20Kit/Rulebook%20Sources
- [S4] GameMaster 1.0.0 application (vers "1.0.0 ?1991 Rhys Hollow") and the User Kit rulebooks, read statically: resources, MacsBug names, 68k disassembly of CODE 1-3 and of each PROC 128 and GMRZ 128, https://discmaster.textfiles.com/browse/5566/Ian%20and%20Stuart's%20One%20(Australia).iso/Australasian%20Legends/Community/Rhys%20Hollow/GameMaster/GM%20User%20Kit . [S4-CB] the same for the Crystal Ball rulebook.
- [S5] Rhys Hollow, "GameMaster User Manual" (5 Dec 1991) and Rulebooks.doc (9 Dec 1991), same User Kit folder; also https://discmaster.textfiles.com/browse/27148/BBS%20in%20a%20box%20-%20Trilogy%20II.iso/Files/Game/F-G/GameMaster
- [S6] Isolation: Isolation Rules (24 Feb 1992) and IsolationSrc, https://discmaster.textfiles.com/browse/5566/Ian%20and%20Stuart's%20One%20(Australia).iso/Australasian%20Legends/Community/Rhys%20Hollow/Isolation ; Info-Mac abstract (13 May 1992), https://sunsite2.icm.edu.pl/packages/info-mac/game/brd/00brd-abstracts.txt
- [S7] Gravity Wars rulebook and GravityWars Documentation (9 Aug, 24 Aug and 21 Sep 1992), https://discmaster.textfiles.com/browse/5566/Ian%20and%20Stuart's%20One%20(Australia).iso/Australasian%20Legends/Community/Rhys%20Hollow/GravityWars
- [S8] Crystal Ball rulebook, Crystal Ball Documentation (16 Dec 1993) and the saved game Redback Spirit World, https://discmaster.textfiles.com/browse/5566/Ian%20and%20Stuart's%20One%20(Australia).iso/Australasian%20Legends/Community/Rhys%20Hollow/CrystalBall
- [S9] Summary.txt of the Rhys Hollow folder (15 Dec 1993), https://discmaster.textfiles.com/view/5566/Ian%20and%20Stuart's%20One%20(Australia).iso/Australasian%20Legends/Community/Rhys%20Hollow/Summary.txt
- [S10] Second copy of the Dev Kit, Disc to the Future Part II (Wayzata, 1992), https://discmaster.textfiles.com/browse/508/Disc%20to%20the%20Future%20Part%20II%20Programmer's%20Reference%20(Wayzata%20Technology)(6013)(1992).bin/mac/Mac/Pascal/LSP/Pre4.0/GMDevKit%20Folder
- [S12] UMich Mac archive game/board listing (2014 snapshot on discmaster), https://discmaster.textfiles.com/browse/11869/www.umich.edu.archive.2014.03.zip/www.umich.edu/~archive/mac/game/board
- [S13] Macintosh Repository, "GameMaster", https://www.macintoshrepository.org/9523-gamemaster
- [S14] docs/research/clients-dotsandboxes.md and clients-navalcombat.md (this repository): port 918 and the Connect dialog.
- [S15] discmaster search for "gamemaster" (CD copies 1992-98), https://discmaster.textfiles.com/search?q=gamemaster
This doc on GitHub
| | These pages cover every ParlorNet server. | Source code | ParlorNet is free software. |