graal-5.00r7-G3D22067: 0.0.1 rebuild of the 5.00r7 client

graal-5.00r7-G3D22067/README.md

@@ -0,0 +1,97 @@
+# Graal 5.00 rev 7 (`G3D22067`)
+
+The 5.00r7 client, rebuilt. The original is the Windows build of July
+2007: a Delphi launcher over a C++ engine library. On the wire it keeps the
+gen-5 codec of 2.22 to 4.20, with its own token, no tamper check and no
+listserver. This folder starts from `graal-3.153-G3D28015` and changes what
+the 5.x notes say differs. This is the 0.0.1 reproduction: hit or miss.
+
+> **Not affiliated.** graal-delphi is an independent fan project. It is not
+> affiliated with, endorsed by, or connected to GraalOnline or
+> graalonline.com, Cyberjoueurs, or Stéphane Portha ("unixmad").
+
+## Sources
+
+From [graal_analysis](https://github.com/squirelworks/graal_analysis), not
+from decompiled code:
+
+| Area | Notes |
+|---|---|
+| Token, login line, ids handled, Login server | `protocol/v5x-clients.md` |
+| Ids, props, login fields in table form | `version-profiles/5.00-6.03.toml` |
+| Login mode, server warp, movement, timings | `version-profiles/lab-v5-2026-10-30.md` |
+| What the server sends and the client answers | `protocol/v5v6-lab-play.md` |
+| Everything carried over | `../graal-3.153-G3D28015/README.md`, `../graal-2.22-GNW03014/README.md` |
+
+## What differs from the 3.153 rebuild
+
+| | 3.153 | 5.00r7 (this folder) |
+|---|---|---|
+| Game token | `G3D28015` | `G3D22067` |
+| Login line | ends at the password | then `win,"","",""` (platform and three machine fields) |
+| First frame | 5, 37, 34 bigmap, 34 minimap | 5 alone; 37 in its own gen-5 frame |
+| Listserver | `G3D30123newmain` | none: the first server is a game server named `Login` |
+| Login mode | no | while the server's name starts with "login", no characters are drawn |
+| Server warp (178) | comma text | split on commas only; the name becomes the server's name |
+| Server ids handled | 88 | 100: adds 105-107, 140, 170, 182, 183, 190, 191, 193-195, 197 |
+| First props | 0, 18, 31, 33, 52, 75 `mac`, 76 | 0, 13, 52, 75 `win`, then X2 and Y2 |
+| Movement | X and Y every other tick | X2 / Y2 (78, 79), pixels, every tick, only what changed |
+| Process list (182) | not handled | answered with 44 |
+
+The machine fields are MD5 hashes of the Windows product id, the adapter
+MAC and the `C:` volume serial on the original. The rebuild reads none of
+them and sends each as `""`, which is what the real 5.00r7 sent for its MAC
+field in the lab. Its answer to 182 names only its own game window (the
+server's name), not the processes on the machine.
+
+## Units
+
+As in 3.153, with the suffix `500`: `Protocol500`, `GraalClient`,
+`Adventure`, `Graal500.dpr`, `ListServer500`, `StartScreen500`, `RunMode`.
+
+## Running it
+
+Put `Graal500` in the root of a 5.00r7 install and start it with no
+arguments for the start screen. It finds the install's files from there,
+or from `graal-assets/5.00r7/` and `graal-assets/common/` next to it.
+
+Start asks a Seihai listserver for the server list (`listserver.txt` next
+to the program, else `listserver.graal.in` on 14922), since the rebuild
+cannot show the Login server's scripted list. The picked server's name
+becomes the client's server name, as if the Login server had already
+warped there, so the player is drawn.
+
+```
+GRAAL_PW=... Graal500 --server HOST:PORT --account NAME            # as Login
+GRAAL_PW=... Graal500 --server HOST:PORT --account NAME --server-name Classic
+Graal500 --level some.nw                                          # offline
+```
+
+With `--server` and no `--server-name` the server is `Login`: the level is
+drawn, characters are not, until the server sends a 178.
+
+## Files it opens
+
+From the program's folder (or `--data`), then `graal-assets/5.00r7/`, then
+`graal-assets/common/`:
+
+- `pics1.png` (or `pics1.gif`), `arrays.dat`
+- `levels/` for levels, ganis and images; `levels/heads/`, `levels/bodies/`,
+  `levels/swords/`, `levels/shields/`, `levels/hats/`, `levels/images/`
+- `levels/offlinetutorial_b-2.nw` (or `.graal`) for Training, else `start.nw`
+- `listserver.txt` (optional)
+
+## Not yet, or not known
+
+- The Login server's scripted GUI (server list, accounts) and GS2 in
+  general: 140 and 197 (class and weapon scripts, the `GRESCR01` cache),
+  195 (gani scripts) and 190 (`onServerListerConnect`) are accepted and
+  ignored.
+- `GR-V1.05` levels (tile layers) and `GRPKG001` update packages.
+- The base-file requests after the language (`basepackage.gupd` by 47 or 23).
+- The keep-alive 24 the lab saw every 5 s: its payload was not recorded.
+- 183 ("is this process running?") is accepted and not answered.
+- Whether 5.00r7 plays offline at all is not traced; Training keeps 3.153's.
+- The 3D mode (Torque, `Graal3DEngine.dll`, protocol 24).
+- No side-by-side run against the real 5.00r7; that is 0.0.2 work.
+- Everything still missing from the 3.153 rebuild.

graal-5.00r7-G3D22067/RELEASE_NOTES.md

@@ -0,0 +1,62 @@
+# Graal 5.00 rev 7 (G3D22067)
+
+The first rebuild of the Graal 5.00 rev 7 client, in Delphi (Object
+Pascal). The original is a Windows program from 2007; this rebuild runs on
+Linux and Windows. It is an early version: most of the game (NPCs, items,
+weapons, scripts, the scripted login screens, the 3D mode) is not there
+yet.
+
+> **Not affiliated.** graal-delphi is an independent fan project. It is not
+> affiliated with, endorsed by, or connected to GraalOnline or
+> graalonline.com, Cyberjoueurs, or Stéphane Portha ("unixmad").
+
+These zips hold no original Graal code, graphics, sounds or levels. The
+program carries small original default graphics and a starter level of its
+own, so it runs as it is. Put it in the root of a 5.00r7 install you own
+(or point it at one with `--data DIR`) and the install's tiles, ganis,
+heads and bodies take their place. The shared `graal-assets/` folder next
+to the program works too (`graal-assets/5.00r7/`, then
+`graal-assets/common/`).
+
+## Downloads
+
+| Zip | Runs on | Window |
+|---|---|---|
+| `…-linux.zip` | Linux x86-64 | X11 |
+| `…-windows.zip` | Windows, 32-bit | GDI |
+
+Each zip has `Graal500` (the client), `Test500` (its test suite) and the
+build's README.
+
+## What works
+
+- The start screen: nick name, Training, Start. Start fetches the server
+  list from `listserver.txt` next to the program, or else
+  `listserver.graal.in` on port 14922. Then account, password and Connect.
+- Login with `G3D22067`, the platform `win` and three empty machine
+  fields; the language in its own frame; no tamper check.
+- The Login server: a server reached by its address alone is called
+  Login, and there the level is drawn but no characters, until the server
+  moves the client on with a server warp. A server picked from the list
+  plays at once.
+- Server warps: the client logs in again to the named host and port, under
+  the new name.
+- The first props with `win` as the system name; movement sent every tick
+  in whole pixels.
+- The board, the player and other players drawn from the install's tiles
+  and ganis; walking and collision; level links; gmaps and their edges.
+- A headless mode for stress runs, with JSON stats.
+
+## Not yet
+
+NPCs, baddies, items and weapons; scripts (class, weapon and gani scripts
+and their cache); the scripted server list and account screens; chat;
+layered levels; update packages; the 3D mode. See the build's README for
+the full list.
+
+## Checks behind this release
+
+The test suite (94 checks) runs with range and overflow checks and the heap
+tracer, and must end with no unfreed memory. CI also logs two of these
+clients into seihai-gserver, has the second see the first, and walks one
+through a level link.