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

Mancala (Kalah, Oware/Awari and relatives): period network clients

Status: research notes, 2026-11-21. Every fact carries a source tag like [S3] (list at the end). Anything not backed by a source is marked UNVERIFIED. Nothing here comes from memory.

Method: web search; the Info-Mac board-game abstracts; Wayback Machine copies of 1998-2001 pages (Myriad's Awale pages, Richard's PBeM Server); Aminet and Atarimania entries; files from Info-Mac and from CD images on discmaster, read as strings only (Awale 2.2.2 for Mac, Awale 2.3.1 for Windows readmes, Stones II). Downloads, URLs and sha256 are in a working folder outside the repository. Nothing was run, and no game server or IRC server was contacted.

Key findings in brief

  1. One real candidate: Awale by Didier and Olivier Guillion (Myriad, Toulouse), Mac and Windows, with "live" Internet play from version 2.x in late 1997 [S1][S2][S4]. Its Internet play runs over public IRC: the program carries a list of 125 IRC servers on DALnet, EFnet, IRCNet, Undernet and GalaxyNet (network;site;host;port) and its own IRC client code (NICK, USER, JOIN %s %s, MODE %s +k %s, TOPIC, LIST, PRIVMSG %s :%03d ..., PING/PONG) [S3]. Players meet in an IRC channel and the two programs exchange moves as PRIVMSG lines with a three-digit code and English text such as I want to challenge %s (%s) and I choose : (%d) [S3].
  2. So the "server" Awale talks to is a plain IRC server, which is documented (RFC 1459, 1993 [S16]) and easy to imitate; the game layer is peer to peer on top of it. A ParlorNet server extension would be a small IRC server on its own port, plus a bridge that shows ParlorNet players at Mancala tables as Awale peers in the channel and speaks Awale's message lines for them. The Awale message codes still have to be recovered (from the code or from a capture); the text formats are already readable in the binary [S3].
  3. Rules: Awale plays the Oware/Awale family (16 predefined rules by 1999: Awale, Oware, French Wari, Songo, Vai Lung Thlan and others), plus user-defined rules; no Kalah rule is predefined [S2][S4]. A ParlorNet Mancala that should play Awale clients must offer the Awale (Oware/Wari) rule.
  4. Play by e-mail: Richard's PBeM Server (pbmserv@gamerz.net, visitor counter "since August 22th, 1996") ran Wari by mail with a documented command set (wari move <board> <userid> <password> <house>) [S6][S7][S8]. Any period mail program is the client. Its rules page is public; this is an alternative transport for any 8-bit machine with mail, not a game client.
  5. Serial peer to peer: Buttonz Awari (Atari ST, Majic Soft, 1993): "Two player mode only available with serial cable" [S9]. Protocol undocumented. Bridging would need a serial-to-TCP gateway and reverse engineering; low value.
  6. No AppleTalk Mancala was found. The Info-Mac board-game abstracts list five Mac Mancala/Kalah programs (1992-1997); none mentions network play [S5]; Stones II's binary has no network strings [S10]. No mancala on the period online services or game servers was found: searches found nothing for the Gaming Zone, Yahoo! Games, Pogo, GEnie, CompuServe, AOL or Prodigy, and GGS's game list names no mancala game [S11][S12]. Myriad itself claimed in 2006 that its Awale was "the only one that enables human player to challenge 'live' through the Internet" [S13].

Summary table

ClientPlatformYearsConnectionProtocol documented?LicenceDownloadVerdict
Awale 2.2.2 to 2.4 (D. & O. Guillion, Myriad)Mac 68k and PowerPC (Open Transport or MacTCP); Windows 95/NT4, Win 3.1x+Win32s2.x Internet play from Dec 1997; 2.4 still current in 2001IRC (public IRC networks, server list in serveurs.cfg); moves as PRIVMSG between the two programs; results optionally mailed by SMTPIRC: yes (RFC 1459). Awale's message layer: no, formats readable in the binary, codes not yet recoveredshareware US$10 in 1997-2001; freeware since 2013 (4.0)Mac 2.2.2c: https://archive.info-mac.org/game/awale-222c.hqx ; Mac 2.4b: https://www.macintoshrepository.org/18994-awale ; Windows 2.3.1: discmaster TOP100WIN98 CD (see SOURCES.md)Best candidate. Server we can imitate: a small IRC server plus a bridge speaking Awale's peer messages. Oware/Awale rules only
Awale 3.x-5.0 (Myriad)Windows 95 and later, Mac OS (3.0 dropped 68k and Win 3.1)3.3 Aug 2002, 3.4 Nov 2002, 4.0 May 2013Myriad's "own server" (3.0)nofreeware since 4.0https://www.myriad-online.com/en/products/awale.htmOut of period (3.x is 2002 at the edge); protocol unknown. Not pursued
Richard's PBeM Server, Wariany machine with e-mailfrom 1996e-mail to pbmserv@gamerz.netyes (public help pages)service; server code licence UNVERIFIEDn/a (any mail client)Imitable (mail commands), but needs a mail transport, not a game client. Secondary
Buttonz Awari (Majic Soft)Atari ST1993serial cable, peer to peernocommercial; demo freely distributablehttps://www.atarimania.com/st/dumps/buttonz_awari_majic_soft.zipPeer to peer over serial; bridge only with a serial gateway and reverse engineering. Low value
AMancala 1.19 (Thorsten Koschinski)Amiga1992"Zero, one and two player mode"; how two players connect is not statednonot statedhttps://aminet.net/package/game/board/AMancalaUNVERIFIED whether any link play exists; probably local. Not a candidate
Mac Mancala programs: Game of Kalah (1992), Kalaha 1.0, Mancala 1.0 (1994), Stones 1.1 (1995), Stones II (1997), YA-Mancala 1.0.1Mac1992-1997none found (local play)n/afreeware / sharewareInfo-Mac game/brd and gameNo network play. Not candidates

Details

Awale (Myriad / D. & O. Guillion)

Identity and versions. Awale is by Didier and Olivier Guillion, "22 rue Pierre d'Aragon, 31200 Toulouse", dated "January 1996-december 1 1997" for Mac 2.2.2 [S3 ReadMe]; Myriad was founded in 1988 in Toulouse, Didier handles the Mac side and his brother Olivier the Windows side [S14]. The Info-Mac upload 2.2.2c (archive game/awale-222c.hqx, StuffIt dated 1997-12-10) says: "New in this version: You can challenge an opponent on the Internet, or view 'live' the game played by other players on the Internet, send and receive messages" [S1]. Windows 2.3.1 (March 1998, Windows 95/NT4 or Windows 3.1x+Win32s) says: "It's now possible to play against another player through the Internet. Awale can now connect you to a chat-room to communicate with other players and to challenge them 'live'" [S4]. In February 1999 and still in March 2001 Myriad's page offered 2.4 for Windows (1,090,028 bytes) and 2.4b for Mac (839,552 bytes), with "Updated server list for Internet play", a weekly "Internet Awale Tournament, every Sunday, at 16:00 GMT", "Transparent network operations (no need to use another software)" and tournament points [S2]. Version 3.0 rewrote Internet play to run "on our own server" and dropped 68k Mac and Windows 3.1; 3.3 is dated August 2002, 3.4 November 2002, 4.0 May 2013 (freeware) [S13].

Requirements (Mac 2.2.2). Tested on Mac OS 8. On a PowerMac without Open Transport the PowerPC build will not load and the user should install the 68K version (a check box in the installer) [S3 ReadMe]. The setup dialog offers "I want to use MAC/TCP rather than Open Transport" [S3]. So 68k Macs with MacTCP and PowerMacs with Open Transport are both covered.

Licence. Shareware, US$10 after a 3-week trial; free non-commercial copying if no file is changed; unregistered copies lack high levels and saving [S3 ReadMe]. Freeware since 4.0 (May 2013) [S13]. Whether the freeware status covers the old 2.x builds is UNVERIFIED.

Internet configuration files (Mac 2.2.2, folder Internet) [S3]:

IRC client code (strings in the PowerPC code fragment Awale.pef and the resource fork) [S3]:

Rules. The Mac 2.2.2 Logic folder holds 13 rule files: 2-4, Adjito, Awale, Dakar, Darra, FrWari, Halusa, Jodu, Kale, Nyakun, Oware, Songo, VaiLung [S15]. The "Awale" rule file: "The most played classical rule ... the capture occurs in the opponent's territory, when the number of seeds in the ending hole reaches 2 or 3. Also called : Wari, Woro, Awar?, Ayo, Walu, Koro, Adji" [S3]. Version 2.4 lists 16 rules (adding Adji-Boto, Ot-Tjin, Wouri) and "now possible to sow in the lofts" [S2]. No Kalah rule is predefined [S2][S15]; whether a user-defined rule can express Kalah (store sowing, extra turn) is UNVERIFIED.

Mac and Windows together. Both builds advertise the same Internet play [S1][S4]; that Mac and Windows copies met in the same channel is likely but UNVERIFIED (the Windows installer payload is compressed and was not unpacked).

Feasibility verdict (ParlorNet server extension). Good. Awale does not talk to a game server: it talks to an ordinary IRC server and to other Awale copies through it. ParlorNet can imitate the IRC server (RFC 1459 subset: registration, JOIN with key, MODE +k, TOPIC, LIST, PRIVMSG, PING/PONG, PART, QUIT) on its own port, and run a bridge inside it that shows each ParlorNet player at a Mancala table as a channel member and speaks Awale's PRIVMSG lines on their behalf; two Awale players meeting there simply play each other through the relay, as on 1998 IRC. To point a copy at a parlor, the user edits the plain-text serveurs.cfg (one line, ParlorNet;name;host;port). Open questions before building: the code number of each message, the exact field order of the introduction line, how the program finds players (channel NAMES/WHO or the introduction message), whether the dead HTTP update host or a missing SMTP relay blocks play, and the move numbering in I choose : (%d). The cheapest way to settle all of them is to run Awale 2.2.2 (68k under an emulator) against a logging IRC server stub, which also settles the codes. Constraint: ParlorNet's Mancala must use the Awale/Oware rule for these clients.

Richard's PBeM Server (Wari by e-mail)

Buttonz Awari (Atari ST)

Others checked

PC clients: DOS, Windows 3.x and Windows 95/98

Added 2026-11-21 from docs/research/pc-clients.md; tags like [pc S1] are that file's sources. Nothing was run.

Mac search, second pass (2026-11-21)

No further networked Mac mancala was found (mac-clients.md). Strings of Mancala 1.0/1.1 (Jamie Kowalski, 1989), Mancala (Todd Glenn Clements) and Pits & Stones 2.20 (Peter T. Sabin, 1990) have no AppleTalk, PPC Toolbox, modem or TCP references. Info-Mac's abstracts for Mancala 2000, Kalaha 1.1 and MacStones 1.2 mention no network play [S22]. GameMaster had no mancala rulebook (gamemaster.md). Awale remains the only Mac candidate.

Added 2026-11-21: 8-bit machines and online services

Details and sources are in 8bit-clients.md; tags below are that note's.

Unverified items and open questions

  1. Awale message codes (%03d) and which text goes with which code; the field order of the I'm (...) introduction line; how a move is numbered in I choose : (%d) and MY hole #(%d).
  2. How Awale finds players on a server (channel names list, LIST, introduction broadcasts) and whether it needs the channel key awpl set by the first arrival (MODE +k).
  3. Whether a failed HTTP config update (dead wwwperso.hol.fr) or a missing SMTP relay stops Internet play, and whether editing serveurs.cfg is enough to point it at a parlor.
  4. What "play on my local network" and "connect directly to my partner" do on the wire (possibly direct TCP; possibly a LAN IRC server).
  5. Whether Mac and Windows 2.x copies interoperate (likely) and whether 2.4b changed the message set.
  6. Whether Myriad's freeware status (2013) covers 2.x builds.
  7. Whether a user-defined Awale rule can express Kalah.
  8. Whether any period online service ran a mancala game (none found).
  9. Whether pbmserv ever ran Kalah or Oware (only Wari found).

Sources

Addendum, 2026-11-22: Unix and X11 clients

From docs/research/x11-clients.md (sources there):

This doc on GitHub


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