Native macOS / Windows / Linux runner for the Czech adventure game Zlatý Kalich (2002, enteron.cz).
The original was a Flash 5 projector plus a Delphi helper (player.exe) for MIDI music and saving.
This replaces both: the movie runs in Ruffle, and the helper is reimplemented in Rust.
No game data is included. Point it at your own copy.
cargo run --release -- /path/to/ZlatyKalich.exe # or the folder containing itThe path can be ZlatyKalich.exe, its folder, or the original installer 32-ZKinstall.exe
(unpacked automatically). Without an argument it uses the last location, then the folder next
to the binary, then asks.
- macOS (universal, Apple Silicon + Intel):
./scripts/package-macos.sh→dist/Zlatý Kalich.app+ zip - Linux AppImage:
./scripts/package-linux.sh(on Linux) - Windows / Linux / macOS on CI:
.github/workflows/release.ymlbuilds all three on every push; tagsv*publish a GitHub release.
| Key | |
|---|---|
hold Space |
highlight everything clickable |
Ctrl/Cmd + 1–9 |
choose save slot (title bar shows it) |
Ctrl/Cmd + 0 |
choose the autosave, written when you quit |
Ctrl/Cmd + ↑ / ↓ |
music volume |
F11 / Alt+Enter |
fullscreen (remembered; overrides the in-game option) |
F1 / Ctrl/Cmd + , |
settings window |
| left stick / d-pad | move the pointer |
| A / right trigger | click |
| B / left trigger | right-click |
| X / Y (hold) | highlight everything clickable |
| Start | the game's menu (remote control) |
| Back / Select | settings window |
Open with F1. Stored as settings.toml in the config dir (~/Library/Application Support/zlaty-kalich on macOS):
music_volume = 80
quality = "best" # or "game": honour the in-game LOW/MEDIUM/HIGH
hotspots = "hold-space" # or "always" / "off"
soundfont = "/path/to.sf2" # optional, replaces the bundled GeneralUser GS
slot = 1zlaty-kalich --export-texts texts.tsv [/path/to/game]Fill in the replacement column, save as texts.tsv next to the saves
(data dir, e.g. ~/Library/Application Support/zlaty-kalich). Format is
documented in src/texts.rs. Built-in fixes live in assets/texts.tsv.
Decoded from the binary (Delphi, Unit1.TForm1.FormCreate):
| Invocation from the movie | Original | Here |
|---|---|---|
fscommand("exec", "player.exe") |
closes the running enteron.cz player window → music stops |
Music::stop |
fscommand("exec", "player.exe\tx.mid") |
TMediaPlayer plays the file, Notify rewinds + replays (loop) | rustysynth + GeneralUser GS, looped |
fscommand("exec", "player.exe\t<flags>\t…") |
writes kalich.sav |
save::encode, byte-identical (tested against the shipped file) |
Saves live in the platform data dir as slot1.sav–slot9.sav and autosave.sav;
the original install's kalich.sav becomes slot 1 on first run. The movie's
loadVariables("kalich.sav") is served from the selected slot.
Applied in memory at load; your files are never modified.
- Czech text: Flash 5 text is in the system code page (cp1250 on Czech Windows);
Ruffle assumed cp1252 and turned ř/ě/ů into ø/ì/ù. Vendored
swfcrate takes a legacy code page. - Hover label over dialogue: the game never cleared it when choices opened.
- Typos: "graffitti" → "graffiti".
- Untranslated drawn text: the ending line and the merchant certificate get English versions.
- Host API: an injected clip lets the app trigger the game's own
savegame()(autosave on quit) and hear about language changes (fscommand("zk", …)).
assets/GeneralUser-GS.sf2— GeneralUser GS 2.0.3 SoundFont, see its license file.vendor/swf/— Ruffle'sswfcrate (MIT/Apache) with a settable legacy code page and a text-override hook.assets/icon*— original app icon made for this project.assets/fonts/— Liberation Sans (Arial-metric) and DejaVu Sans (Verdana-like) stand in for the Windows device fonts; licenses alongside.