|
|
|
[[_TOC_]]
|
|
|
|
|
|
|
|
# Tools
|
|
|
|
|
|
|
|
* To **compile** ZIL code into playable Z-machine story files:
|
|
|
|
|
|
|
|
- [Download ZILF 0.9](/Releases/0.9/Downloads)
|
|
|
|
- Or, build the newest ZILF from [source code](https://foss.heptapod.net/zilf/zilf) with the [.NET Core 2.2 SDK](https://dotnet.microsoft.com/download/dotnet-core/2.2)
|
|
|
|
|
|
|
|
* To **edit and debug** ZIL code:
|
|
|
|
|
|
|
|
- [Visual Studio Code](https://code.visualstudio.com/)
|
|
|
|
- The [zil-language extension](https://marketplace.visualstudio.com/items?itemName=zilf.zil-language) for VS Code
|
|
|
|
|
|
|
|
* To **run** compiled Z-machine story files:
|
|
|
|
|
|
|
|
- [Gargoyle](http://ccxvii.net/gargoyle/)
|
|
|
|
- [Windows Frotz](http://www.davidkinder.co.uk/frotz.html)
|
|
|
|
- [Frotz](https://davidgriffith.gitlab.io/frotz/)
|
|
|
|
- ...or [many others](http://www.ifwiki.org/index.php/List_of_Z-machine_interpreters)
|
|
|
|
|
|
|
|
* To get **help**:
|
|
|
|
|
|
|
|
- [Zork Implementation Language group](https://www.facebook.com/groups/ZILcom/) on Facebook
|
|
|
|
- [ZILF Discord](https://discord.gg/eR98YMN)
|
|
|
|
- [ZILF subreddit](https://www.reddit.com/r/ZILF/)
|
|
|
|
- [IntFiction.org](https://www.intfiction.org/)
|
|
|
|
|
|
|
|
* To **report a bug** in ZILF:
|
|
|
|
|
|
|
|
- [JIRA](https://vaporware.atlassian.net/projects/ZILF/issues)
|
|
|
|
|
|
|
|
# Documentation
|
|
|
|
|
|
|
|
* [Learning ZIL, or Everything You Always Wanted To Know About Writing Interactive Fiction...](https://archive.org/details/Learning_ZIL_Steven_Eric_Meretzky_1995)
|
|
|
|
* [ZIL Course](uploads/4016b870defd77716e4ab766e20989b4/ZILCourse.pdf) by Marc Blank
|
|
|
|
* [The MDL Programming Language](https://mdl-language.readthedocs.io/en/latest/) by Stu Galley and Greg Pfister
|
|
|
|
* [The Z-Machine Standards Document](http://www.inform-fiction.org/zmachine/standards/z1point1/index.html)
|
|
|
|
* [ZIP: Z-language Interpreter Program]() by Joel Berez, Marc Blank, and David Lebling
|
|
|
|
|
|
|
|
## Test Suite
|
|
|
|
|
|
|
|
* [ZILF library tests](https://foss.heptapod.net/zilf/zilf/-/tree/branch/default/zillib/tests)
|
|
|
|
- Demonstrates the use of features from ZILF's parser and world library.
|
|
|
|
* [ZILF integration tests](https://foss.heptapod.net/zilf/zilf/-/tree/branch/default/test/Zilf.Tests.Integration)
|
|
|
|
- Demonstrates the use of features in MDL and ZIL, as implemented by ZILF.
|
|
|
|
|
|
|
|
# Examples
|
|
|
|
|
|
|
|
* [Empty game template](https://drive.google.com/file/d/1FPwwQUla5ceI4TIVWAuaOThL_0S6eAOP/view?fbclid=IwAR35RaLbnfNv-u_9bC0SILvlv6K8vdSr1Hgd-HheI8dLw0lIiWQjl-N906s) by Adam Sommerfield
|
|
|
|
* [Adventure (Colossal Cave)](https://foss.heptapod.net/zilf/zilf/-/tree/branch/default/sample/advent) ported by Jesse McGrew
|
|
|
|
* [Cloak of Darkness](https://github.com/learning-zil/Cloak-of-Darkness/archive/master.zip) ported by Alex Proudfoot
|
|
|
|
* [The Bean Stalker](https://github.com/dhakajack/bean) by Jack Welch
|
|
|
|
* [Tenliner Cave Adventure](/Tenliner Cave Adventure, ZIL edition) posted by jcompton
|
|
|
|
|
|
|
|
## Classic Game Source Code
|
|
|
|
|
|
|
|
* [Unmodified source code for Infocom's games](https://github.com/historicalsource?tab=repositories) as uploaded by Jason Scott
|
|
|
|
* [ZIL source code for Infocom's games](https://github.com/the-infocom-files), cleaned up and patched so it compiles under ZILF (release 1)
|
|
|
|
* [The Obsessively Complete Infocom Catalog](https://eblong.com/infocom/), including source code curated by Andrew Plotkin
|
|
|
|
|
|
|
|
## Classic Game Known Bugs
|
|
|
|
|
|
|
|
* [The Infocom Bugs List](http://graeme.50webs.com/infobugs/index.htm) by Graeme Cree
|
|
|
|
* [More bugs in Infocom games](http://www.microheaven.com/InfocomBugs/) by Nathan Simpson
|
|
|
|
|
|
|
|
# Articles
|
|
|
|
|
|
|
|
* [Long Lost ‘Zork’ Source Code Uploaded to GitHub, But Few People Understand It](https://motherboard.vice.com/en_us/article/a3xdk8/long-lost-zork-source-code-uploaded-to-github-but-few-people-understand-it) (April 18, 2019)
|
|
|
|
* [The History of Zork](https://web.archive.org/web/20090116035446/http://www.csd.uwo.ca/Infocom/Articles/NZT/zorkhist.html)
|
|
|
|
* [A story about the source code for the original mainframe Zork](https://github.com/PDP-10/its/issues/813)
|
|
|
|
|
|
|
|
## ZIL Blogs
|
|
|
|
|
|
|
|
* [Internal Secrets of Infocom Games](http://ifsecrets.blogspot.com) by Michael Ko
|
|
|
|
* [Vaporware IF: posts about ZILF](http://vaporwareif.blogspot.com/search/label/zilf) by Jesse McGrew</li>
|
|
|
|
* [Learning ZIL](https://learning-zil.blogspot.com/) by Alex Proudfoot
|
|
|
|
* [ZIL Crazy After All These Years](http://zilcrazy.blogspot.com/)
|
|
|
|
|
|
|
|
# Videos/Podcasts
|
|
|
|
|
|
|
|
* [Where to Start - Quick Code Guide](https://www.youtube.com/watch?v=VMflK-xjyg0)
|
|
|
|
- How to write and run an ultra-simple (1 room, 1 object) game in ZIL
|
|
|
|
* [Game On! - Infocom text games and ZIL](https://www.twitch.tv/videos/416801231) (1:21:50)
|
|
|
|
- Kevin Savetz interviews Steve Meretzky at GitHub HQ.
|
|
|
|
* [Infocom - Zork Implementation Language](https://www.youtube.com/watch?v=KITo4oW-Ojw) (4:44; April 23, 2019)
|
|
|
|
- A nice quick overview video, featuring an interview with Dave Lebling on Zork, MDL, and ZIL.
|
|
|
|
* [History of the Language](https://www.youtube.com/watch?v=-oPIXEn7xcE) (8:10)
|
|
|
|
- A clip from Get Lamp. (Original interview is [here](https://archive.org/details/getlamp_b).)
|
|
|
|
* [Jason Scott Talks His Way out of It: The Infocom Source Code Episode](https://www.youtube.com/watch?v=XT1kAmQ7nYc) (19:27; April 28, 2019)
|
|
|
|
- Jason Scott talks about releasing the Infocom Source Code on GitHub.
|
|
|
|
- The Specialness of Infocom, The Craft, The Z-Machine, Z-Machine Glories, Full Sentences and Every Platform, GET LAMP, The Infocom .ZIP File, A Release, Stu Galley, GitHub, The Clones and Branches, Steve and Kevin have a chat.
|
|
|
|
|
|
|
|
# Things That Aren't ZIL
|
|
|
|
|
|
|
|
* [Other historical game source code](https://github.com/historicalsource?tab=repositories) uploaded/curated by Jason Scott
|
|
|
|
* [Inform 7](http://inform7.com/) |