Editing Quetzal file format

{{Infobox file format
| name                   = Quetzal
| logo                   = 
| icon                   = 
| iconcaption            = 
| screenshot             = 
| caption                = 
| _noextcode             = on
| extension              = {{mono|.sav}}, {{mono|.glksave}}
| _nomimecode            = on
| mime                   = {{mono|application/x-glksave}}
| type code              = 
| uniform type           = 
| conforms to            = 
| magic                  = {{mono|IFZS}}
| developer              = Martin Frost
| released               = <!-- {{Start date and age|YYYY|mm|dd|df=yes/no}} -->
| latest release version = 1.4
| latest release date    = {{Start date and age|1997|11|13}}
| genre                  = [[Z-machine]] save game
| container for          = [[Z-machine]] state
| contained by           = 
| extended from          = [[Interchange File Format]]
| extended to            = 
| standard               = [http://inform-fiction.org/zmachine/standards/quetzal/ inform-fiction.org]
| open                   = Yes
| url                    = 
}}

'''Quetzal''' is a standardised file format for the saved state of [[Z-machine]] games, invented by [[Martin Frost (Programmer)|Martin Frost]]. Prior to the introduction of Quetzal, each Z-machine interpreter saved games in its own format; Quetzal enabled players to save a game using one interpreter and restore it with another. Use of the format is strongly recommended in [[Graham Nelson]]'s Z-machine standards document, but not obligatory. Most modern Z-machine interpreters have the ability to save Quetzal files.

The files are [[Interchange File Format|IFF]] files with a FORM of "IFZS" (presumably standing for "[[Interactive Fiction]] Z-machine Save"), although the saved files are commonly given an extension of ".sav": less commonly sighted are "quz" and "qtz". Despite the reference to the Z-machine in the FORM code, the format has proved flexible enough to be adapted for at least one alternative architecture, [[Glulx]].

The magic-number reading of the files are often shown as:

<pre>'IFF data, Z-machine or Glulx saved game file (Quetzal)'</pre>

A [[backronym]] for the format is "'''Q'''uetzal '''U'''nifies '''E'''fficiently '''T'''he '''Z'''-Machine '''A'''rchive '''L'''anguage".

Version 1.3b, which was widely available, contained a bug later corrected in version 1.4: after a save instruction, the Z-machine requires that a success code is saved in a particular place (which differs depending on the version). Versions of the Quetzal standard before 1.4 have reference only to the instruction ''after'' the save, which complicates finding the correct place to put the success code.

==External links==
* [http://inform-fiction.org/zmachine/standards/quetzal/ Version 1.4 of the specification]
* [http://www.eblong.com/zarf/glulx/glulx-spec_1.html#s.8 Quetzal as applied to Glulx]

[[Category:Computer file formats]]