ZART INTERACTIVE FICTION INTERPRETER LIBRARY

This library is a modern multi-platform implementation of the Infocom Z-Machine
and the Glulx Interpreter, combined underneath a single common
API.  Because it is written in Dart, it can be used on any platform that 
Dart runs on:
- Windows
- Web
- MacOS
- Linux
- Android
- IOS

The Zart library exposes an interface called "PlatformProvider", and if you implement 
this interface you can interpret IF games (either Z-Machine or Glulx) in your own application.  
I have provided two examples of this:  The CLI player and the Web player, both of which 
are included in this zip file and can be found on github as well (see links below).

LICENSE
All projects are under the MIT license.

CONTACT AND LINKS
By AteBit (John) (https://github.com/atebitftw)
Email: prujohn@gmail.com

Source Code Locations (also included in this file):
- Zart Library: https://github.com/atebitftw/zart
- Zart CLI Player: https://github.com/atebitftw/zart_cli
- Zart Web Player: https://github.com/atebitftw/zart-player

Zart Library On pub.dev:
- https://pub.dev/packages/zart

Web Player Online:
- https://atebitftw.github.io/site/zart_player/

WHAT IS INCLUDED IN THIS ZIP
- Zart Library Source Code (zart/)
- Zart CLI Player Source Code (zart_cli_player/)
- Zart Web Player Flutter Source Code (zart_web_player)
- Zart CLI Windows Executable zart.exe

HOW TO USE

IF YOU WANT TO JUST PLAY GAMES WITH IT
I recommend that you use the online web player for easiest use (link above).

If you want to try it out the CLI player, then you will need to either use the
included executable (for Windows) or:

install the Dart SDK (see below) and then issue this command in your CLI of choice:

dart pub global activate --source git git@github.com:atebitftw/zart_cli.git

Afte you have it installed, you can play any game file with:

zart <game_file_name> (e.g. "minizork.z3" or "thehours.gblorb")

NOTE: While the latter method should work on MacOS and Linux, I've only tested the CLI player on Windows.


BUILDING YOUR OWN PLAYER ON TOP OF ZART
The best way to do this is to follow the documentation at pub.dev: https://pub.dev/packages/zart

Feel free to reach out to me if you have any questions.  I'm slow with email replies, but
quicker if you open an issue on GitHub: https://github.com/atebitftw/zart/issues