Add Zork engine integration work

data/z-code/README.md

@@ -0,0 +1,30 @@
+# Z-Code Story Files
+
+Place your Z-machine story files here. The Zork Narrator engine looks for
+`zork1.bin` by default. This can be overridden with the `ZORK_STORY_FILE`
+environment variable.
+
+## Obtaining Zork I
+
+The Zork I story file (`zork1.bin`, also distributed as `ZORK1.DAT` or as a
+`.z3` or `.z5` file) is copyrighted by Infocom / Activision. It is not
+included in this repository.
+
+You can obtain a legal copy via:
+
+- The **Zork Trilogy** on GOG.com or Steam (includes the original data files).
+- The [Internet Archive](https://archive.org/details/Zork_I_The_Great_Underground_Empire_1980_Infocom)
+  hosts a playable version in-browser; the original data files are part of some
+  archived distributions listed under the Infocom catalogue.
+
+Once you have the file, rename it to `zork1.bin` and place it in this folder,
+or set `ZORK_STORY_FILE=./path/to/your/file` in your `.env`.
+
+## Supported Formats
+
+The `ifvms` interpreter accepts:
+- `.z3`, `.z4`, `.z5`, `.z8` — raw Z-machine story files
+- `.zblorb` — Blorb-wrapped story files (may include sound resources)
+- Any file with the correct Z-machine header (the extension is ignored)
+
+Zork I is a Z-machine version 3 (`.z3`) game.