ZAPPY

From z64 wiki
Jump to: navigation, search
ZAPPY
Zappy waterbox manipulation.png
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.