Skip to content

doors.md

Latest commit

 

History

History
83 lines (62 loc) · 2.63 KB

doors.md

File metadata and controls

83 lines (62 loc) · 2.63 KB

Door Setup

Bundled JS TradeWars-Like Door

Synchronet ships a JavaScript door named tw2. It is not the original TW2002 DOS binary, but it is useful for proving that agents can discover and drive a door game through the terminal server.

docker compose up -d
make install-js-tw2

Barren Realms Elite

  1. Put the extracted BRE files in doors/bre.

  2. Run make stage-dos-doors.

  3. Start the DOSEMU-capable container with make up-dos.

  4. Install the external-program config:

    docker compose exec bbs jsexec install-xtrn.js ../xtrn/bre -auto

  5. In scfg, inspect the generated program and set/confirm:

    Name: Barren Realms Elite
Internal Code: BRE
Start-up Directory: ../xtrn/bre
Command Line: bre.exe
Multiple Concurrent Users: No or door-managed
I/O Method: DOSEMU / socket depending on Synchronet version
Native Executable/Script: No
BBS Drop File Type: Solar Realms DOORFILE.SR

BRE is not truly simultaneous multi-node gameplay in the same way as TW2002. For experiments, serialize BRE sessions unless you have verified the specific version you run handles lock contention cleanly.

TradeWars 2002

  1. Put the extracted TW2002 files in doors/tw2002.

  2. Run make stage-dos-doors.

  3. Start the DOSEMU-capable container with make up-dos.

  4. Install the external-program config:

    docker compose exec bbs jsexec install-xtrn.js ../xtrn/tw2002 -auto

  5. In scfg, inspect the generated program and set/confirm:

    Name: TradeWars 2002
Internal Code: TW2002
Start-up Directory: ../xtrn/tw2002
Command Line: tw2002.exe TWNODE=%N NOXMS NOEMS BUFFER=16500 MULTITASK=YES
Multiple Concurrent Users: Yes
I/O Method: DOSEMU / socket depending on Synchronet version
Native Executable/Script: No
BBS Drop File Type: GAP DOOR.SYS

  6. Run TW2002's TEDIT.EXE inside the DOS environment and configure each node's dropfile path. Use DOS paths as seen by DOSEMU, not Linux host paths.

The DOSEMU config in this repo uses memory settings commonly needed by TW2002: 640K conventional memory, 4096K XMS, 4096K EMS, and DPMI enabled.

Registration And Licensing

This repo does not ship BRE, TW2002, registration files, cracks, or archives. Drop your own legally usable distributions into doors/ and keep them out of git. The .gitignore is set up to enforce that by default.

Fallback: Remote TWGS/RLogin

If local DOS execution is unstable, configure a Synchronet internet gateway door to an rlogin/TWGS server. That is less reproducible than local execution but useful for testing the agent driver against a working TradeWars endpoint.