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

FIBS/W 1.30 (Windows 3.1): what the client expects from a FIBS server

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.

Key findings in brief

  1. FIBS/W is a terminal with a board window. It speaks FIBS telnet mode with boardstyle 3. It parses only a small set of server lines: the board: line and about a dozen fixed prefixes. Everything else (who lists, invitations, match start and end, chat) is shown as terminal text and not parsed [S2][S3].
  2. Two routes: Winsock 1.1 TCP straight to the FIBS host and port, or a serial modem to a dial-up shell host followed by telnet <host> <port>, driven by a small script language. Both routes end in the same FIBS login script [S1][S2].
  3. The defaults are host fraggel65.mdstud.chalmers.se and port 4321. Both can be changed in the Advanced Options dialog (INI keys FibsInternetAddress, FibsTelnetPort). A ParlorNet adapter on any port therefore works without patching [S2][S3].
  4. The login scripts need the telnet-mode prompt > at the start of a line (they wait for "\n>"), login: , password: , Value of in the reply to set commands, and, for new accounts, You are registered. at the start of a line [S1].
  5. Moves are sent as **bare point pairs without the move keyword**, for example 13 7 8 7, bar 22, 6 off [S2][S3].
  6. The board-line parser reads all 53 fields with a stream extractor and handles either colour and either direction (it normalises signs by the colour field and mirrors points when direction is +1) [S2].
  7. Verdict: compatible with the planned FIBS adapter (backgammon-network.md section h), as long as the adapter keeps the > prompt on for telnet-mode clients and produces the handful of exact lines listed in section e.

(a) Sources

(b) Connection details

ItemValueSource
TransportsWinsock 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 hostfraggel65.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 port4321 (INI FibsTelnetPort), editable in Options/Advanced Options[S2] 3:16d8; [S3]
Status textConnecting(%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 serverScripts 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 clientLines 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 optionsThe 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 lineBefore parsing, the client skips leading > and space characters, so > board:... parses as board:...[S2] 3:4883-4892
Modem defaultsinit 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.

(c) Login scripts

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

Winsock route: WINSOCK.SCW -> WSKLOGIN.SCR -> INITFIBS.SCR [S1]

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:

StepExact bytes the scripts matchNotes
Login promptlogin: (lower case, trailing space)after any banner
Password promptpassword: (lower case, trailing space)This is also evidence for the FIBS normal password prompt, an open item in [S4] g1
Logged ina 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 markerauthenticated. anywhere in the streamWhich FIBS message contains this word is UNVERIFIED. The adapter does not need it, because \n> also matches
Failed loginlogin: againsame as FIBS [S4]
Guesta 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 setThe exact FIBS registration dialogue is in [S4]. Only You are registered. is matched
set repliestext 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.

(d) Commands FIBS/W sends

From the GUI, menus and scripts. All are plain telnet-mode lines ending CR (CR LF on Winsock) [S2][S3].

CommandWhenSource
<name>, <password>login[S1]
set boardstyle 3, set timezone <tz>after login[S1] INITFIBS.SCR
rollclick on the cube bar when it is the user's turn to roll[S2] 3:2f92; [S3]
doubleclick on the cube (with a "Would you like to double?" confirmation unless ConfirmDoubles is off)[S2] 3:38da, 3:bc1f; [S3]
acceptclick on the cube when doubled, or menu Accept Double[S2] 3:3932; [S3]
rejectmenu 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 greedymenu toggles[S2] 4:3026, 4:3090, 3:8904
who, who readymenu Who / Who Ready[S2] 4:309e, 4:3038
pipmenu Pipcount (registered copies only; otherwise a local message)[S2] 4:3034, 4:3042; [S3]
away <message>, backmenu 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 typescommand 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].

(e) Server lines FIBS/W parses

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)EffectOffset
board:parse the board line (section f) and redraw; also enables the game patterns below3:48d2
You're away. Please type 'back' > (33 chars)away state; repeated copies of the prefix are stripped from the line3:4817-4881, DS:0038
No S usernamewho-list header (two spaces after No and after S); clears the same state flag. The who rows are not parsed3:48a5, DS:0074
You shout: %$? / Q shouts: %$?triggers the tell Q ... usage report above. Q was the author's FIBS name [S1] README3:4905-4a4f

Active only after a board line has been received (flag at +0x539a):

Prefix (exact)Then parsesEffectOffset
Please move integer 0-4, then piece (so Please move 2 pieces. and Please move 1 piece. both match)number of checkers to move3:4a72, 3:4554
You rollparser 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 ignored3:4abe
<name1> rolls same parserdice of the side named first in the board line (the watched player when watching)3:4bdf
<name2> rolls same parseropponent's dice3:4cbd
You can't move.-"can't move" sound3: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 pending3:4ec1
It's your turn. Please roll or double-roll-or-double state3: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.

(f) The board line

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

#FieldUsed forVariable
1boardtag
2player nameYou when playing (compared with strcmp), otherwise the watched player; used to build <name1> rolls and <name1> doubles.bp-0x116
3opponent name<name2> rolls , <name2> doubles.; window title %s vs %s: score: %d-%d match: %dbp-0x17a
4-6match length, player score, opponent scoretitle; both scores 0 sets a "new match" flagbp-0x14, -0xc, -0xa
7-32positions 0-25multiplied by the colour field, so the client's own checkers come out positivebp-0xb2..
33turnturn * colour: +1 own turn, -1 opponent's turn, 0 game overbp-0xe
34-37player dice, opponent dicethe dice of the side to move are drawnbp-0x3a..-0x30
38cubecube valuebp-0x10
39-40may double (player, opponent)cube enablebp-0x16, -0x18
41was doubledreadbp-0x1a
42coloursign normaliser; colour == -1 is storedbp-8
43direction-1: positions are used as they are; otherwise mirrored (25 - i)bp-0x12
44-45home, barread
46-49on home, on bar (player, opponent)bar and borne-off counts drawn
50can movestored (+0x5420)bp-0x28
51-53forced move, did Crawford, redoublesread 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).

(g) Sample session the adapter must be able to produce

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

(h) What FIBS/W needs beyond the MacFIBS set

For comparison with the MacFIBS research (bg-client-macfibs.md; MacFIBS sets toggle telnet NO per [S4]). The items peculiar to FIBS/W:

  1. The telnet-mode > prompt at the start of a line, after login and after each set. It must stay on by default for this client.
  2. password: (lower case) as the password prompt, and You are registered. at the end of guest registration.
  3. Value of in set replies.
  4. Bare move lines with no move keyword (13 7 8 7, bar 22, 6 off).
  5. The alternative wording It's your turn to roll or double is accepted but not required. It's your turn. Please roll or double is enough.
  6. CR LF from the client on Winsock; doubled 0xFF bytes in client data (harmless, never seen in ASCII commands).
  7. Optional: the FIBS ASCII-art banner line, for MANUAL.SCC only.
  8. A tell addressed to Q (the usage report). The adapter should answer it with a normal ** error, or ignore it. Reserving the name Q would stop a user called Q from triggering the report with shout %$?.

(i) Unverified items

  1. Which FIBS message contains authenticated. (a script branch target). Not needed for ParlorNet.
  2. Exactly how incoming telnet IAC sequences are filtered (4:a321). Sending no IAC except the FIBS echo pair is the safe course.
  3. Whether positions 0 and 25 of the board line affect the drawing, or only fields 48-49.
  4. Use of the "can move" field versus Please move n pieces. when both are present. The client stores both. Send both, as FIBS does.
  5. The state flag set by You're away... and cleared by the who header (+0x5414). Its user-visible effect was not traced.
  6. Behaviour when Value of does not arrive within 50 s. The @wait is outside an @if, so the script probably stops with wait script command timed out and never runs @board 1. Inferred from the interpreter's error strings (4:2e32), not traced.
  7. Whether the old wording It's your turn to roll or double came from an earlier FIBS version.

(j) Feasibility verdict

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.

This doc on GitHub


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