| 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 [S2] (list in section a). Anything not backed by a source is marked UNVERIFIED. Method: static analysis only. I read the distribution's text files and scripts, decompressed the WinHelp file, and disassembled the Win16 executable with capstone. The client was not run, and no server was contacted.
| Item | Value | Source |
|---|---|---|
| Transports | Winsock 1.1 TCP (WINSOCK.DLL loaded by name; uses gethostbyname, connect, WSAAsyncSelect and others) or a serial COM port with a Hayes modem | [S2] strings 4:b108-b1fa; [S1] README |
| Default host | fraggel65.mdstud.chalmers.se (INI [Settings] FibsInternetAddress). On start-up, a stored old address 129.16.235.153 is rewritten to the host name (3:0ed6). The help file spells it fraggl65 | [S2] 3:16aa, 3:0ec1-0ef8; [S3] |
| Default port | 4321 (INI FibsTelnetPort), editable in Options/Advanced Options | [S2] 3:16d8; [S3] |
| Status text | Connecting(%s,%d)..., Online(%s,%d); a stale string-table entry reads Connecting(129.16.235.153,4321)... | [S2] 4:b740, string 32773 |
| Line end, client to server | Scripts and the command line end commands with CR. On the Winsock path each CR is sent as CR LF, and a 0xFF data byte is doubled (FF FF, telnet IAC escaping) | [S2] 4:a594-a5b8, 4:a608-a627 |
| Line end, server to client | Lines are cut at LF; CR is dropped. Script wait patterns match the raw stream character by character, so prompts with no newline (login: ) work | [S2] 3:46e0-4789, 3:84dc |
| Telnet options | The receive path scans for 0xFF and treats it specially. Full IAC handling is UNVERIFIED in detail. The server should send at most the IAC WILL/WONT ECHO pairs that FIBS uses around passwords [S4] | [S2] 4:a321 |
| Leading prompt on a line | Before parsing, the client skips leading > and space characters, so > board:... parses as board:... | [S2] 3:4883-4892 |
| Modem defaults | init ATE1V1Q0S0=0&D2, dial prefix ATDT, ATZ first; waits for CONNECT / BUSY / NO CARRIER | [S2] 3:1624; [S1] DIAL.SCR; [S3] |
Note for ParlorNet: on the Winsock route a user only has to set the address and port in the Advanced Options dialog. On the dial-up route, the shell host's own telnet program carries the session, so ParlorNet's telnet adapter or a modem bridge in front of a shell would serve it.
Script language (interpreted by FIBS/W, not sent to the server): @send, @wait "text" [timeout], @branch "status" "pat1" Label1 "pat2" Label2 ..., @echo, @if/@else/@endif, @goto, @passwordEntry 0|1, @board 0|1, <file (include), %Variable% expansion. Variables: %FibsLoginName%, %FibsPassword%, %FibsInternetAddress%, %FibsTelnetPort%, %TimeZone%, %HostLoginName%, %HostPassword%, %TelephoneNumber%, %DialStringPrefix%, %ModemInitString%, %NetworkScript%, %HostName% [S1][S2 4:2d34-2d8e].
wait "login: " (no timeout)
send "<FibsLoginName>\r" (if configured; otherwise the user types it)
branch "password: " -> Password
"login: " -> Login (login refused: try again)
"\n>" -> DoGuestLogin (a prompt with no password prompt = guest)
Password:
send "<FibsPassword>\r" (if configured)
branch "login: " -> Login
"authenticated." -> DoAuthenticated
"\n>" -> DoNormalLogin
DoGuestLogin:
wait "\nYou are registered." (after the user finishes FIBS's guest registration by hand)
DoAuthenticated:
wait "\n>"
DoNormalLogin (INITFIBS.SCR):
send "set boardstyle 3\r"
wait "Value of" (50 s)
wait "\n>"
[send "set timezone <TimeZone>\r"; wait "Value of" (50 s); wait "\n>"] only if TimeZone is set
echo "*** CONNECTED ***"; board 1 (show the board window)
The dial-up FIBSLOGN.SCR is the same, with wait "\n" after the name and the password, and passwordEntry to mask local echo [S1].
What the server must therefore produce:
| Step | Exact bytes the scripts match | Notes |
|---|---|---|
| Login prompt | login: (lower case, trailing space) | after any banner |
| Password prompt | password: (lower case, trailing space) | This is also evidence for the FIBS normal password prompt, an open item in [S4] g1 |
| Logged in | a line break followed by >, i.e. the telnet-mode prompt > at the start of a line | **The > prompt must be on (FIBS toggle telnet YES, the FIBS default).** Without it the scripts wait for ever |
| Alternative success marker | authenticated. anywhere in the stream | Which FIBS message contains this word is UNVERIFIED. The adapter does not need it, because \n> also matches |
| Failed login | login: again | same as FIBS [S4] |
| Guest | a prompt after guest with no password: in between; later You are registered. at the start of a line once the new name and password are set | The exact FIBS registration dialogue is in [S4]. Only You are registered. is matched |
| set replies | text containing Value of, then \n> | FIBS: Value of 'boardstyle' set to 3. [S3] |
EXAMPLE.SCR (a sample for a csh shell host) also sends toggle automove and waits for ** [S1]. So toggle replies should start with ** , as FIBS's do [S4].
MANUAL.SCC (dial; the user types the telnet command) resumes when it sees the FIBS ASCII-art banner fragment irst |_|nternet |______/ackgammon |_____/erver [S1]. Only that script needs it. Since [S4] h recommends our own banner wording, users of this one script would have to switch to a host script (UNIXB.SCC and the others), which wait for login: instead. Flagged, not required.
From the GUI, menus and scripts. All are plain telnet-mode lines ending CR (CR LF on Winsock) [S2][S3].
| Command | When | Source |
|---|---|---|
| <name>, <password> | login | [S1] |
| set boardstyle 3, set timezone <tz> | after login | [S1] INITFIBS.SCR |
| roll | click on the cube bar when it is the user's turn to roll | [S2] 3:2f92; [S3] |
| double | click on the cube (with a "Would you like to double?" confirmation unless ConfirmDoubles is off) | [S2] 3:38da, 3:bc1f; [S3] |
| accept | click on the cube when doubled, or menu Accept Double | [S2] 3:3932; [S3] |
| reject | menu Decline Double (no mouse equivalent) | [S2] 3:39aa; [S3] |
| <from> <to> [<from> <to> ...] | click on the cube bar to "pick up the dice" after moving checkers. Points are numbers, bar or off, separated by single spaces, with **no move keyword** | [S2] 3:32d5-33da (strings bar, off, %d, ); [S3] ("8 5 5 1" or "8 1") |
| toggle double, toggle ready, toggle greedy | menu toggles | [S2] 4:3026, 4:3090, 3:8904 |
| who, who ready | menu Who / Who Ready | [S2] 4:309e, 4:3038 |
| pip | menu Pipcount (registered copies only; otherwise a local message) | [S2] 4:3034, 4:3042; [S3] |
| away <message>, back | menu Toggle Away | [S2] 4:30a8, 4:30a2 |
| tell Q FIBS/W Usage Tracking :: Unlicensed, tell Q FIBS/W Usage Tracking :: Licensed to <name>, tell Q FIBS/W License Tracking: <data> | automatically, when a line starts with You shout: %$? or Q shouts: %$? (see e) | [S2] 3:4905-4a4f |
| anything the user types | command line; the help points users to invite, join, watch, show games, tell, shout, kibitz/k | [S3] |
The move syntax matters for the adapter. [S4] says FIBS accepts moves with m or with no keyword at all. The adapter must accept bare 13 7 8 7 and bar 22 lines and treat the line as a move whenever it begins with a point number, bar/b or off/o. The help notes that a typed m[ove] ... also works but is not previewed on the board [S3].
The line handler is at 3:4817-4fa7. Matching is by prefix at the start of the line (after skipping leading > and spaces): the code compares the first character, then calls strncmp with the pattern's length (seg2:4c2c). Nothing is matched by substring. The patterns are fixed strings, except four that are rebuilt from the player names in the last board line (3:5559-5660) [S2].
Always active:
| Prefix (exact) | Effect | Offset |
|---|---|---|
| board: | parse the board line (section f) and redraw; also enables the game patterns below | 3:48d2 |
| You're away. Please type 'back' > (33 chars) | away state; repeated copies of the prefix are stripped from the line | 3:4817-4881, DS:0038 |
| No S username | who-list header (two spaces after No and after S); clears the same state flag. The who rows are not parsed | 3:48a5, DS:0074 |
| You shout: %$? / Q shouts: %$? | triggers the tell Q ... usage report above. Q was the author's FIBS name [S1] README | 3:4905-4a4f |
Active only after a board line has been received (flag at +0x539a):
| Prefix (exact) | Then parses | Effect | Offset |
|---|---|---|---|
| Please move | integer 0-4, then piece (so Please move 2 pieces. and Please move 1 piece. both match) | number of checkers to move | 3:4a72, 3:4554 |
| You roll | parser at 3:4494: skip the first word, expect roll or rolls , integer, and , integer, . | own dice; turn state "moving". You rolled 6, ... (opening roll) fails the parse and is ignored | 3:4abe |
| <name1> rolls | same parser | dice of the side named first in the board line (the watched player when watching) | 3:4bdf |
| <name2> rolls | same parser | opponent's dice | 3:4cbd |
| You can't move. | - | "can't move" sound | 3:4de3 |
| <name1> doubles. / <name2> doubles. | - | doubled state; Accept Double is enabled. Matches FIBS user doubles. Type 'accept' or 'reject'. | 3:4e09, 3:4e6a |
| You double. Please wait for | - | own double pending | 3:4ec1 |
| It's your turn. Please roll or double | - | roll-or-double state | 3:4ef6 |
| It's your turn to roll or double | - | same (an alternative wording, probably from an older FIBS) | 3:4f2a |
Not parsed and shown only as text [S2]: login and logout notices, who rows, invitations (... wants to play a n point match with you.), ** You are now playing ..., Starting a new game with ..., You rolled a, user rolled b, user moves ..., accept and reject replies, resign offers, game and match results, scores, and every chat form (tell, say, kibitz, whisper, shout). The board line is the only source of positions, the cube, the score and the end of a game (turn 0). After a move the client waits for the next board line rather than applying the server's moves text.
So the adapter must send board: lines (moreboards and autoboard behaviour, FIBS defaults when boardstyle is 3 [S4]) after every roll and every move, or the window does not change.
The parser is at 3:500e-5372. It uses an MFC/iostream string stream: getline(...,':') for the tag and the two names (up to 100 characters each), then >> int and >> char (the colon) in strict order for all 50 numeric fields. If the stream fails, it shows Failed to parse 'board:' command (3:87e6) and the board is not updated. Text after the last field is ignored, so a message glued to the end of a board line ([S4] "glued lines") is lost, not misparsed [S2].
| # | Field | Used for | Variable |
|---|---|---|---|
| 1 | board | tag | |
| 2 | player name | You when playing (compared with strcmp), otherwise the watched player; used to build <name1> rolls and <name1> doubles. | bp-0x116 |
| 3 | opponent name | <name2> rolls , <name2> doubles.; window title %s vs %s: score: %d-%d match: %d | bp-0x17a |
| 4-6 | match length, player score, opponent score | title; both scores 0 sets a "new match" flag | bp-0x14, -0xc, -0xa |
| 7-32 | positions 0-25 | multiplied by the colour field, so the client's own checkers come out positive | bp-0xb2.. |
| 33 | turn | turn * colour: +1 own turn, -1 opponent's turn, 0 game over | bp-0xe |
| 34-37 | player dice, opponent dice | the dice of the side to move are drawn | bp-0x3a..-0x30 |
| 38 | cube | cube value | bp-0x10 |
| 39-40 | may double (player, opponent) | cube enable | bp-0x16, -0x18 |
| 41 | was doubled | read | bp-0x1a |
| 42 | colour | sign normaliser; colour == -1 is stored | bp-8 |
| 43 | direction | -1: positions are used as they are; otherwise mirrored (25 - i) | bp-0x12 |
| 44-45 | home, bar | read | |
| 46-49 | on home, on bar (player, opponent) | bar and borne-off counts drawn | |
| 50 | can move | stored (+0x5420) | bp-0x28 |
| 51-53 | forced move, did Crawford, redoubles | read and not used as far as traced |
Answers to open item g2 in [S4], for this client only: FIBS/W works with either colour and either direction, so the adapter may send seat 1 as X with direction +1 (the natural backgammon/1 mapping in [S4] i). The sign of the bar counts in positions 0 and 25 is not needed, because FIBS/W takes the bar counts from fields 48-49 as well (whether positions 0 and 25 are ignored is UNVERIFIED).
Winsock route, registered user alice, playing bob. Lines marked S: come from the server and C: from FIBS/W. The banner is our own text. Board lines are abbreviated, and must be complete 53-field lines in practice.
S: <banner of our own>\r\n
S: login:
C: alice\r\n
S: password:
C: secret\r\n
S: \r\n
S: <welcome / motd lines>\r\n
S: >
C: set boardstyle 3\r\n
S: Value of 'boardstyle' set to 3.\r\n
S: >
(client shows "*** CONNECTED ***" and opens the board)
C: toggle ready\r\n
S: ** You're now ready to invite or join someone.\r\n>
S: bob wants to play a 3 point match with you.\r\nType 'join bob' to accept.\r\n>
C: join bob\r\n
S: ** You are now playing a 3 point match with bob\r\n
S: Starting a new game with bob.\r\n
S: You rolled 6, bob rolled 2\r\n
S: It's your turn to move.\r\n
S: board:You:bob:3:0:0:0:-2:0:0:0:0:5:0:3:0:0:0:-5:5:0:0:0:-3:0:-5:0:0:0:0:2:0:1:6:2:0:0:1:1:1:0:1:-1:0:25:0:0:0:0:2:0:0:0\r\n
S: >
C: 13 7 8 7\r\n
S: board:You:bob:3:...:-1:0:0:0:0:...\r\n>
S: bob rolls 5 and 4.\r\n
S: board:You:bob:3:...\r\n
S: bob moves 1-5 12-16 .\r\n
S: board:You:bob:3:...\r\n
S: It's your turn. Please roll or double\r\n>
C: roll\r\n
S: You roll 3 and 1.\r\n
S: board:You:bob:3:...\r\n
S: Please move 2 pieces.\r\n>
C: 8 5 6 5\r\n
S: board:You:bob:3:...\r\n>
S: bob doubles. Type 'accept' or 'reject'.\r\n>
C: accept\r\n
S: You accept the double. The cube shows 2.\r\n
S: board:You:bob:3:...\r\n>
...
S: You win the game and get 2 points. Congratulations!\r\n
S: board:You:bob:3:2:0:...(turn 0)...\r\n>
The toggle reply wording above is illustrative. Only the leading ** is matched, and only by EXAMPLE.SCR. The other lines are FIBS's documented texts [S4]. The ones FIBS/W matches are listed in section e.
Guest route: after guest, the adapter sends its registration text and a > prompt (no password: ). After the user's name x and two passwords, it must print You are registered. at the start of a line, followed by a > prompt. Only then does the script send set boardstyle 3 [S1].
For comparison with the MacFIBS research (bg-client-macfibs.md; MacFIBS sets toggle telnet NO per [S4]). The items peculiar to FIBS/W:
Yes, with the planned FIBS adapter, and no client-specific code paths beyond defaults. FIBS/W needs:
The user points the client at the ParlorNet host and port in Options/Advanced Options. On the dial-up route the user reaches ParlorNet through any shell or terminal server that can telnet host port. The board mapping can use seat 1 = X with direction +1 without mirroring. Confidence: high for the parsed strings and the board parser (read from the code). Medium for the full login dialogue until a capture against a stub server confirms it.
| These pages cover every ParlorNet server. | Source code | ParlorNet is free software. |