Yazzie level editing quick-and-dirty howto
------------------------------------------

1) Download the Tiled map editor for your computer operating system from this
   page: https://www.mapeditor.org

2) Open one of the empty templates: emptyMap1.tmx to emptyMap3.tmx . Each one
   is targeted at the respective theme inside Yazzie.

3) Edit your stage to your liking. Be very careful to not mix tiles from
   different themes in the same map. If you changed your mind, can change to
   another theme later by editting the YAZ metadata.

4) Save your stage using the .json format

5) If you wish to insert the metadata (author, title, theme and song), there
   are two ways:

5.1) Insert the metadata on the json file. This way it will be preserved
   every time you make new changes. For this you must:
   a) Open the mapHeaderToCSV.ods spreadsheet on your favourite spreadsheet app
     (preferably LibreOffice Calc)
   b) Fill in the data the blue colored cells 
   c) Copy the ASCII+1 line cells
   d) Open the .json map with your favourite text editor
   e) Find the tag layers->data
   f) Delete the first 32 numbers of the CSV list
   g) Paste the data you copied from the spreadsheet
   h) Search/replace the TAB character with comma
   i) Adjust the data layout so it is kept with the same layout it had before
      you edited the file

5.2) For experts/developers: Edit the YAZ with an HexEditor
  a) Generate the YAZ file as explained on step-6
  b) Open your favourite Hex editor and fill the fields as described in the
     section "6) For developers, this is the structure of a YAZ user level file"
     of the YAZZIER.TXT file

6) Compile your json map to a binary .YAZ map
  a) Open a bash shell
  b) Rype ./tiledJsonToYazMap.sh -yaz myStage.json 

7) Test your map
  a) Copy the myStage.yaz file to a floppy disk 
  b) To load a stage on the game, press L on the main menu and select your
     level on the file manager that opens.


