Index of /VAX/OpenVMS_7.3/VAXMaster/
| Name | Last Modified | Size | Type |
| ../ | | - | Directory |
| VAXMaster/ | 2026-Nov-10 23:36:26 | - | Directory |
| CSBWIN.EXE | 2026-Nov-10 23:39:25 | 905.5K | application/x-msdos-program |
| README.txt | 2026-Nov-11 22:24:22 | 8.6K | text/plain; charset=utf-8 |
| VAXMaster.zip | 2026-Nov-10 23:39:04 | 1.1M | application/zip |
VAXMaster - Dungeon Master for OpenVMS VAX
===========================================
CSBwin 15.7 ported to OpenVMS 7.3 VAX with pure DECWindows/Xlib.
No SDL dependency.
CSBwin is Paul R. Stevens' re-implementation of the Atari ST
Dungeon Master and Chaos Strikes Back game engines. This port
replaces the SDL platform layer with direct Xlib calls, making
it run natively on any VAX with DECWindows Motif installed.
Tested on MicroVAX 3900 (SIMH) running OpenVMS 7.3 with
DECWindows Motif 1.2-6.
PREREQUISITES
-------------
o OpenVMS 7.3 (or earlier) on VAX hardware or emulator
o DEC C++ V5.6 (CXX) or later
o MMK or MMS build utility
o DECWindows Motif (standard with OpenVMS 7.3)
- SYS$SHARE:DECW$XLIBSHR.EXE
- DECW$INCLUDE: (X11 headers)
o An X11 display server (local DECWindows console, or a
remote X server such as XQuartz, Xming, or VcXsrv)
Not required: SDL, GLib, GTK, or any third-party libraries.
GAME DATA FILES
---------------
You need the original Dungeon Master data files:
DUNGEON.DAT The dungeon definition
GRAPHICS.DAT Tile graphics and sprites
These are included - Arrrrrrrr! maties. These files must be
transferred in BINARY mode (FTP TYPE I) and placed in the same
directory as CSBWIN.EXE, or in a directory specified with the
--directory option.
For Chaos Strikes Back, substitute the CSB data files instead.
BUILDING
--------
Transfer all source files to a VMS directory in TEXT mode
(FTP TYPE A). The data files (*.DAT) must be transferred
separately in BINARY mode.
The recommended build procedure:
$ SET DEFAULT device:[directory] ! where the sources are
$ @CONFIGURE.COM
$ @BUILD.COM
CONFIGURE.COM checks the environment (compiler, build utility,
DECWindows, line endings) and writes BUILD.COM. Alternatively,
if you know MMK is available:
$ MMK/IGNORE=WARNING
/IGNORE=WARNING is required, not cosmetic. The 1990s C++ engine
code generates many warnings under DEC CXX V5.6 that are harmless
but would otherwise stop the build.
A clean build compiles approximately 42 source files and takes
several minutes on a simulated MicroVAX. The MD5C.cpp module
compiles with /NOOPTIMIZE because the VAX optimiser can run for
hours on its unrolled bitwise operations.
The output is CSBWIN.EXE.
RUNNING
-------
First, set up the X11 display. If using a remote X server:
$ SET DISPLAY/CREATE/NODE=your.ip.address/TRANSPORT=TCPIP/SERVER=0
If using the local DECWindows console, the display is already set.
Then run the game:
$ RUN CSBWIN
Or define a foreign command:
$ CSBWIN :== $device:[directory]CSBWIN.EXE
$ CSBWIN
To use game data files from a different directory:
$ CSBWIN "--directory" "DKA0:[GAMES.DM]"
Note the double quotes around the option and its argument -
DCL uppercases unquoted tokens.
The game window is 640x400 pixels (320x200 doubled).
KEYBOARD CONTROLS
-----------------
Arrow keys Move / turn
Mouse Interact with objects and the game interface
Enter Confirm selections
Escape Cancel / back
qweasd Movement keys
m Auto mapper
AUDIO
-----
Sound is not available on this port. VAX VMS 7.3 has no standard
PCM audio output facility.
FILES SPECIFIC TO THIS PORT
---------------------------
These files were created or significantly modified for VAXMaster.
All other .cpp and .h files are the original CSBwin 15.7 engine
sources with only minimal changes for DEC CXX V5.6 compatibility.
CSBvax.cpp Main program, X11 window/event/timer, blitter.
Replaces CSBlinux.cpp.
VAXLinCSBUI.cpp UI callbacks (UI_SetDIBitsToDevice, message boxes,
command-line parsing). Replaces LinCSBUI.cpp.
VAXAudio.cpp Audio stubs (Mix_OpenAudio, Mix_LoadWAV, etc.).
VAXAudio.h Replaces SoundMixer.cpp/SoundMixer.h.
stdafx.h Modified: X11 include ordering, uppercase Xlib
function macros for DECW$XLIBSHR, CursorShape
and NoValue #undef after X11 headers.
csbglib.h GLib replacement providing typedefs (gint8, etc.),
G_BYTE_ORDER, logging functions. Shared with the
Alpha port but with VAX-specific additions:
typedef int bool, #define inline to nothing.
vmsglib.h One-line include of csbglib.h (VMS alias).
CSBTypes.h Modified: i64/ui64 are 32-bit on VAX (no long
long). LE16() made static.
CSB.h Modified: forward struct declarations added before
RESTARTABLE block; struct keyword added to bare
TEXT * parameters; RoomType() made static.
DESCRIP.MMS MMK/MMS build file. Tailored for VAX CXX V5.6.
CSBWIN.OPT Linker options: DECW$XLIBSHR and CXXL$011_SHR.
CONFIGURE.COM Environment probe and BUILD.COM generator.
BUILD.COM Generated by CONFIGURE.COM. Simple MMK wrapper.
TECHNICAL NOTES
---------------
DEC CXX V5.6 Compatibility
This compiler predates the C++98 standard. Key workarounds:
o "inline" is #defined to nothing on VAX. Functions that must
be in headers (logging, LE16) are declared "static" to avoid
DUPGLOBAL errors when the same inline function appears in
multiple translation units.
o "bool" is typedef'd to int, with true=1 and false=0.
o Variadic macros are not supported. Mix_SetError is
implemented as a static function instead.
o The /NAME=(AS_IS,SHORTENED) flag preserves mixed-case
external names. SHORTENED hashes long C++ mangled names
that would otherwise be truncated.
DECWindows / Xlib Symbol Names
DECW$XLIBSHR.EXE exports all public symbols in UPPERCASE
(XOPENDISPLAY, XCREATEWINDOW, etc.). With /NAME=(AS_IS),
the compiler generates mixed-case references (XOpenDisplay)
that the linker cannot resolve. stdafx.h contains #define
macros that map each X11 function name to its uppercase form
BEFORE the X11 headers are included, so both the declarations
and the call sites use the uppercase names.
Rendering Pipeline
The engine renders into a 320x200 four-bit-per-pixel Atari ST
framebuffer. WinScreen.cpp unpacks this into 16-bit RGB565
pixels and scales by screenSize (2) using its BLT functions,
producing a 640x400 bitmap. CSBvax.cpp's VAX_BlitToWindow()
converts each RGB565 pixel to the X visual's format via a
65536-entry lookup table and copies it 1:1 into the XImage.
XPutImage pushes the result to the window.
X11 Macro Conflicts
The X11 headers define macros that collide with CSBwin engine
identifiers:
- CursorShape (X11 extension opcode = 0)
- NoValue (X parsing flag = 0x0000)
Both are #undef'd after the X11 includes in stdafx.h.
Structure Packing
The engine uses #pragma nomember_alignment in several files
to overlay C structures onto the Atari ST's little-endian
disk format. The command-line flags do NOT include
/NOMEMBER_ALIGNMENT - packing is controlled per-file.
64-bit Integers
VAX has no 64-bit integer type. i64 and ui64 are typedef'd
to 32-bit (i32 / ui32). The engine uses these only for
statistics counters and checksums where the truncation is
acceptable.
MD5 Optimisation
md5C.cpp contains heavily unrolled bitwise rotation operations
that cause the VAX code generator to run for hours. It is
compiled with /NOOPTIMIZE. MD5 performance is not critical to
gameplay.
KNOWN ISSUES
------------
o CXXL$THROW_IMMEDIATE appears as an unresolved symbol at link
time. This does not affect runtime because the engine does
not throw C++ exceptions.
o No audio output. Sound effects and music are silently
discarded.
CREDITS
-------
Original Dungeon Master and Chaos Strikes Back
FTL Games (Doug Bell, Andy Jaros, Wayne Holder), 1987-1989
CSBwin engine (re-implementation from Atari ST disassembly)
Paul R. Stevens, 2000-2015
http://dmweb.free.fr/
VAXMaster port (DECWindows/Xlib, VAX CXX V5.6 adaptation)
astr0baby, 2026
The Dungeon Master community at dmweb.free.fr has been
invaluable for documentation, data files, and discussion
of the game's internals.