Sign inSign up

vargajoe/vj-poker

By vargajoe

•Updated about 2 months ago

Nostalgic DOS poker: compiler-free original/enhanced runtimes plus a Free Pascal dev image.

Image
Developer tools
0

328

vargajoe/vj-poker repository overview

⁠VJ Poker

VJ Poker is a preserved high-school Pascal poker game that runs in a browser through DOSBox and noVNC. The project provides the original school edition, a completed enhanced edition, and an optional Free Pascal development image.

Source code and complete documentation: https://github.com/VargaJoe/vj-poker⁠

⁠Available images

TagPurpose
v1.0.0Original compiler-free runtime
originalAlias for v1.0.0
v1.1.0Enhanced compiler-free runtime
enhancedAlias for v1.1.0
latestAlias for the stable enhanced runtime
dev-fpc3.2.2Free Pascal 3.2.2 compiler and blue text-mode IDE

All published images currently target linux/amd64.

The runtime images contain only DOSBox/noVNC, the compiled DOS executables, and the required runtime files. They contain no Pascal compiler, IDE, or Pascal source code. Turbo Pascal is not distributed in this public repository.

⁠Quick start

Original edition:

docker run --rm -p 127.0.0.1:8080:8080 vargajoe/vj-poker:v1.0.0

Enhanced edition:

docker run --rm -p 127.0.0.1:8081:8080 vargajoe/vj-poker:v1.1.0

Open one of these URLs:

The versioned tags are recommended for servers. The original, enhanced, and latest aliases are intended for convenient interactive use.

⁠Free Pascal development image

Open the enhanced source in the blue Free Pascal IDE:

docker run --rm -p 127.0.0.1:8082:8080 \
  -e VJ_MODE=ide -e VJ_VARIANT=enhanced \
  vargajoe/vj-poker:dev-fpc3.2.2

Set VJ_VARIANT=original to open the preserved source. Set VJ_MODE=game to compile both the DOS programs and launch the selected game variant using the verified i8086-msdos cross-compiler path.

The Free Pascal IDE itself is a native Linux text-mode program. The canonical game build uses the included ppcross8086 cross-compiler and produces MS-DOS executables that run under DOSBox.

⁠Docker Compose

The source repository contains a server-oriented Compose file. It pins the two runtime versions, binds noVNC to loopback by default, and keeps the FPC editor behind an optional development profile.

git clone https://github.com/VargaJoe/vj-poker.git
cd vj-poker/deploy
cp .env.example .env
docker compose pull original enhanced
docker compose up -d original enhanced

⁠Security

The noVNC session has no built-in password. Keep the published port bound to 127.0.0.1. For remote access, use an SSH tunnel or an authenticated reverse proxy. Do not expose the container port directly to an untrusted network.

⁠Licenses and provenance

The VJ Poker source is available under the MIT License. Runtime and Free Pascal third-party notices are included in their respective images and documented in the source repository. The public FPC image includes the matching compiler/RTL source and license materials. Turbo Pascal 5.5 and 7.0 environments are kept as private, local archival tools and are not published here.

Tag summary

Content type

Image

Digest

sha256:bc58d0ed0…

Size

191.5 MB

Last updated

about 2 months ago

docker pull vargajoe/vj-poker