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

Cannon Fire: period network clients for artillery games

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

Method: web search; the Info-Mac abstracts (sunsite2 mirror) and UMich Mac archive indexes; an Aminet search and the readmes it returned; Wikipedia; Wayback copies of the Worms Knowledge Base and of the BattleDuel home page; Debian's source archive; and two downloads read statically: the BattleDuel 1.7.105 and 1.7.110 archives (Amiga guide text, and printable strings from the 68k binary) and the KOTH 0.8.0 source tarball. Files, URLs and sha256 are in a working folder outside the repository. Nothing was run and no game server was contacted.

The ParlorNet game is turn-based, on a terrain heightmap. For each client the question below is whether the physics and terrain live on a server (which we could imitate) or are computed on every peer (which we would have to match exactly).

Key findings in brief

  1. Most artillery games of the period had no network play at all. Scorched Earth (DOS, 1991-95) was hot seat; a modem icon added in 1.1 "was never implemented" [S1][S2]. Scorched Tanks (Amiga, 1994) was 2-4 players at one machine; its docs only say modem play "is still a possibility" [S4]. Pocket Tanks (2001) got LAN/IP play only in 1.3, November 2007 [S5]. None of the Mac artillery games in the Info-Mac and UMich archives mentions network play [S21][S22].
  2. BattleDuel (Amiga, 1994-99) is the one networked artillery game found for a vintage home computer. From 1.4.80 (April 1996) it plays two Amigas against each other over null modem, modem, TCP/IP (port 3000) and, from 1.6.80 (1997), Parnet/Pronet [S7]. One machine is the "server" and the other the "client". Both run the game and keep in step ("Waiting for sync", "Synchronisation error!") [S7][S8]. The protocol is undocumented and there is no source ("No. And there are no plans to release it") [S10]. It became freeware on 1 March 2001 [S7]. A Java port (2006, 1.7.110a 2009) plays against the Amiga version over TCP/IP [S9][S10].
  3. KOTH, King of the Hill (Unix, LibGGI, 1999-2003, GPL), is the only client found that talks to a real game server. It uses TCP port 8086 and binary packets with a two-letter type, and the server sends the terrain [S11][S13]. The protocol can be read in full from the source. It is the closest match to ParlorNet's model: server-held terrain, turn modes "take turns" and "simultaneous", and wind sent by the server [S11].
  4. XScorch (X11, 2000-2011, GPL v2 only) has experimental client/server play on TCP port 8367. It is off by default, and its own document calls it "unstable and incomplete" with "most simulation ... done on the client" [S14]. Scorched 3D (2001, GPL) is client/server too, but it is a 3D OpenGL game on modern systems [S15].
  5. Worms (Team17) is networked, commercial and peer to peer. Worms Reinforcements (DOS, 1996) added modem play [S19]. The Mac Worms (1996) has a network mode of unknown protocol [S20]. Worms 2 (Windows, 1997) used Team17 lobby servers and DirectPlay peer to peer for games [S16]. Worms Armageddon (1999) used WormNET, an IRC server plus HTTP scripts, for the lobby, and its games rely "on all of the clients performing identical simulations" [S17][S18]. The lobbies are documented by fans; the games are lockstep simulations we cannot serve.
  6. Verdict. KOTH is the most feasible ParlorNet target: a server we can imitate, with a protocol recoverable from GPL source. BattleDuel is the most valuable on vintage hardware (68k Amiga, also over serial and modem), but it is a lockstep peer with an undocumented protocol, and ParlorNet would have to match its physics exactly. Everything else is local-only, out of period, or commercial lockstep.

(a) Summary table

ClientPlatformYearsConnectionProtocol documented?LicenceDownload URLVerdict
KOTH (King of the Hill) 0.7.6-0.8.0Unix with LibGGI (X11 and others), Berkeley sockets0.3 pre-release June 1999; Debian 0.7.6 Aug 1999; 0.8.0 Feb 2003TCP client/server, default port 8086; dedicated server kothsNo document of the wire format, but full GPL source and a packet-type list in doc/hackinginfo.txtGPL v2https://ibiblio.org/pub/linux/games/multiplayer/koth-0.8.0.tar.bz2 ; Debian potato/woody sources https://sources.debian.org/src/koth/Best fit. Imitate the server (section f)
BattleDuel 1.4.80-1.7.110Amiga, OS 2.04+, 1 MB chip RAM; AmiTCP or AS225 for TCP/IP1.00 Apr 1994; network from 1.4.80 (27 Apr 1996); 1.7.105 Sep 1999; freeware Mar 2001; 1.7.110 Jan 2006Peer to peer, one side "server" and one "client": null modem (serial.device), modem (client auto-answers), Parnet/Pronet (shared files), TCP/IP port 3000No. Binary only; source not releasedfreeware (from 1.7.105, 1 Mar 2001); copyright 1995-1999 the authorshttps://aminet.net/package/game/2play/BattleDuel and https://aminet.net/package/game/2play/BattleDuel_v1.7.110Possible only as a lockstep virtual peer, after reverse engineering. Hard (section g)
BattleDuel Java 1.7.110aJava 1.5+ (Windows, Linux, Mac OS X)2006 (port), 1.7.110a 1 Nov 2009TCP/IP, interoperates with the Amiga versionNo; source not releasedfreewareWas https://terstiege.de/files/battleduel/bd_v1.7.110a.zip (404 on 2026-11-21; no Wayback copy found)Out of period. Useful as a readable (bytecode) witness of the Amiga protocol if a copy turns up
XScorch 0.1.x-0.2.1Unix/X11 (GTK)2000-2011; Debian woody had 0.1.14TCP client/server, port 8367, built only with --enable-networkdoc/NETWORK (status, not wire format) and GPL sourceGPL v2 onlyhttps://sources.debian.org/src/xscorch/Weak: network mode experimental, clients simulate, desyncs acknowledged
Scorched 3DWindows, Linux, Mac OS X, other Unix; OpenGLfrom April 2001client/server (scorched3ds), LAN and InternetGPL source (wire format not checked)GPL-2.0-or-laternot checked (UNVERIFIED)Out of the vintage scope (3D, modern systems). Not pursued
Worms 2Windows 951997Team17 lobby servers uk1.servers.worms2.com 17000/17171; games peer to peer over DirectPlay (47624, 2300-2400)Lobby documented by fans; game traffic notcommercial (Team17)commercial, not redistributableLockstep peer game; only the lobby could be imitated. No
Worms ArmageddonWindows1999 onWormNET: HTTP scripts + IRC lobby; games hosted on a player's machine, TCP 17011Lobby and parts of the game protocol documented by fans; a GPLv3 lobby client existscommercial (Team17)commercial"identical simulations" on every client. No
Worms (Mac)Mac OS 7.5-9.2, 68k + PPC1996"over a network" (hold L and N at launch); protocol unknownNocommercialhttps://www.macintoshrepository.org/4713-wormsUnknown protocol, lockstep likely (UNVERIFIED). No
Worms ReinforcementsPC (DOS)1996dial-up modem; a network game also mentionedNocommercialnot checkedNo
Scorched Earth 1.5DOS1991-95none (hot seat); modem icon never implemented-sharewarehttps://archive.org/details/msdos_Scorched_Earth_1991No network client
Scorched TanksAmiga1994none (2-4 at one machine); modem play only planned-not statednot checkedNo network client
Pocket TanksWindows, Mac OS X2001; network from 1.3, Nov 2007LAN/IP from 2007Nocommercial-Out of period
Mac artillery games (Tank Wars 2.0.0, BattleTanks 2.12, 3-D Cannon, Cannons and Castles 2.0.2, artillery 2.01)68k Mac1992-97none stated (hot seat or vs. computer)-sharewareInfo-Mac game/arc, gameNo network client found
Amiga artillery on Aminet (Tanx 1992, Tykkipeli 1992, artil20u 1993, Charr 1994, TankYou 1995, bomb 1997, Mortar 1999, sah 1992)Amiga1992-99none stated in the readmes-varioushttps://aminet.net/search?query=artilleryNo network client found

(b) Known servers and services of the era

(c) KOTH in detail

From the 0.8.0 source and doc/hackinginfo.txt [S11], cross-checked against the Debian 0.7.6 source (August 1999) [S13]. Nothing was compiled or run.

Connection. The server koths listens on TCP, DEFAULT_PORT 8086, which can be changed with -p or server.port in the config. The same port was used in 0.7.6 [S11][S13]. The client sends NP (new player) on connect [S11].

Framing. Each message is a 2-byte big-endian length (htons), then the payload. The payload starts with two ASCII letters giving the type. Integers are packed in network byte order (htonl/htons). Names, messages and weapon names are fixed 256-byte fields in the structures [S11] (tcpcore.c, relay.c, packets.[ch]). PROTOCOL_VERSION is 11 in 0.8.0 and 10 in 0.7.6. The server announces it with PV, so a server must match the client's version [S11][S13].

Message types (from hackinginfo.txt; the rlRegisterHandler calls are authoritative) [S11]:

Game model [S11]:

(d) BattleDuel in detail

From the 1.7.105 AmigaGuide (English) and readmes [S7], strings in the 1.7.110 binary [S8], and the authors' pages [S9][S10].

Both peers therefore run the full game and exchange settings plus, very probably, each player's shot input. The message format is UNVERIFIED.

(e) Other clients, briefly

(f) Feasibility verdict: KOTH (most promising)

Yes, as a KOTH server extension, with one real constraint. KOTH clients connect to a server, so a ParlorNet extension can be that server. Every packet type and field can be read in the GPL source, and the client's handler table settles what it accepts.

What the extension would do:

  1. Accept TCP, answer NP with PV (version 11 for 0.8.0, 10 for 0.7.6), UR, the player list and the game mode.
  2. Map a ParlorNet Cannon Fire table to a KOTH game: pregame chat and readiness (CR), then GM in game, TerrainInfo and UT spans built from our heightmap (one span per column), WS wind and ST tank positions.
  3. Turn FS (angle, velocity, weapon) into our move. Broadcast the shot (TF/SF) and AS. After the plugin resolves it, send ST (armour, position), US scores, and the next UF / attacker.
  4. Weapons: KOTH sends weapon names, and its clients only animate weapons they know. Our weapon set would have to be a subset of KOTH's, or mapped to KOTH names.

The constraint: each KOTH client runs its own ballistics and terrain damage, from the gravity and lerp values the server sends [S11]. Unless our plugin's physics matches KOTH's exactly, the client's crater and impact will differ from ours. The server already corrects tank state with ST. Terrain can be corrected with NT, which makes the client fetch all of it again, though whether that works mid-game is UNVERIFIED. The alternative is to adopt KOTH's ballistics in the Cannon Fire plugin. KOTH is GPL v2 and ParlorNet is MIT, so copying its code into the core is out. A separate plugin process under the GPL is possible in principle (UNVERIFIED, a question for the project, not legal advice).

Cost and value: medium effort, high confidence on the protocol (it is source). Audience: Unix workstations and Linux PCs of 1999-2003 with LibGGI. No 68k Mac, Amiga or DOS client.

(g) Feasibility verdict: BattleDuel (best vintage client)

Possible only as a virtual peer, and hard. BattleDuel has no server: two copies run the same simulation and check that they stay in sync [S7][S8]. To play a BattleDuel Amiga against a ParlorNet table, the extension would have to act as the other BattleDuel, the server side (the client side needs the Amiga to dial or connect to us). That means:

On the plus side, the TCP/IP mode on port 3000 needs no serial hardware, and the serial and modem modes could later be reached through a serial-to-TCP bridge.

Confidence: high that it is lockstep peer to peer (the authors' own words). Wire format unknown. Effort high; value high for Amiga users only.

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.

(g2) Mac: the GameMaster Gravity Wars rulebook (added 2026-11-21)

Gravity Wars (Rhys Hollow, rulebook version 1.4.5, August-September 1992) is a two-player GameMaster rulebook for 68k Macs. It ports the Amiga Gravity Wars over MacTCP or AppleTalk, port 918 (gamemaster.md) [S23]. Players take turns firing a missile by angle and speed. The missile flies among planets of three densities and black holes, not over a terrain. The rulebook sends aim, planet, explosion, abort and restart messages (SENDAIM, SENDPLANETS, SENDEXPLOSION, SENDABORT, SENDRESTART), and both machines fly the missile; its documentation says an abort works only "if it is moving on both machines" [S23]. It is the only networked turn-based shooting game found for the classic Mac, but it is a different game from Cannon Fire, which has terrain, wind and damage by distance. A GameMaster server extension could carry it only with Gravity Wars' own physics as a separate game type. Verdict: not a Cannon Fire client.

(g3) Mac: Dome Wars and Worms (added 2026-11-21)

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

Details and sources are in 8bit-clients.md; tags below are that note's. This answers item 7 below in part:

(h) Unverified items and open questions

  1. Whether any public KOTH or XScorch server ran in 1999-2003.
  2. KOTH: the orientation of terrain span values; whether NT mid-round is safe; how UF sequences a take-turns round. Settle these with a capture: a KOTH client in a VM against a logging stub on 8086.
  3. BattleDuel's message format, framing over TCP versus serial, and what is exchanged per shot (inputs only, or results too).
  4. Whether a copy of BattleDuel Java 1.7.110a survives elsewhere.
  5. The Mac Worms (1996) network protocol (AppleTalk or other) and whether it is lockstep.
  6. Worms Reinforcements' exact modes (modem and network).
  7. A networked Mac, DOS, Atari ST or C64 artillery game of 1985-2002: none was found in the sources checked. This is a negative result; absence is UNVERIFIED.
  8. The Scorched 3D wire format and download location (not checked; out of scope).
  9. Gorillas, Gravity Wars, Amiga Tanx and other artillery games named in [S3]: no network play was found, but only the sources listed were checked.

(i) 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.