FujiNet Firmware Lets Classic Disk Games Save High Scores to Shared Servers
Many Atari disk games save their high-score table back to the disk, for example Jumpman or B.C.'s Quest for Tires. When that disk is an image on a public TNFS server, though, it is mounted read-only, so the scores are lost or the game throws an error. The FujiNet firmware build of 12 October 2022 (version 0.5.7eb55adb) fixes this. A game image can now mark a small range of sectors as writable, and FujiNet switches the image to read/write just long enough to save the scores.
How it works
The feature uses three unused bytes in the ATR header:
| ATR header offset | Meaning |
|---|---|
| +12 | Number of sectors that may be written (up to 255) |
| +13, +14 | First writable sector (1–65535, low byte first) |
For example, a Jumpman image whose header has 02 at offset 12 and BB 02 at offsets 13–14 allows two sectors starting at sector 699 ($02BB) to be written. Mount such an image read-only as usual. When the game writes to one of those sectors, FujiNet logs "High score mode activated" and lets that write through. Everything else on the disk stays protected.
The current rules are simple: the game must be in an ATR image, and only one contiguous range of sectors can be made writable.
Try it
By October 2022 the apps.irata.online TNFS server held a set of prepared games under Atari 8-bit / Games / High Score Enabled. Thomas Cherryhomes posted a video of the feature working with B.C.'s Quest for Tires. A companion site, scores.irata.online, reads the live score tables out of the ATR images and shows them as web pages. Each game has its own small "scraper" program that decodes its score format.
The FujiNet wiki shows how to make your own program high-score-enabled. Write a scores file from Atari BASIC, use NOTE #1,SECT,BYT to find which sector it sits on, then put the sector count and number into bytes 12–14 of the ATR with a hex editor. The example includes a fast BASIC high-score routine that compares scores directly in screen memory.
Run your own party server
The project's fujinet-high-scores repository, started in October 2022, contains blank high-score-enabled game images and the web scoreboards. A wiki guide explains how to build a complete LAN-party server on Ubuntu Server 22.04: compile and install tnfsd, copy the game images into /tnfs, open UDP port 16384, then add nginx and the per-game scraper services. Games in the guide include Jumpman, Lode Runner, PAC-MAN, Frogger, Gorf, Flak, Spelunker, Rear Guard, Wizard of Wor and more, and the repository has added many others since.
Why it matters
The change needs no patching of the games themselves. Decades-old software, written long before networks, gets shared, persistent leaderboards just because the disk image lives on a FujiNet server. That makes public servers and events far more fun, and it keeps the original games untouched.
Credits
- Picture: Jumpman is one of the high-score-enabled games in the FujiNet collection. — Image from the FujiNetWIFI fujinet-high-scores GitHub repository
- FujiNet Wiki — High Score storage for Legacy Games — FujiNet Wiki; FujiNet project
- FujiNet Wiki — High Score writeable ATR example in BASIC — FujiNet Wiki; FujiNet project
- FujiNet Wiki — Installing a High Score Party Server — FujiNet Wiki; FujiNet project
- GitHub — FujiNetWIFI/fujinet-high-scores (created 2022-10-11) — Image from the FujiNetWIFI fujinet-high-scores GitHub repository, 2022
