This is a basic map editor for map files created for "Adventures on Planet Zephulor"

This program is released under the GNU General Public License. Please see "COPYING.txt" which should have come with this package for details.

-----------------
General Controls:

ESC = quit
F1 = save map
F5 = load map
1 = Set tile type to "Erase"
2 = Set tile type to "Invisible"
3 = Set tile type to "End of level"
4 = Set tile type to "NPC Block" ( A block that's invisible to the player, but affects the npc like a normal tile.
UP = Scroll tile/char menu up
DOWN = Scroll tile/char menu Down
LEFT = Switch between tile and char menu
RIGHT = Switch between tile and char menu
SPACE = Change currently selected tiles to whatever tiles are currently selected for insert. If erase, will erase all. If you hold down shift while selecting tiles from the tile menu, you will see the "Menu items selected" number increase in the bottom menu. When pressing the space bar to insert, tiles are randomly assigned from the pool of selected.

-----------
Tile flags:

P = Sets all currently selected tiles to passable
L = Sets all currently selected tiles to passable on the left side
T = Sets all currently selected tiles to passable on the top
R = Sets all currently selected tiles to passable on the right side
B = Sets all currently selected tiles to passable on the bottom
D = Sets all currently selected tiles to damage (Default value of 1)
S = Sets all currently selected tiles to slow (Default value of 1)

NOTE: To alter the tile flags more directly, including the ability to assign higher damage and slow values, click the menu along the bottom, while your tiles are selected. You will be presented with a menu with a field for each item, shown in the same order as above.

A = Copies the currently listed tile flags to all tiles with the same image. Use this function carefully, and only with one tile selected at a time.

----------
The mouse:

Left mouse button = Select tiles from the main window, or from the tile menu along the right. Holding down ctrl selects multiple tiles in the main editor window, shift selects multiple tiles in the tile menu.

NOTES: Hold down Shift while clicking to select all tiles between the last selected tile, and the tile currently being clicked.

Right mouse button = De-select tiles in the main window.

Middle mouse button = Scroll the map, the further away from center, the faster the map scrolls

NOTES: Hold down del while clicking the left mouse button to delete characters from the map.
       The player character must be placed on the map before all other characters.

----------------------------
Adding Monsters and objects:

When adding an object or monster, you must add the object's filename to the
"default.charlist", and you must also add the object's sound entries to the
"entsndlist.data" file. Both files are python pickled files. This means to
edit them you would do something like:

python               
Python 2.3.3 (#1, Feb 19 2004, 03:54:07) 
[GCC 3.3.2 20031218 (Gentoo Linux 3.3.2-r5, propolice-3.3-7)] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import pickle 
>>> f = file("entsndlist.data", "r")
>>> mylist1 = pickle.load(f)
>>> mylist2 = pickle.load(f)
>>> mylist3 = pickle.load(f)
>>> mylist4 = pickle.load(f)
>>> mylist5 = pickle.load(f)
>>> f.close()
>>> mylist1
4
>>> mylist1 = 5
>>> mylist2
['char1', ('char-bang.wav', 'char-ow.wav', None, 'char-die.wav')]
>>> mylist3
['blob', (None, 'blob-grubub.wav', None, 'blob-die.wav')]
>>> mylist4
['rockmonster', (None, 'rock-ow.wav', None, 'rock-die.wav')]
>>> mylist5
['powerup', (None, None, None, 'powerup.wav')]
>>> mylist6 = ['water', (None, None, None, None)]
>>> f = file("entsndlist.data", 'w')
>>> pickle.dump(mylist1, f)
>>> pickle.dump(mylist2, f)
>>> pickle.dump(mylist3, f)
>>> pickle.dump(mylist4, f)
>>> pickle.dump(mylist5, f)
>>> pickle.dump(mylist6, f)
>>> f.close()


-----------------
Additional Notes:

When inserting an "End LVL" tile, you will be prompted with a pop-up box for the name of the next map to load.

To allow the player to jump up "through" platforms, but still land on them, set the top, left, and right sides to passable. The same is true of walls, you must set the top and bottom of wall tiles to passable to prevent the player from "standing" on the edges of tiles in the center of a wall.

License:
------------------------------

All data files related to "Adventures on Planet Zephulor" 
including data file editors, scripts and data files are released under 
the GNU General Public License. Please see "COPYING.txt" for details.

All artwork and sound licensed under the GPL. Please see "COPYING.txt" for
details.

------------------------------
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
