Files
tdkpin/tdkpin-rs/README.md
T
ddidderr 91ae8cdfd8 fix(game): restore the original plunger launch
Start each ball at the recovered right-lane coordinates and charge the
plunger while Down is held, firing only on release. Render all eleven frames
of resource 901, preserve object 25 as the returning-ball catch, and use the
object table's center-contact extents without adding the art radius twice.

Test Plan:
- cargo fmt --all -- --check
- cargo test
- cargo clippy --all-targets --all-features -- -D warnings
- runtime smoke: start, hold Down, release, and inspect the right shooter lane
2026-08-22 17:37:28 +02:00

66 lines
2.3 KiB
Markdown

# TDK Pinball Machine for modern PCs
This is a native Rust reconstruction of the 1995 Windows game **TDK Pinball
Machine**. It uses the extracted original artwork and sound, recreates the
playfield as a fixed-step simulation, and runs from the same source on Linux,
macOS, and Windows.
The game opens at 960x690, an exact 1.5x enlargement of its original 640x460
canvas, so modern desktop scaling cannot distort or vertically offset the
pixel-art presentation.
The original program is not required at runtime. All required game assets are
embedded in the executable at build time.
## Run
Install a current stable Rust toolchain, then run:
```sh
cargo run
```
For a distributable optimized binary:
```sh
cargo build --profile production
```
The binary is written below `target/production/`. On Linux, Macroquad's native
development packages are also required (X11, OpenGL, and ALSA). Windows needs
no extra runtime installation; macOS builds with the normal Apple developer
command-line tools.
## Original and modern controls
| Action | Original key | Additional modern key |
| --- | --- | --- |
| Choose 1-4 players | `+` | `=` |
| Start game / charge launcher | Hold Down arrow, release to launch | Enter starts a game |
| Left flipper | Left Ctrl | `A` or Left arrow |
| Right flipper | Keypad Enter | Right Ctrl, `D`, or Right arrow |
| Nudge | Space, either Shift, keypad `3` | - |
| Help | F1 | Enter/Escape returns |
| Settings | F2 | - |
| High scores | F3 | - |
| Sound | F12 | - |
The five original speed choices are retained as simulation-detail settings.
They change fixed-step resolution without changing the speed of play.
The help screen is the original artwork in English, German, French, Italian,
or Spanish. As instructed on that screen, double-clicking its upper-left exit
box closes the program.
## Saved data
Settings and the ten-entry high-score table are stored as `save.json` in the
platform's normal per-user application-data directory. On first run, the table
is imported from the original `HISCORES.DAT` included with this reconstruction.
## Reconstruction status
This repository distinguishes exact recovered material from behavioral
reimplementation. See [RECONSTRUCTION.md](RECONSTRUCTION.md) for the evidence
ledger, known inference boundaries, and validation performed.