| ParlorNet Turn-based game server for any computer, old or new | |
| Clients | Protocols | Browsers | Telnet programs | Docs | Source |
Status: research notes, 2026-11-21. Every fact carries a source tag like [S1] (list in section a). Anything not backed by a source is marked UNVERIFIED. Nothing here comes from memory.
Method: static reverse engineering only. The Macintosh colour and monochrome front ends (v5.0, January 1994) were disassembled with capstone (68k). The binaries carry MacsBug procedure names (do_recv, check, send_ack, r_word, do_x ...), which made the packet parser easy to locate. The MPW initialised-data block was unpacked to recover the A5-relative strings. The IBM front end (v5.02, October 1994) was un-EXEPACKed and spot-checked with x86 disassembly. The Commodore 128 v5.0 files and two text documents were read for strings only. No client was run, no emulator was used, and no server was contacted. GEnie closed long ago; there is nothing to probe.
| Tag | Item | Where | sha256 |
|---|---|---|---|
| [S1] | RSCARDS (color) v5.0 for Macintosh, MacBinary, created 1990-03-08, modified 1994-01-02; vers 5.0, "RSCARDS - v5.1"; 68k, 9 CODE segments with MacsBug names; "Mac code by J. Garonzik & L. Whitsel" | https://discmaster.textfiles.com/file/22152/UltraMacGames1.iso/GEnie/RSCARDS/RSCARDS%20%28color%29%20Folder/RSCARDS%20%28color%29 | 4dd161110a2e60c51225b60b60e1048fd3ed46c18ca15855d95f28e1d4bf8837 |
| [S2] | RSCARDS (mono) v5.0 for Macintosh, same date; identical procedure list and protocol strings to [S1] | https://discmaster.textfiles.com/file/22152/UltraMacGames1.iso/GEnie/RSCARDS/RSCARDS%20%28mono%29%20Folder/RSCARDS%20%28mono%29 | ebb96f73027b0792bfc68a0a02f1f640d6c713c0cd49d8532567a449a6083ec7 |
| [S3] | Mac Read Me (1992-12-24): built-in terminal, menu keys | same folder, Read Me | 6c279ace4f09745415dc7271d074319f495080d2e7cbeb9e131c5f60f0bf8de9 |
| [S4] | "RSCARDS General Instructions", updated 13 January 1994 (TTY and graphics use, machine codes, Waiting Room, commands) | https://discmaster.textfiles.com/file/22152/UltraMacGames1.iso/GEnie/RSCARDS/RSCARDS%20Instructions.txt | faa114fc7e88542dad4ccbcd7653aa9ac83ead649bc43040ad62ff8e04c93a61 |
| [S5] | RSCARDS.EXE for IBM PC (EXEPACK, DOS, VGA/MCGA/EGA/CGA), v5.02, 1994-10-26 | https://discmaster.textfiles.com/file/18228/internet.zip/internet/INTERNET/ONLINE/GENIE/MISC/RSCARDS.EXE | fe6d4c7ede0af3e11dfc27f4817aace66e19463a96825ecc0244e2c2d550cc8c |
| [S6] | Commodore 128 front end v5.0 colour (RSCV50(C).SFX) and v2.1 mono (RSCARDS-V21M.SFX), self-extracting LHA from the GEnie Commodore file library | https://discmaster.textfiles.com/file/17620/archives.tar/archives/genie-commodore-file-library/Wizard/RSCV50%28C%29.SFX and .../RSCARDS-V21M.SFX | 0cbd2250...e06e3d1, 74eec3a6...9b7965 |
| [S7] | Amiga RSCards.doc (PowerPacker), Amiga v4.0 notes plus the General Instructions of 1 October 1991 and a version table | https://discmaster.textfiles.com/file/1310/Network%20CD%20-%20Volume%202.iso/legaltools/lsdlt043.dms/lsdlt043.adf/docs/RSCards.doc.pp | 8358a959afd4cc0e1ddb3a767d0dd5347aebbba1cc51dffb72a8bff34fe970ec |
| [S8] | GEnie LiveWire, June 1995: "RSCARDS Backgammon Tournament" (page 877, keywords BG/BACKGAMMON; front ends for IBM, Mac, IIgs, Amiga, C-128, Atari ST/TT/Falcon) | https://discmaster.textfiles.com/file/22152/UltraMacGames2.iso/GEnie/LiveWire%20June%20%2795/LiveWire%20MM%20June%20%2795/LiveWire%20MM%20June%20%2795/00181_rscards-magic.txt | f351e64620474bec0a927ac782f29abe14a27ebed6b44e4e1e248a2862017249 |
| [S9] | docs/research/backgammon-network.md (Damish FAQ entry naming the RSCARDS Backgammon front ends) | this repo | - |
All files were downloaded on 2026-11-21 into a working folder outside the repository. Code locations below are offsets in CODE segment 1 of [S1] (after the 4-byte segment header) unless stated otherwise.
Not obtained: the Atari ST, Amiga and Apple IIgs front-end programs. Only the Amiga document [S7] was found. [S7] lists GEnie library file numbers for 1991 (Atari ST v4.0 file 149, Amiga v4.0 file 148). None was found on discmaster, Aminet or Atarimania in this pass.
| Item | Value | Source |
|---|---|---|
| Physical link | serial port to a modem (or a direct line); the Mac front end opens .AIn/.AOut (modem port, default) or .BIn/.BOut (printer port) | [S1] strings at A5-$4ec1..$4e53, rsinit |
| Default settings (Mac) | 1200 baud (config word 94), 8 data bits (0xC00), no parity, 1 stop bit (+0x4000), local echo on, modem port | [S1] Initialize (CODE 2) |
| Choices in the dialog | 1200 or 2400 baud; 7 or 8 bits; none, even or odd parity; local echo yes/no; modem or printer port; a dial string | [S1] DITL 129 |
| Flow control | none enabled. The handshake record sets XON 0x11 and XOFF 0x13 but leaves both the XON/XOFF and CTS flags off | [S1] rsinit @20b4 |
| Serial input buffer | 2048 bytes (SerSetBuf) | [S1] rsinit |
| Configuration file | 50 bytes: baud, word length, parity, echo flag, port, dial string. "Save configuration" writes it | [S1] readConfiguration/writeConfiguration |
| Built-in terminal | 80-column dumb terminal; CR, TAB, BS, FF (clear) handled; LF ignored; 8th bit stripped; Cmd-D sends the dial string plus CR | [S1] CODE 2 to_screen, incoming; [S3] |
| Other platforms | C128: "8N1, 300-2400 BAUD", built-in terminal, choice of 1200 or 2400 baud at load [S6]. IBM: RSCARDS [COM# [IRQ#]], COM1-4, IRQ 2-7, run from inside the user's terminal program [S5]. Amiga: settings from Preferences, serial.device [S7] | |
| GEnie account setup (text shown by the client) | 300-2400 baud, half duplex; dial 1-800-638-8369; HHH; at U#= type XJM11795,RSCARDS (Mac) or JOINGENIE (IBM); then M875 | [S1][S5] |
TCP/IP, MacTCP, Open Transport and AppleTalk: none. The only I/O is the Serial Driver [S1].
The built-in terminal watches incoming characters [S1, CODE 2 to_screen @0448]:
The meaning of the trailing 9 in FLC is UNVERIFIED. It is the same in the colour and mono builds, so it is not the machine code.
The user can also enter graphics mode by hand: File > RSCARDS (Cmd-R). This is the "Please run your RSCARDS program now" path [S3][S4]. In that case no FLC line is sent.
On entering graphics mode the client clears the screen, turns the mouse off and disables the entry line. It then repeatedly sends [S1 hndl_tick @0482a, strings at A5-$3db8, -$3dc2]:
RSCARDS<m>v05.000<CR>
<m> is one byte, 0x20 + machine code: ' (0x27, code 07) when the display test in screenselect selects colour drawing, ( (0x28, code 08) otherwise [S1 screenselect @04a0a]. The colour and mono builds share this code; which byte the mono build sends on a colour Mac is UNVERIFIED. The first beacon goes 300 ticks (5 s) after entry, then every 500 ticks (about 8.3 s). The beacon stops when the host sends the reset packet Z (do_z clears the timer). Cross-checks: the C128 v5.0 binary contains RSCARDS*v05.000 (* = 0x2A = code 10, C128 colour) [S6]. The IBM v5.02 binary contains the literal RSCARDS-v05.020 (- = code 13). Code 13 is not in the 1994 list, and whether the IBM build patches that byte at run time is UNVERIFIED [S5].
The host learns the machine type and version from this line (the logon screen shows "the computer identification received from your local RSCARDS graphics program" [S4]).
| Element | Encoding | Reader in [S1] |
|---|---|---|
| command | one byte, A-Z or 1. Any other byte between packets is ignored silently (no NAK), so text, CR and LF may sit between packets | do_recv @317a |
| small number ("b") | one byte 0x20 + v, v = 0..63 (bytes 0x20-0x5F only) | r_bword @2322 |
| number ("w") | two bytes, high 6 bits first: 0x20 + (v >> 6), 0x20 + (v & 63); v = 0..4095 | r_word @2374 |
| large number ("t") | three bytes, 6 bits each, high first; v = 0..262143 | r_three @23f4 |
| rectangle ("rect") | four w: x, y, width, height | r_grect @24a4 |
| raw byte ("c") | one byte, taken as is (used for click codes and input filters); should be printable | recv @220c |
| string ("s") | bytes 0x20-0x7E, terminated by ~ (0x7E). At most 64 bytes before the ~. ~ cannot occur inside | r_string @22bc |
| stream | n bytes 0x20-0x7E, n = 1..127 (length taken mod 128; 0 fails) | r_stream @2514 |
| checksum | one w (two bytes): the sum of the command byte and every following byte up to the checksum, masked with 0xFFF | check @2640 |
CR and LF anywhere inside a packet are skipped: they are not stored and not added to the checksum. The client counts them in its statistics [S1 recv]. Each byte must arrive within 300 ticks (5 s) of the previous one, or the packet fails [S1 recv].
Coordinates are in a fixed virtual screen of 640 x 200 that the front end scales to the real window. This is the Atari ST medium resolution and IBM CGA geometry [S1 Initialize: the screen rect is 0,0,640,200; calc_scale]. The normal font is an 8 x 8 cell, so 80 columns by 25 rows. A larger font is also available. Its cell is derived from the normal one; exact size UNVERIFIED [S1 CODE 2].
Colours (index, from the colour table at A5-$3da4) [S1]: 0 black, 1 white, 2 red, 3 green, 4 blue, 5 yellow, 6 magenta, 7 cyan. In the mono build and on black-and-white screens, 0 is black and any other value is white [S1 _setcolor]. This matches the documented message colours: black for players, red for the system, blue for tables, purple for locations, yellow for tournaments, white for local messages [S4].
Arguments are listed in wire order. +o means the stored origin offset is added (non-zero only while a macro runs under Y). "zero rect" means x = y = w = h = 0.
| Cmd | Arguments | Effect | Source ([S1] address) |
|---|---|---|---|
| A | rect, b colour | fill rect with colour (+o); zero rect = whole screen | do_a 26b0 |
| B | rect, c code | add a click area. A click (mouse on) sends ccc CR. Zero rect clears all. A second B with the same x,y and non-zero size removes the existing one (as coded) | do_b 270e |
| C | w x, w y, b n | draw bitmap n at x,y (+o): n = 0..53 card PICTs 200..253 (back, 52 cards, background). If x >= 1000, x -= 1000 and n += 54, selecting the chess set (PICTs 400..425) | do_card 1a70 |
| D | b flag | 0 = show and enable the entry line (bottom row); non-zero = disable and clear it | do_disable 1b88 |
| E | w x, w y, w rx, w ry, b colour | filled disc (oval) centred at x,y with radii rx, ry (+o). Used for checkers and die pips | do_e 27f0 |
| F | rect, w on, w off | flashing area: the rect is inverted on/off with the given tick counts. x = thickness*1000 + x (thickness 0 = invert whole rect, n = n-pixel frame). Zero rect stops all | do_f 29b4, rev_grect 1346 |
| G | rect from, rect to | "grow box" animation | do_g 2b74 |
| H | rect, c code | click area with hover highlight (inverted while the pointer is inside). x = thickness*1000 + x as for F. Click sends ccc CR. Zero rect clears all. A second H at the same x,y with size 0 removes it | do_h 2bb6 |
| I | w x, w y, b maxlen, c filter, s text | open an input field at x,y. text = colour digit, background digit, default value. filter X = any printable, 9 = digits only. RETURN (or any mouse click) sends four spaces, the text and CR | do_input 19ba, hndl_keyboard 44fc |
| J | rect | save this screen region (one at a time) | do_j 2d54 |
| K | c K | restore the saved region | 3554 |
| L | b first, b rows, b colour | message (scroll) area in text rows. L 0 = none. First = 25 clears the area with its colour | set_scroll 1c18 |
| M | b mode | 8 = mouse pointer and clicks on; 9 = off | do_m 2d86 |
| N | b style, w x, w y, b digits, b colour, b thickness, t value | seven-segment number (styles 1, 5, 9, 13, 16, 21 have built-in sizes) | do_7seg 1c9e |
| O | rect, b outer, b inner | panel: fill rect with outer colour, then an inset rect (one character width at the sides, half a row at top and bottom) with inner colour (+o); zero rect = whole screen | do_o 2db6 |
| P | b slot | play macro slot (0..63) if defined; otherwise nothing | 36ec |
| Q | c Q | leave graphics mode | 372a |
| R | rect | invert rect; x = thickness*1000 + x (+o); zero rect = whole screen | do_r 2e56 |
| S | rect, rect | "shrink box" animation | do_s 2eca |
| T | b font, w x, w y, w width, s text | text (+o). text = colour digit, background digit, then the string. Fonts: 24 left, 25 centred in width, 26 right-aligned; 27-29 the same in the large font. width 0 = string width. y = 200 writes on the last line of the message area; y = 201 scrolls the area first (append a message line) | do_text 16a8 |
| U | b slot, w n, stream | define macro slot (0..63, 127 bytes max) as n bytes of command text without checksums | 384a |
| V | six w | moving-box animation (only if the user has box effects on); argument meaning UNVERIFIED | graf_mbox d44 |
| W | w x1, w y1, w x2, w y2, b colour | line (+o) | do_w 2f0c |
| X | w x, w y, b colour, b value | die face: a 48 x 24 box at x,y (+o) filled with colour, with value pips in a 3 x 3 grid (pip radius 6 x 3). Pips are black on a non-black die, white on a black die. Values 1-6 are normal faces; 7-9 are drawn | do_x 2f5a |
| Y | b slot, w dx, w dy | play macro slot with origin offset dx, dy | 3a0e |
| Z | c Z | reset: clear hotspots and flashers, clear the screen, mouse off, stop the identification beacon | do_z 3090 |
| 1 | t tone, w duration | queue a tone (if sound is on); units UNVERIFIED | add_sound 5e4 |
Notes:
| Sent | When | Source |
|---|---|---|
| FLC <n> 9 CR | after ENQ ENQ ENQ 1 in terminal mode | (d) |
| RSCARDS<m>v05.000 CR | every 500 ticks after entering graphics mode, until Z | (d) |
| 06 0D / 15 0D | ACK / NAK for every packet | (e) |
| ccc CR | click on a B or H area with code c (for example RRR CR) | send_triple |
| four spaces, text, CR | RETURN in an I input field (also a mouse click while the field is open). An empty field sends four spaces and CR | hndl_keyboard 44fc, A5-$4a9c |
| four spaces, text, CR | RETURN on the entry line (D 0), up to 60 characters typed; chat and / commands | hndl_keyboard 4652, A5-$4a96 |
| EXIT CR x3 | File > Terminal or File > Quit | (d) |
| anything typed | in terminal mode (keys go straight to the line, with local echo if set) | CODE 2 outgoing |
The four leading spaces are literal in the initialised data (20 20 20 20). Their purpose is UNVERIFIED; a host should strip leading spaces. In TTY mode the same commands are typed as plain lines, for example a table letter, S, X, Q, -, or /L, /W06, /S06 [S4].
What the client provides: X draws a die showing any value from 1 to 9. E draws a coloured disc, which serves as a checker. Click areas return one code byte. Everything else (board, points, bar, cube, score, move entry, buttons) is drawn by the host from primitives. No board layout, colour scheme or code assignment from the GEnie Backgammon host survives in the client, so the original screen design is UNVERIFIED and must be recreated.
TTY-mode clues from [S4]: TTY and TTYB modes redraw the board after each move or announce moves in text, for example "JWJr (Superv'r) moves from X to R". Points appear to be identified by letters, which suggests the graphics mode also used letter codes for points (UNVERIFIED). Tables are letters chosen in a Room; a Gallery lets others watch; scores are kept per player [S4].
A design that fits the primitives:
Bandwidth: at 1200 baud (about 120 bytes/s), a board of roughly 70 packets of 10-20 bytes takes about 10 s plus ACK turnarounds. A move (erase and redraw two or three checkers, two dice) is about 6 packets, under 1 s.
Host lines are marked H:, client lines C:. <cs> checksums below were computed with the rule in (e); the packets are complete and byte-exact for the design above.
(terminal mode, after modem connect and whatever login the server presents)
H: Please run your RSCARDS program now.<CR><LF>
H: <05><05><05>1 auto-shift trigger
(host stays silent for at least 5 s)
C: FLC 21877 9<CR>
H: LAUNCH 1 21877<CR><LF> client enters graphics mode
C: RSCARDS'v05.000<CR> colour Mac, code 07 (repeats every ~8 s)
H: ZZ"T Z reset (cs "T)
C: <06><0D>
H: L4$ #$ L 20,4,0: message area rows 20-23 on black
C: <06><0D>
H: A * "@#&0 A 0,0,640,160 colour 3 (green field)
C: <06><0D>
H: O @ () "0%#': O 32,8,576,144 outer 5 inner 3
C: <06><0D>
H: U! HW 4 \"W H 4 \"W * 4 \"W > 4 \"A2
U slot 1, 40 bytes: four W lines
C: <06><0D>
H: Y!!0 0$; Y slot 1 at offset 80,16 (one point)
C: <06><0D>
H: E!D 8 0 &!&Y E checker at 100,24 r 16x6 white
C: <06><0D>
H: X&X!(!%%E X die at 440,72 white, value 5
C: <06><0D>
H: X'P!(!#%< X die at 496,72 white, value 3
C: <06><0D>
H: H@@ 0 H! M(. H point area 80,16,40,64, frame 2 px, code M
C: <06><0D>
H: B(P"J! *R(# B Roll button 560,170,64,10 code R
C: <06><0D>
H: T9(P"J! 70Roll~0P T font 25 centred label "Roll" cyan on black
C: <06><0D>
H: T8 #) 01 Al: hi there~9G T font 24 at y=201: append a chat line
C: <06><0D>
H: M(!U M 8: mouse on
C: <06><0D>
H: D !D D 0: entry line on
C: <06><0D>
(user clicks the Roll button, then the point area)
C: RRR<CR>
C: MMM<CR>
(user types on the entry line)
C: good luck<CR>
...
H: QQ"B leave graphics mode
C: <06><0D> client is back in terminal mode
A handle prompt, as on the GEnie logon screen [S4], would be I"@!@,X70guest~2=: an input field at 160,96, 12 characters, any printable, cyan on black, default guest. The user's answer arrives as guest<CR>.
From 8bit-clients.md (section b, GEnie; tags are that note's):
A compatible service is feasible, with moderate work, and the protocol risk is low. The Mac v5.0 packet layer (framing, encoding, checksum, ACK/NAK, duplicate rule, handshake, beacon, all 27 commands and all replies) is determined from the code and cross-checked against the IBM v5.02 build.
What it would take:
The rules already live in ParlorNet, so the adapter holds only presentation and selection state.
Not needed: any GEnie account system emulation beyond a handle prompt (the client has no login logic of its own); ratings; the original GEnie menus.
| These pages cover every ParlorNet server. | Source code | ParlorNet is free software. |