From ZCWiki

This article has been transferred from Koopa's ZC Manual, and may need to be updated or wikified.

Contents 1 The Menus 1.1 File Menu 1.2 Quest Menu 1.3 Edit Menu 1.4 Tools Menu 1.5 Data Menu 1.6 Etc. Menu

[edit] The Menus

[edit] File Menu

New 

Opens a new quest with 1 blank map and classic (default) tiles, combos, and palettes, or you can choose a quest template.

Open (F3) 

Used to load existing quests or quests-in-progress into the editor. If a quest is passworded, you must have the password to open the quest.

Save (F2) 

Used to save changes to an already named quest. The unchanged quest will no longer exist.

Save As 

Used to save changes to a quest without eliminating the unchanged version. For instance, is you open one of the example quests to use as the basis of your quest, use Save As so that the example quest will still be there unchanged to use again. With Save As you must give a name and location for your new quest.

Save As 2.10 

Saves in a 2.10-compatible format, discarding newer elements.

Revert 

Undoes all the changes made since the last time you saved the quest.

Quest Templates 

Lets you edit the list of quest templates to use when you create a new quest.

Import 

This is used to import files with the extensions given below to a quest you are working on. Remember that the imported file will replace the one already in the quest, e.g. importing a .zpl file will replace your current palettes with the new palettes.

Export 

Used to make a file (extensions below) of a part of your quest. Exporting does not erase that segment of your quest.

Exit (ESC) 

Closes the ZQ editor and exits to your (D)OS.

[edit] Quest Menu

Maps 

Go to Map 

Select the map that you want to work on here. You can also switch between maps with the (.) and (,) keys.

Map Count 

The number of maps in your quest. To create a new map, increase the count number by one, the maximum is 255.

Misc. Data 

Shop types 

This is used to set up shops for your quest.
When you click on Shop Types, a menu comes up with 15 numbers, Edit, and Cancel. To create a new shop type, click on a number you haven't used yet and Edit.
This brings up a Shop Data dialog box with spaces for three items. Choose an item from the drop-down menu and enter the price for it above that item. You can have a shop with just one item by using only the first item listed, or 2 items by using only the first 2, but don't leave one blank and enter something in the next one.

Info types 

This is for caves where the guy sells information. It works just like Shop Data, set the prices and choose the message strings from the drop-down menu. To create new strings go to Quest->Strings first.

Warp rings 

The Warp Rings are the rooms with 3 staircases that warp you to different parts of your quest. Uses Overworld Room 81.
When you click on Warp Rings, a dialog box will pop up with the numbers 0-7. To create a warp ring, click on a number you haven't used yet and Edit.
This brings up the dialog box for that particular warp ring. Count (3-8) is where you enter how many locations you want for that warp ring. You then edit each site number, entering the Dmap and screen number you want to warp to for each one. Then click OK, or (to test the warp) Go will take you to the screen you just entered.
To use, make a room of type 3-Stair warp and set the ring by pressing A.

Whistle warps 

These are for setting the warps that the whistle takes the player to. Whistle warps become active when you have collected triforce pieces. The number represent the level number and in most cases you enter the Dmap and screen for the entrance to that level. However you can set any location you like.

Triforce pieces 

For changing the placement of the triforce pieces on the default subscreen.

End String 

For making custom end-game messages. First make the string under Strings, then select it here. This string appears whn you meet Zelda at the end of the game.

Subscreens 

Brings up the custom subscreen editor.

Master Subscreen Type 

Select the type of subscreen to use in-game.

Graphics 

Palettes 

Edit the main, level/Dmap, and sprite palettes here.

Sprites 

The sprites used for weapons and for Link. (Enemy sprites are changed in the new enemy editor)

Combos 

Brings up the combo editor.

Tiles 

Starts the tile editor, also used for importing ("ripping") tiles.

Game Icons 

This is where you choose the tile for your game icon (the picture that shows in the ZC Select box when you start or continue a game). Click on the first black square to choose the tile for Link with no rings, the 2nd for Link with the blue ring, the 3rd for Link with the red ring, and 4th for Link with the gold ring. In most cases this is the same tile. The colors will be determined by Extra Sprite Palette 1 Csets 9-12.

Misc. Colors 

The numbers left of the rectangle are Csets of the main palette, the numbers above are the colors in each Csets.. The numbers listed in each item below are 1st digit=Cset and 2nd digit=color in that Cset You can click on one of the color edit boxes, then click on a color in the color table, and it will set that color automatically (no need to find the row and column yourself).

Map Styles 

Used for customizing default-subscreen overworld and dungeon maps(5X3), frame(2X2), triforce pieces to go in frame (1X1), heart container pieces (1X1, enter the first of the set of 5 tiles: empty, 1/4, 1/2, 3/4, and full), and triforce frame(6X3). Draw the item you want to customize in the tile editor first (the numbers in parenthesis show the number of tiles for that item), then select them here. In the new default tileset, some predefined map styles are available.

Door Combo Sets 

Here you can set the graphics for the different type of doors you will use in your quest.

Combo Aliases 

Combo aliases are a way of placing many combos at once, or combos on several layers at once - so you need only place one alias for a tree or an entire house.

Header 

The Header dialog lets you set some information that the player will see/need before they start your quest.

Quest Number 

Custom Quests should use number 0. Other numbers are reserved for built-in quests. Always set this to 0.

Quest Version 

It's a string.

Minimum Version : If a player's saved game was from a version less than the minimum version (using a strcmp) they have to restart from the beginning. This is useful if you make major changes to your quest.

Title and Author 

You get about 60 characters for each.

Change Password 

Use a password to protect your quest. If the quest has a password, it can't be loaded in ZQuest without entering the password.

Note on passwords 

The system used before 2.11 can be, and has been cracked. Don't use your personal password or your forum password for quests. In 2.11 a new hashing system is used. I still recommend you don't use your forum password here.

The developers reserve the right to view all quest info, including your password (pre-2.11). Phantom Menace says: "I won't abuse this power, but you should know that I have access to your quest even if you use a password."

Save Key File check box 

Tick this and when you save the quest, a .key file is created with the same name as the quest file. This file contains the password for the quest (along with some other information). The password is in plain text format! If the .key file is present, and has the correct password (which it always should unless you edit it manually or change the password for the quest elsewhere and bring it over to that computer), then the quest will open in ZQuest without asking you for a password. This way, you don't have to remember to password your quest before sending it out (if you chose that method) and you don't have to worry about remembering the password if you like to keep it passworded all the time. Remember, if the .key file is not present, or doesn't have the right password, ZQuest will ask you for the password. The keyfile also activates the level 4 cheat when your quest is played in ZC.

Rules 

These are the basic settings that apply to your whole quest. Quest rules can be overridden on individual screens by screen flags. See the rules section.

Cheats 

There are four levels of cheats, each with a separate code (a 40 character string) that enables them. You can disable cheats altogether, or disable certain ones by leaving the code empty (be sure there are no spaces). It's helpful to use the cheats when designing a quest. You can also choose to give out the cheat codes. It's up to you.

Level 1 

refill life, bombs, magic, and rupees any time you want.

Level 2 

lets you to set your number of heart containers, your maximum bombs, and make give Link a perpetual clock (enemies are frozen).

Level 3 

allows you to choose what items, equipment, and triforce pieces Link has.

Level 4 

allows Link to walk through walls.

Items 

This is the item editor, where you can edit and create items.

Enemies 

The enemy editor.

Strings 

This is where you create the text strings used by "guys".

To create a new string, highlight [new string] and click on Edit. To change an existing string, highlight it and click Edit.

Message More X 

The horizontal location of the "MISC: More..." indicator. Defaults to just to the right of a completely-filled message block.

Message More Y 

The vertical location of the "MISC: More..." indicator. Defaults to just below a completely-filled message block.

In the edit box, type in your string. It will appear positioned exactly the way you type it in, so use spaces to get it the way you want it.

In the string editor you can choose a "Next String", so that multiple strings can be used on the same screen consecutively.

Dmaps 

Dmaps are a way of dividing up maps into "Dungeon Maps". Dmaps tell the system how to use the screens in the maps. See the Dmap section.

Music, Midis 

This loads MIDI files into your quest. Click on it to bring up the Select MIDI dialog box. Click on a number that has no MIDI file loaded, then Edit.

This brings up the MIDI Specs dialog box. Click on Load to browse for a MIDI file on your hard drive. The one you select will be loaded and take you back to the Specs box. The Time, Length, and Name of the MIDI will be entered in the Specs...you can rename the file if you like.

Volume 

Change the volume of the MIDI file if necessary.

Start 

Start position in MIDI file.

Loop 

Check this box if you want the MIDI to loop instead of playing through once and stopping.

Loop Start 

Starting point in looping MIDI.

Loop End 

Ending point in looping MIDI.

Music, Enhanced Music 

Lets you load other music formats for your quests.

Init Data 

This is where you enter the items Link will already have when he starts the quest. Most of it is self-explanatory. The defaults already entered are what Link will have unless you make changes.

Equipment 

All items Link can use during his adventure (swords, items, keys, ...)

Items 

What potions, bombs and arrows Link starts out with.

Level items 

For each level (0-255) you can set whether the map (M), compass (C), and boss key (B) are present, and how many level-specific keys (K) Link starts with.

Misc. 

Starting Dmap 

The Dmap you want the quest to start on.

Heart Containers 

How many heart containers Link starts with.

Starting HP (hearts) 

How many of Link's hearts are full.

Continue HP 

Enter the number of full heart containers you want Link to continue with after he dies, or if you want Link to continue with a certain percentage of current hearts full, check the % box and enter the percentage instead of number of heart containers.

Keys and Rupies 

Enter numbers here if you want Link to start with any.

Slash 

Check this box if you want Link to start with the sword slash ability.

HCP (Heart Container Pieces) and Triforces 

Check these boxes for how many of these you want Link to start with (usually none).

Magic Start and Max 

The amount of magic you want Link to start with and the highest amount he can have without getting another magic container.

Double Magic 

Magic required for item use is cut in half.

SFX Data 

Lets you change the built-in SFX (sounds). Any you change are saved in your quest file.

Template 

Lets you set or change the quest template used for the current quest. It won't change your current information, but if you use the Quest->Default menu, it will use whatever quest template you have selected for the default you pick.

Defaults 

Used to reset the chosen item (palettes, tiles, combos, sprites, or map styles) to default, the original classic settings.

[edit] Edit Menu

Undo (U) 

Undoes your last action. Will not undo multiple actions.

Copy (C) 

Copy tile or screen.

Paste (V) 

Paste tile or screen.

Paste All 

Paste all information about the screen you have copied to the new screen, including enemies, screen flags, etc.

Adv. Paste 

Paste to All 

Pastes the copied screen to all screen on the map.

Paste All to All 

Performs the Paste All operation from the copied screen to all screens on the map.

Paste Spec. 

Paste only some of the selection (Undercombo, Secret Combos, Freeform Combos, Screen Data, Warps, Warp return, Enemies, Room Type, Guy/String, Doors, Layers).

Delete (Del) 

deletes the current screen.

Delete Map 

deletes everything on the entire map.

[edit] Tools Menu

Template (F5) 

Applies the Dungeon Template (from room 83) to the current screen. Before clicking Template, choose the floor tile you want for the screen, or you can choose "No Floor".

Or if you hold down the shift key while opening the dialog, the floor tile will stay what it was the last time you opened the dialog (unless that is the first time you opened it, in which case it will use the current combo and Cset). Also you can click on the floor tile and pick another combo and Cset, without having to change your current selections outside of the dialog.

Doors (F6) 

Sets doors on a dungeon Dmap Clicking on this brings up the Select Door box, where you click on which door you are setting: N, S, E, or W, and select the door combo set you want to use. Then you choose the type of door you want: wall (used to get rid of a door you don't want), passage, locked, shutter, bombable, walk-thru, 1-way shutter or boss door.

Color Set Fix (F7) 

Changes the entire screen (or dungeon floor) to the Cset you have selected.

Flags (F8) 

To place a flag on a tile, Click on Tools->Flags (or press F8) to bring up the Flag Type box, choose the flag type and OK, click on the tile where you want the flag, then press the right mouse button to get out of flag-setting mode.

List Combos Used (') 

Shows what combos are used on this screen and its layers.

Preview mode (X) 

Preview the current screen as it will appear in the game. Press PgUp/PgDown to scroll through the available hotkeys, ESC to exit.

Drawing Mode (O) 

Switches between different combo placement modes.

Normal 

Place combos from the combo panel.

Relational 

When set up, allows you to easily draw different types of terrain and the borders between them.

Dungeon Carving 

A quick way to draw dungeon rooms.

Combo Alias 

Lets you place combo aliases instead of combos.

View Palette 

Shows the palette currently being used.

Re-apply Template 

Applies the template (from Room 83) to all screen on a map.

Scripts 

Load scripts from text files for Freeform combos here.

Import ASM FFC script 

Load a ZASM script for a freeform combo.

Import ASM Item script 

Load a ZASM script for an item.

Import ASM global script 

Load a ZASM global script.

Compile Z-Script 

Load, edit, and compile a script in ZC's own Zscript language. Here you also assign scripts to ff combos and events.

Quest Reports 

These summarize information about your quest for you.

Item locations 

lists all room or special items and their positions.

Integrity Check 

Check your quest is set up correctly - this produces a report telling you about potential problems like item rooms with no item, warps to non-existing screens...

[edit] Data Menu

Screen Data (F9) 

Commonly called Screen Flags, these are the settings for an individual screen, they override quest rules or Dmap settings.

Freeform Combos 

Set up freeform combos, that are controlled by scripts.

Tile Warp (F10) 

This is used to set the warp from a cave or stair tile. You can have four warps per screen.

Side Warp (F11) 

Used when you want Link to warp when he leaves one side of a screen. Choose which side activates the warp on triggers. The mechanics of setting the warp are much like tile warp. Again, four side warps per screen, and you may have a tile warp and side warp on the same screen.

Enemy Flags (F12) 

Some more screen-specific settings.

Zora 

Places one Zora on the screen (water required).

Corner Traps 

Places a spiked "trap" in each corner of the room/screen.

Center Traps 

Places 2 traps on the center row of a room.

Falling Rocks 

Will place 3 falling rocks on the screen.

Statues Shoot Fire 

All lstatue, rstatue, and cstatue combos on the screen will shoot fire at Link.

Has Ringleader 

The first enemy on the screen is the "ringleader"; when it dies, they all die.

Enemy Carries Item 

One of the enemies on the screen will "carry" the selected item.

Dungeon Boss 

Used in the "boss" room. When the boss is beaten , the boss sound effects in the dungeon will stop.

Path 

Brings up the Maze Path dialog box. For the path to work, you must also check the "use maze path" screen flag.

Select the 4 directions in the order they should be taken. Only 3 directions can be used...the other direction is entered as the Exit and will take Link back to the screen he entered the maze from. The 4th direction should be the direction of the screen where you want Link to end up. If the maze path is on the extreme left or right screen of a Dmap, you cannot use the direction that would take Link off the map.

Item (I) 

This is for selecting Items that will appear on the screen either when Link enters, when the enemies are dead if that screen flag is checked, or that an enemy will be carrying if that enemy flag is checked. Unless an enemy is carrying the item, to place the item where you want it to appear on the screen press PageDown and click the item icon (far left), then click on the place you want the item to be.

Guy (G) 

Used to place the "guy" of your choice in a cave or dungeon room.

Message String (S) 

Used to select the message string you want the "guy" to be saying. To create a new message string, go to Quest->Strings.

Room Type (R) 

Select the type of this room (see table below)

Special Item 

Takes Link to Screen 80. Set the Special Item. In the OW a guy and message string may be used.

Pay for Info 

A cave or dungeon room that has a guy with info for sale. Set guy and message, then info type number. Create Info Types under Quest->Misc. Data.

Secret Money 

Cave or dungeon room that gives Link money. Enter the amount, and set the guy and message.

Gamble 

Creates a gambling room. Set guy and message.

Door Repair 

Takes money away from Link when he enters. Set guy, message, and repair fee.

Heart Container 

Gives Link his choice of red potion or heart container.

Feed the Goriya 

Link must give the "guy" bait so that he will disappear. Set guy and message. Use in a place where Link must get past the guy in order to continue.

Level 9 Entrance 

Guy that Link cannot get past unless he has the complete triforce. Set guy and message.

Potion Shop 

A shop that Link must have the letter to buy from. Set guy, message, and shop type number. Create shop types under Quest->Misc. Data.

Shop 

A regular shop, no letter required. Set guy, message, and shop type number.

More Bombs 

Increases the number of bombs Link can carry by 4 and gives him the maximum he can carry. Set guy, message, and price.

Leave Money or Life 

Link must give up a heart container or a certain amount of money. Set guy, message, and price. Use in a place where Link must get past the guy in order to continue.

10 Rupies 

Creates a room with 10 rupies set out in a diamond shape.

3-Stair Warp 

Creates a warp ring room using Room 81. Enter Warp Ring number from Quest->Misc. Data.

Ganon 

Makes Ganon the enemy in a dungeon room.

Zelda 

Used to create a Zelda room to trigger the end game sequence.

Item pond 

Not implemented yet.

Magic upgrade 

Makes you use half as much magic per use, effectively doubling your magic. This can only be done once per quest.

Learn Slash 

Link will be able to use the slash ability after visiting this room. Once per quest.

Catch All 

Information for room types that need additional information will appear in this spot if that room type is selected.

Enemies (E) 

Click here or press E to bring up the Enemy dialog box.

Double-click on a (none) space to bring up the enemy list, choose one and click OK to select it. If you want more than one of that enemy on the current screen you can press C to copy, click on a (none) space and press V to paste.

Paste Enemies: If you copy a screen and go to a new screen, paste enemies will put the same enemies that were on the old screen on the new screen.

Flags brings up the Enemy Flag dialog box.

Pattern: If you want the enemies to enter from the sides of the screen, click on pattern and choose this option.

Under Combo 

To set an undercombo, first click on the tile you want for the undercombo, then on Under Combo. In the new dialog box are 2 squares. If the tile in the New square is the one you want for the undercombo, click on Set. Set All makes this tile the undercombo for all screens on this map. Undercombos should be set on every screen that has movable objects on it--Armos, blocks, etc. Under combo stores both the combo and the CSet.

Secret Combos 

Brings up the Secret Combo dialog box.

Burn 

(4 squares) Flags #4, #73, #74, and #75, in that order.

Arrow 

(3) Flags #5, #71, and #72

Bomb 

(2) Flags #6, and #11

Stair 

For the Stair Icon in the lower dialog box.

Boomerang 

(3) Flags #68, #69, and #70

Magic 

(2) Flags #76 and #77

Sword 

(4) Flags #79, #80, #81, and #82

Sword Beam 

(4) Flags #83, #84, #85, and #86

Misc. 

(5) Flags #78 (reflected fireball), #87 (hookshot), #88 (wand), #89 (hammer), and #90 (strike).

Secret Combos 16-31 

These combos appear when other flags are triggered.

To set a secret combo, click on the proper square to bring up the Combo Table, then click on the tile you want for the secret combo and press Enter.

Layers 

You can set up to 6 layers for each screen, that way you can stack combos over each other and over Link. In the layer dialog, enter the map and screen number where you put the tiles for each layer for the current screen. Layers 1 and 2 appear under Link, 3 and 4 are over Link but below flying enemies, 5 and 6 are above flyers. To prepare a screen for any layer except 0, first fill it with the walkable transparent (black) tile so that the layers below will show through.

Note: Anything in layer 0 with a push flag on it appears on top of layers 1 and 2. Link is walking on layers 1 and 2, so he can't very well push something below those layers. This allows you to push a pushblock over different combos without changing them all to the same thing (it is actually still doing this, but set up the real floor on layer 1, then the block won't be erasing it, just layer 0, which is covered up by layer 1).

Transparent makes that layer translucent (see-through).

The auto buttons set up a layer for a whole map. Enter a map number in the dialog that pops up - basically, every screen on that map will be set up as the selected layer screen for every screen on the current map that doesn't already have a layer map set.

Palette (F4) 

This allows you to change a particular screen to any palette in ZQuest. It does not affect the screen in ZC: when playing the quest that screen will still use the palette assigned on the Dmap.

[edit] Etc. Menu

Help 

Brings up the original zquest.txt help file.

About 

Brings up a Box with the version number, etc.

Video Mode 

Shows you the current mode.

Options 

Brings up these options:

Mouse scroll 

Allows you to use the mouse to scroll through the combos on the right.

Save paths 

Makes ZQuest remember what directory you were in when you loaded a quest, saved it, grabbed tiles, imported/exported stuff, etc.

Palette cycle 

Allows you to see palette cycling effects in ZQ.

Vsync 

Makes it so that it waits for the monitor to stop drawing before doing graphics work. This can help eliminate flicker.

Show FPS 

Tells you how many frames there are per second.

Combo Brush 

Makes the cursor the current combo being used.

Float Brush 

In combination with the combo brush, makes the cursor the current combo casting a shadow where it will be placed.

Reload Last 

With this box checked ZQuest will automatically open the last quest you worked on when you start it.

Show Misaligns 

This option helps you avoid having a walkable combo on one screen lead into an unwalkable combo on the next screen.

Animate Combos 

Have this option checked if you want animated combos to be animated in ZQuest. Unchecked, the combos won't appear animated and there is less cursor flickering.

Auto-backup 

With this option checked, every time you save, your quest will also be exported with the same name and a qsb extension.

Overwrite Protection 

You can't save the quest file, you can only do save-as.

Fullscreen 

In the Windows version, toggles between windowed and full-screen modes.

View pic (P) 

With this you can load and view a graphic from inside ZQ.

View map 

Shows the current overall map with your choice of 3 different resolutions. The options allow you to view walkable area, flags used, dark areas, and item placement.

Lost Woods 

Plays the Lost Wood MIDI from Ocarina of Time while you work in ZQuest.

Play Music 

Allows you to choose and play any supported music file on your hard drive through ZQ.

Change track 

changes track in music files that support tracks.

Stop Tunes 

Turns off either of the items above.

Take Snapshot (Z) 

Takes a screenshot of the current screen.