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

GEnie RSCARDS front end: host-to-client protocol (Backgammon and the other RSCARDS games)

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.

Key findings in brief

  1. RSCARDS is a remote graphics terminal, not a game client. All game logic, screen layout and text live on the GEnie host. The front end knows 27 commands (A-Z and 1): fill a rectangle, draw a line, draw a disc, draw a die face, draw a card or chess-piece bitmap, write text, define click areas, open an input field, play stored macros, and a few animations and sounds [S1][S5]. The only Backgammon-specific pieces in the client are the die-face command (X) and the disc (E) used for checkers [S1].
  2. Transport is a serial line: a modem or direct RS-232 connection, 300-2400 baud. The Mac front end opens the Serial Driver on the modem or printer port (.AIn/.AOut or .BIn/.BOut), defaults to 1200 baud 8N1 with local echo on, and has a built-in dumb terminal with a dial-string option. There is no TCP, MacTCP or AppleTalk code [S1][S3].
  3. Packets are 7-bit printable text with a checksum and stop-and-wait acknowledgement. A packet is one command letter, fixed-width arguments in a base-64 encoding (0x20 + 6 bits per byte), and a 12-bit additive checksum in two characters. The client answers ACK (06 0D) or NAK (15 0D). A repeat of the last good packet is acknowledged but not executed [S1], cross-checked in the IBM build [S5].
  4. Start-up handshake. In terminal mode the host sends ENQ ENQ ENQ 1. The client answers FLC <n> 9, and the host echoes the line LAUNCH 1 <n>. The client then switches to graphics mode and sends RSCARDS'v05.000 (colour Mac) every 500 ticks until the host sends the reset packet ZZ.. [S1].
  5. Feasibility: good. The wire protocol of the Mac v5.0 front end is fully determined from the code. What is lost is the GEnie host program, so every screen (the board, buttons, menus, text) must be designed anew with the 27 primitives. A ParlorNet "RSCARDS adapter" behind a modem or serial bridge could drive the existing front ends, with the rules from backgammon/1 (section i).

(a) Sources

TagItemWheresha256
[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%294dd161110a2e60c51225b60b60e1048fd3ed46c18ca15855d95f28e1d4bf8837
[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%29ebb96f73027b0792bfc68a0a02f1f640d6c713c0cd49d8532567a449a6083ec7
[S3]Mac Read Me (1992-12-24): built-in terminal, menu keyssame folder, Read Me6c279ace4f09745415dc7271d074319f495080d2e7cbeb9e131c5f60f0bf8de9
[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.txtfaa114fc7e88542dad4ccbcd7653aa9ac83ead649bc43040ad62ff8e04c93a61
[S5]RSCARDS.EXE for IBM PC (EXEPACK, DOS, VGA/MCGA/EGA/CGA), v5.02, 1994-10-26https://discmaster.textfiles.com/file/18228/internet.zip/internet/INTERNET/ONLINE/GENIE/MISC/RSCARDS.EXEfe6d4c7ede0af3e11dfc27f4817aace66e19463a96825ecc0244e2c2d550cc8c
[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 libraryhttps://discmaster.textfiles.com/file/17620/archives.tar/archives/genie-commodore-file-library/Wizard/RSCV50%28C%29.SFX and .../RSCARDS-V21M.SFX0cbd2250...e06e3d1, 74eec3a6...9b7965
[S7]Amiga RSCards.doc (PowerPacker), Amiga v4.0 notes plus the General Instructions of 1 October 1991 and a version tablehttps://discmaster.textfiles.com/file/1310/Network%20CD%20-%20Volume%202.iso/legaltools/lsdlt043.dms/lsdlt043.adf/docs/RSCards.doc.pp8358a959afd4cc0e1ddb3a767d0dd5347aebbba1cc51dffb72a8bff34fe970ec
[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.txtf351e64620474bec0a927ac782f29abe14a27ebed6b44e4e1e248a2862017249
[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.

(b) Product and history

(c) Connection details

ItemValueSource
Physical linkserial 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 dialog1200 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 controlnone 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 buffer2048 bytes (SerSetBuf)[S1] rsinit
Configuration file50 bytes: baud, word length, parity, echo flag, port, dial string. "Save configuration" writes it[S1] readConfiguration/writeConfiguration
Built-in terminal80-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 platformsC128: "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].

(d) Entering and leaving graphics mode

Auto-shift handshake (terminal mode to graphics mode)

The built-in terminal watches incoming characters [S1, CODE 2 to_screen @0448]:

  1. The host sends three ENQ bytes (0x05) followed by the character 1. The counter is exact: three 0x05, then 1. Any other byte resets it.
  2. The client then discards input until 5 seconds pass with no byte. It reads the line with the packet reader's 300-tick per-byte timeout.
  3. It sends FLC <n> 9 plus CR, where <n> is a random number from 0 to 32767 (Random() & 0x7FFF), in decimal.
  4. It expects, within 900 ticks (15 s), a terminal line that is exactly LAUNCH 1 <n> with the same <n>. While it waits, lines that start with L are not displayed. On a match it calls entering_rscards_mode [S1 @05ae].

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.

Identification beacon

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]).

Leaving

(e) Packet format (host to client)

Byte level

ElementEncodingReader in [S1]
commandone byte, A-Z or 1. Any other byte between packets is ignored silently (no NAK), so text, CR and LF may sit between packetsdo_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..4095r_word @2374
large number ("t")three bytes, 6 bits each, high first; v = 0..262143r_three @23f4
rectangle ("rect")four w: x, y, width, heightr_grect @24a4
raw byte ("c")one byte, taken as is (used for click codes and input filters); should be printablerecv @220c
string ("s")bytes 0x20-0x7E, terminated by ~ (0x7E). At most 64 bytes before the ~. ~ cannot occur insider_string @22bc
streamn bytes 0x20-0x7E, n = 1..127 (length taken mod 128; 0 fails)r_stream @2514
checksumone w (two bytes): the sum of the command byte and every following byte up to the checksum, masked with 0xFFFcheck @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].

Acknowledgement and retransmission

(f) Command catalogue

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.

CmdArgumentsEffectSource ([S1] address)
Arect, b colourfill rect with colour (+o); zero rect = whole screendo_a 26b0
Brect, c codeadd 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
Cw x, w y, b ndraw 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
Db flag0 = show and enable the entry line (bottom row); non-zero = disable and clear itdo_disable 1b88
Ew x, w y, w rx, w ry, b colourfilled disc (oval) centred at x,y with radii rx, ry (+o). Used for checkers and die pipsdo_e 27f0
Frect, w on, w offflashing 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 alldo_f 29b4, rev_grect 1346
Grect from, rect to"grow box" animationdo_g 2b74
Hrect, c codeclick 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 itdo_h 2bb6
Iw x, w y, b maxlen, c filter, s textopen 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 CRdo_input 19ba, hndl_keyboard 44fc
Jrectsave this screen region (one at a time)do_j 2d54
Kc Krestore the saved region3554
Lb first, b rows, b colourmessage (scroll) area in text rows. L 0 = none. First = 25 clears the area with its colourset_scroll 1c18
Mb mode8 = mouse pointer and clicks on; 9 = offdo_m 2d86
Nb style, w x, w y, b digits, b colour, b thickness, t valueseven-segment number (styles 1, 5, 9, 13, 16, 21 have built-in sizes)do_7seg 1c9e
Orect, b outer, b innerpanel: 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 screendo_o 2db6
Pb slotplay macro slot (0..63) if defined; otherwise nothing36ec
Qc Qleave graphics mode372a
Rrectinvert rect; x = thickness*1000 + x (+o); zero rect = whole screendo_r 2e56
Srect, rect"shrink box" animationdo_s 2eca
Tb font, w x, w y, w width, s texttext (+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
Ub slot, w n, streamdefine macro slot (0..63, 127 bytes max) as n bytes of command text without checksums384a
Vsix wmoving-box animation (only if the user has box effects on); argument meaning UNVERIFIEDgraf_mbox d44
Ww x1, w y1, w x2, w y2, b colourline (+o)do_w 2f0c
Xw x, w y, b colour, b valuedie 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 drawndo_x 2f5a
Yb slot, w dx, w dyplay macro slot with origin offset dx, dy3a0e
Zc Zreset: clear hotspots and flashers, clear the screen, mouse off, stop the identification beacondo_z 3090
1t tone, w durationqueue a tone (if sound is on); units UNVERIFIEDadd_sound 5e4

Notes:

(g) Client-to-host traffic

SentWhenSource
FLC <n> 9 CRafter ENQ ENQ ENQ 1 in terminal mode(d)
RSCARDS<m>v05.000 CRevery 500 ticks after entering graphics mode, until Z(d)
06 0D / 15 0DACK / NAK for every packet(e)
ccc CRclick on a B or H area with code c (for example RRR CR)send_triple
four spaces, text, CRRETURN in an I input field (also a mouse click while the field is open). An empty field sends four spaces and CRhndl_keyboard 44fc, A5-$4a9c
four spaces, text, CRRETURN on the entry line (D 0), up to 60 characters typed; chat and / commandshndl_keyboard 4652, A5-$4a96
EXIT CR x3File > Terminal or File > Quit(d)
anything typedin 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].

(h) Backgammon specifics

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.

(i) Sample session (composed from the code, not a capture)

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>.

Added 2026-11-21: Amiga and Atari ST front ends

From 8bit-clients.md (section b, GEnie; tags are that note's):

(j) Unverified items and open questions

  1. Host-side retransmission timing and retry limit; whether GEnie ever sent several packets before waiting for ACK.
  2. Meaning of the 9 in FLC <n> 9, and whether GEnie checked <n> or the version in the beacon (and refused old versions).
  3. Purpose of the four spaces in front of typed lines.
  4. The GEnie screens: layouts, colours, macro contents, click codes, the TTY board format and the Backgammon command set (doubling, resign, match length, scores). None of it is in the client. A new design is needed (section h).
  5. Exact large-font metrics; meaning of the six V arguments; 1 tone units; parameter roles of N beyond style, position, digit count, colour, segment thickness and value.
  6. The duplicate-origin rules for B and F are read from code and look odd (a second area at the same x,y removes the first). A host can avoid them by clearing with a zero rect and redefining.
  7. IBM v5.02 beacon byte (- in the literal) and whether newer host versions required v5.02. C128 v5.0 beacon is RSCARDS*v05.000 [S6]. The Atari ST, Amiga and IIgs binaries were not found, so their beacons are unknown.
  8. Whether the front ends accept 7-bit even/odd parity links equally well. All packet bytes are 7-bit, so this is likely.
  9. The 6502 code of the C128 front end was not disassembled; its protocol is assumed identical from the shared strings, version number and beacon format.

(k) Feasibility verdict

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:

  1. A serial or modem path. The front ends speak only RS-232. Options: a Hayes-style modem emulator that turns the Mac's ATDT dial string into a TCP connection to ParlorNet; or a null-modem serial bridge to a TCP port. The Mac's built-in terminal and dial string make the modem route natural.
  2. An RSCARDS adapter in ParlorNet. Its jobs:
  3. a short terminal-mode front door (text menu, ENQ ENQ ENQ 1 auto-shift, LAUNCH echo, beacon parsing, with machine code and version);
  4. a packet writer with checksum, stop-and-wait ACK/NAK, retransmit and the no-duplicate rule;
  5. a screen renderer that turns backgammon/1 views and events into primitives (board, checkers, dice, cube, messages);
  6. an input mapper that turns click codes and typed lines into MOV/END/roll/double/take/drop and chat.

The rules already live in ParlorNet, so the adapter holds only presentation and selection state.

  1. Screen design. The GEnie layout is lost, so a new layout is needed. The same renderer could also draw the other RSCARDS games where ParlorNet has a matching type: Reversi, Checkers and Chess (the client has chess-piece bitmaps), and cards (52-card bitmaps).
  2. TTY fallback. Plain-text RSCARDS (TTY, TTYB) needs nothing special; our existing telnet text adapter already covers text terminals.

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.

This doc on GitHub


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