• src/doors/syncretro/SYNCDOS.md SYNCSCUMM.md SYNCSCUMM_ENGINES.md

    From Rob Swindell (on Debian Linux)@VERT to Git commit to main/sbbs/master on Tue Jul 14 21:04:15 2026
    https://gitlab.synchro.net/main/sbbs/-/commit/d05d801785653f6a9a1572b4
    Added Files:
    src/doors/syncretro/SYNCDOS.md SYNCSCUMM.md SYNCSCUMM_ENGINES.md
    Log Message:
    syncretro: sketch DOS (dosbox_pure) and adventure (ScummVM) consoles

    Three design sketches, docs only -- no code, nothing built. They capture a design conversation about extending SyncRetro's "one binary, many consoles" model to two new content families, and -- more importantly -- the discipline for deciding what belongs where.

    SYNCDOS.md -- a DOS console hosted by the dosbox_pure libretro core. Covers
    the console model (a dir, not a binary; named for the platform, not the emulator), why dosbox_pure over the other libretro DOSBox cores, the
    [autoexec] mechanism for launching a specific executable without the core's start-menu picker, DOS content-shape discovery (a "ROM" is a dir/zip/iso, not
    a cartridge), the mouse/keyboard device bridge the frontend still lacks, a proposed text-mode render tier (read the emulated BIOS Data Area + B800 text buffer via libretro's system-RAM interface and emit terminal text/ANSI, with scroll detection promoting line-oriented output to scrollback), and why DOS SHARE-based multinode multiplayer is not feasible under it.

    A content-fit criterion runs through it: a game is playable over a terminal only if it is BOTH 320x200 (doubles onto SyncTERM's 640x400 canvas) AND latency-tolerant with generous click targets. MOO2 is demoted to the SVGA stress-test case (640x480 -- the hard edge), not the showcase.

    SYNCSCUMM.md + SYNCSCUMM_ENGINES.md -- an adventure console hosted by the ScummVM libretro core, and a curation guide to ScummVM's 100+ engines.
    ScummVM is a reimplementation framework, not an emulator, so it sits a tier above dosbox: one core unlocks the whole 2D-adventure catalog, it reuses the same mouse/keyboard bridge SYNCDOS needs, and -- uniquely -- it ships freeware games (Beneath a Steel Sky et al.), so the console has a legally redistributable showcase that needs nothing from the sysop. The engine guide buckets the catalog by the same fit criterion: 320x200 2D engines fit, SVGA/ FMV/3D engines are curated out.

    The three-tier rule the sketches establish: a native reimplementation door (Vanilla Conquer, Chocolate Duke, 1oom) beats a purpose-fit core (ScummVM) beats dosbox_pure. It is why C&C and Red Alert -- which fit the terminal
    model perfectly -- are NOT dosbox candidates: we already reimplemented them
    as syncconquer / syncalert.

    Core characteristics asserted here (dosbox_pure's memory + device support, scummvm_libretro's content model) are marked throughout as hypotheses to
    verify against the real .so with an M3-style probe before any code is
    written.

    ---
    þ Synchronet þ Vertrauen þ Home of Synchronet þ [vert/cvs/bbs].synchro.net