App:ZAPPY

ZAPPY

320px ZAPPY, editing Kakariko's waterbox
Developer(s)	spinout
Written in	Python
Operating system	Cross platform
Available in	English
Type	CLI 3D map editor
License	Open Source
Website	spinout's site.
Applicable game(s)	Any Z64 game with a known scene table.

ZAPPY is a cross platform scene and map editor. It can edit Link start positions/variables, transition actors' positions/variables, actor positions/variables, objects loaded, and waterbox position/sizes, for all object sets. Initially written by spinout in a day, later refined by him within the following few weeks. It relies on vpython v3 (apt-get install python-visual) for 3D rendering, and works with python 2.x versions.

Usage

The program is invoked through command line arguments, and is then controlled through the keyboard and mouse in a viewing window which shows the area being modified.

Prequisites

Reccomended for windows users: Get both Python2.5 and VPython 3 from this page.

Python2.x

VPython 3

Usage

python zappy.py <ROM> <SCENE> <MAP> [OBJECT SET (optional)]

Note 1: Scene, map, and object set values are assumed to be decimal unless prefixed with "0x"

Note 2: Some windows users may have to use "C:/Python25/Python.exe" instead of "python"

Example

python zappy.py /home/spinout/ZELOOTMA.z64 109 0

Controls

1. F1 - F5 change what you are editing

   F1

   Transition actors

   F2

   Link actors

   F3

   Map actors

   F4

   Objects

   F5

   Waterboxes

2. When editing actors or waterboxes, you control their positions with:

   i/k

   X axis

   y/h

   Y axis

   j/l

   Z axis

3. When editing actors, change their rotations with:

   r/f

   X axis

   e/t

   Y axis

   d/g

   Z axis

4. When editing actor or objects, change their values with:

   [

   decrement

   ]

   increment

   Don't hold these down, or you could crash zappy

5. When editing actors, change their variables with:

   <

   decrement

   >

   increment

   Don't hold these down, or you could crash zappy

6. When editing waterboxes, change their size with:

   [/]

   X size

   </>

   Z size

7. Saving:

   ctrl+s

8. Reset Position of current water box or actor : a
9. Camera Rotation: right click+drag
10. Camera Movement:

    w

    forward

    s

    backwards

11. When editing anything, you can change the instance of what you are editing with:

    +/=

    next (unless you are at the last)

    -

    previous (unless you are at the first)

    Don't hold these down, or you could crash zappy

12. To change the increment amount, press Tab. Don't hold this button down either.

SAVE OFTEN!!
To have it work with other game versions, edit the settings in "zappy_settings". You can also change the background color in that file. Comments are allowed, everything on a line after a '#' is a comment.