Speed Fight: the DOS game starts from a file in its .scry/ folder

Speed Fight (Eco-Games / GAMART, 1994) was an arcade game, and its team ported the same
source to MS-DOS. This demo starts the DOS version from a start profile, a saved set of start
arguments kept in the game's .scry/ folder. Then it runs to routines by their names, reads a
variable, and films the match the game plays by itself.
What you are watching
run_tostops where the game starts playing itself, andrecordfilms the match.
The program
Speed Fight is not distributed with this repository. The demo needs a directory with
EXES/SPEEDF.EXE and EXES/SPEEDF.MAP, its .scry/ folder, where the game keeps that start
profile, and its SCRIPTS/dosbox-mcp-conf.sh.
Run it
$ uv run python demos/speedf/demo.py --cwd /path/to/speedf-msdosEach line it prints is one call and its check. The window opens behind the others, so the run does not take your keyboard.
--cwd PATH(absolute or~-led) is the directory holding the game.--binary PATH(absolute or~-led) picks the DOSBox-X to start. Left out, it isDOSBOX_X_BINARY, else thedosbox-xon yourPATH.--display Nopens the window on that display. Left out, it opens on the main one.--transcript PATHmoves the whole transcript; the run's other files go beside it.--update-readmerewrites this page's generated parts,TRANSCRIPT.md,screen.pngandloop.webp, from a run where every step passed. It needs ffmpeg andimg2webpon yourPATH.
Exit codes: 0 every step passed, 1 a step failed, 2 a usage error, 3 nothing was demonstrated.
That last one is a copy without its .scry/ folder or its program, a relative path or a server that
did not start.
The run passes two settings of its own to start: the normal core and a fixed speed. The
game's conf keeps the dynamic core, which can run past a code breakpoint, and cycles=max,
which gives the game as much speed as your computer has. The fixed speed is one the game
plays its match at pace on.
Try it yourself
Add the server to your client and open it in your copy of the game. Each of these is a step of the demo, in the order the demo makes them.
Start Speed Fight from the start profile in its .scry/start/ folder.
start(shared=true, background=true, display="<host>", profile="<host>",
flags=["-set", "cpu core=normal", "-set", "cpu cycles=fixed 300000"], captures_dir="<host>",
cwd="<host>"){
"status": "ok",
"kept": "1 saved for `promote`"
}A start profile is a saved set of start arguments: the call adds only what is this run's own. kept says a candidate was saved for promote; the whole reply lists what the file filled in profile.supplied.
The whole reply
{
"summary": "<volatile>",
"status": "ok",
"pid": "<volatile>",
"conf": "<volatile>",
"conf_digest": "<volatile>",
"watched": true,
"bound_s": 900,
"elapsed_s": "<volatile>",
"captures": "off",
"state_dir": "<volatile>",
"shared": true,
"ready_after_s": "<volatile>",
"argv": "<volatile>",
"binary": "<volatile>",
"binary_origin": "<volatile>",
"version": "<volatile>",
"debugger_commands": ["A20", "BPIF", "CAPTURE", "DOSTRACE", "LOADSTATE", "MEMDUMPLIN", "PIC", "PORTINFO", "PRESENCE", "RUNSTATE", "SAVESTATE", "STEPIN", "TAP", "VGAMEMDUMP"],
"stub": "./src/scry_dosbox_x/guest/SCRY.COM",
"input_port": "<volatile>",
"background": true,
"presence": true,
"window": "<volatile>",
"logfile": "<volatile>",
"declarations": {
"rearm": {"rearmed": [], "stale": [], "unresolved": [], "ambiguous": [], "unarmable": []}
},
"symbols": {
"held": "<volatile>",
"base_from": "program",
"checked": {
"available": false,
"why": "the table carries no symbol kinds (a link map lists none), so its code symbols cannot be told from the rest"
}
},
"kept": "1 saved for `promote`",
"profile": {
"name": "<volatile>",
"file": "<volatile>",
"supplied": ["conf", "logfile", "program", "session_seconds", "symbols"]
},
"session": {"alive": true, "running": false, "altered": false}
}Run the game to titulo_dibuja_cred, counting draw_block on the way.
run_to(ref="titulo_dibuja_cred", control="draw_block", seconds=120){
"summary": "run_to titulo_dibuja_cred: TARGET at 0951:00000819, control counted 35",
"verdict": "TARGET",
"control_hits": 35
}TARGET means the run stopped where the title calls its credits line, once both planes are drawn. control_hits counts a routine that ran many times meanwhile.
The whole reply
{
"summary": "run_to titulo_dibuja_cred: TARGET at 0951:00000819, control counted 35",
"status": "ok",
"verdict": "TARGET",
"target": "08EB:0E79",
"ref": "titulo_dibuja_cred",
"pc": "0951:00000819",
"cpu_mode": "real",
"target_disarmed": true,
"control_hits": 35,
"controls": [
{"ref": "draw_block", "at": "08EB:46F4", "hits_in_run": 35, "removed": true}
],
"frame": 78,
"regs": {
"EAX": "0x0000491e",
"EBX": "0x00007fff",
"ECX": "0x005b0000",
"EDX": "0x00000089",
"ESI": "0x0000c7cb",
"EDI": "0x0000bfcb",
"EBP": "0x0000b1aa",
"ESP": "0x0000b19e",
"EIP": "0x00000819",
"CS": "0x0951",
"DS": "0x1b73",
"ES": "0x491e",
"FS": "0x0008",
"GS": "0x0000",
"SS": "0x1b73"
},
"watches": [],
"cause": "run_to's target titulo_dibuja_cred at 0951:00000819",
"e9": {"lines_total": 0, "truncated": false, "lines": [], "mark": "<volatile>"},
"stop_seq": 3,
"instruction": {
"address": "0951:00000819",
"bytes": "52",
"text": "push dx",
"flow": "sequential",
"code_bits": 16,
"bytes_from": "memory",
"symbol": "titulo_dibuja_cred",
"delta": 0
},
"session": {"alive": true, "running": false, "altered": false}
}Read the game's creditos variable.
read_memory(ref="creditos", length=2){
"summary": "read_memory creditos: 2 bytes at 26AB:00000006: 0000",
"hex": "0000"
}creditos is a name from the game's symbol map, resolved at the segment DOS loaded the program at. The arcade build's map gives the same name.
The whole reply
{
"summary": "read_memory creditos: 2 bytes at 26AB:00000006: 0000",
"status": "ok",
"ref": "creditos",
"seg_off": "26AB:00000006",
"length": 2,
"hex": "0000",
"session": {"alive": true, "running": false, "altered": false}
}The whole demo as one prompt
- Start DOSBox-X from the start profile
.scry/start/dos.jsonof the copy, with a window, on the normal core and a fixed speed. - Put a breakpoint on the game's first VESA call,
INT 10h AH=4Fh, let it run there and clear it. - Run to
titulo_dibuja_credcountingdraw_block, and readcreditos. - Run to
startdemo, where the game starts a match by itself, countingnew_irq_video. - Record 380 frames of video, take a picture of the screen and close.
Tools this demo uses
| Group | Tools |
|---|---|
| Session | start, close |
| Breakpoints | breakpoint_interrupt, declaration_clear |
| Run | resume, run_to |
| Read | read_memory |
| Captures | record |
| Screen | screen_view |
Each group is a page of the reference. Some of the names need a word:
- Run: the tools that let the program run and stop it again.
- Breakpoints: breakpoints and watches.
The transcript
TRANSCRIPT.md has every call of the run with its reply. The paths of your
copy read <host> there, because they are your computer's.
More demos
Monkey IslandThe Secret of Monkey Island, with the lookout's lines written into the game's memory while it is stopped; it needs the disc.DOSBox-X
LineUpThe arcade LineUp, from the game's own ROM set, played by its own routine and variable names.DOSBox-X · MAME
BricksA breakout game this repository builds, stopped by name where each brick falls.DOSBox-X
MinesweeperA Minesweeper this repository builds, its mines read out of memory and the board cleared without a miss.DOSBox-X
Deluxe PaintDeluxe Paint II paints a sunset, and a scan finds the byte that holds its colour; it needs the program.DOSBox-X
Deluxe Paint by its menusDeluxe Paint II driven through its menus and a dialog, each picked by name; it needs the program.DOSBox-X
ReChip!ReChip!, a tracker driven by its keys and read by its own log; it needs a copy of the program.DOSBox-X
X-COM ApocalypseX-COM Apocalypse, led through its menus by its own DOS calls and a screen map, every file it opens listed; it needs a copy of the game.DOSBox-X