Item Editor

From ZCWiki

The information below describes features introduced in Zelda Classic version 2.50.

The Item Editor is a tool found in ZQuest that allows a quest builder to define his or her own items and modify the existing ones. The editor can be accessed by selecting an item from the item list found under the Quest menu. Only a limited number of items are defined by default; to create a new one, a quest builder can select an unused item slot ("z###") towards the bottom of the list and continue to name it and set its attributes. There is a limit of 256 distinct items per quest.

The options within the editor are explained below.

Contents 1 Data 2 GFX 3 Pickup 4 Action 5 List of Counters 6 See Also

[edit] Data

On this page you set the basic properties of the item.

Name 

Give your item a name. The name of the item appears in the Subscreen's 'Selected Item Name' element whenever this item is selected.

Class 

Select the type of item. Note that the 'z###' classes are reserved for future expansion. Use the 'Custom Itemclass' classes instead, if you intend to use a new item class.

Level 

The level of the item within its class. Generally, the higher the level, the more powerful the item. For instance, the Wooden Sword is level 1, and the White Sword level 2.

Power 

A general value that notes the effectiveness of the item.

Swords, Boomerangs, Arrows, Candles, Wands, Hookshots, Hammers, Din's Fire, Bombs, and Super Bombs: This is how much damage, in 2HP increments, is subtracted from enemies' HP when used. In the case of bombs, candles and super bombs, this is also how much damage, in half-hearts, is done to Link if he is damaged.

Whistles: A power of 0, 1, 2 and 3 makes the whirlwind approach from the south, north, left and right sides of the screen, respectively, while a power of 4 or more makes the whirlwind appear from whatever direction Link is facing. Values greater than 4 are reserved for future expansion and shouldn't be used.

Rings: The amount that damage done to Link is divided by. A power of 2 would cut damage in half, a power of 4 would cut it to a quarter, etc.

Bracelets: The level of push block that it allows Link to move. Currently, there are only two levels of heavy push blocks.

Boots: The level of Damage Combo that it resists. A power of 1 would cause the boots to only protect Link from 1/2 Heart Damage Combos, a power of 2 would also protect Link from 1 Heart Damage Combos, and so on.

Roc Items: The jump height modifier. When Link uses the item, his upward velocity (known in ZScript as Link->Jump) is set to 0.8 times this value.

Spin Attack Scrolls, Hurricane Spin Scrolls, Quake Hammer Scrolls, and Super Quake Scrolls: The attack damage modifier. When the scroll's attack is used, this is the amount by which the original slash or pound would have done. A power of 2 makes the attack inflict double damage, a power of 4 makes it inflict quadruple damage, etc.

Bomb Bags, Quivers, and Wallets: If this value equals 1, then the container can carry an infinite supply of its respective item. Values greater than 1 are reserved for future expansion and shouldn't be used.

Magic Keys: The (minimum) dungeon level that this key works in. The dungeon's level is set via the DMap.

Ladders: In The Legend of Zelda, the ladder can only be used to cross a gap in two directions. If this value equals one, however, Link can move in all four directions while using the ladder. Values greater than 1 are reserved for future expansion and shouldn't be used.

Whisp Rings: The jinx timeout divisor. If the power is 2, then the amount of time that Link remains jinxed by a Bubble is cut in half.

Cane of Byrna: The sparkle damage. In the current version of ZQuest, the Cane of Byrna is not implemented, thus this value is meaningless.

Stones of Agony: The sensitivity of the stone. The less sensitive it is, the closer Link must be to the secret before the stone activates.

Misc. Attributes 1-4 and Misc. Flags 1&2

These are different, customizable options dependent upon the item's class. Infomation about them can be found on the Item Misc. Attributes page.

Equipment Item (checkbox) 

Set this for items Link can hold in his inventory. Note that this cannot be set for Hearts, Arrow Ammo etc.

Defaults 

Pressing this button will reset the item's properties to their original values. It will not reset graphics and the item's name.

[edit] GFX

Here you set the item's appearance. It was the only tab available in older versions and did not include the "If Possible, Use Slash Tiles" option.

Flash CSet 

The CSet that this item flashes to when the "Flash" checkbox is checked. Note that this is dependent upon level palette.

Animation Frames 

The number of frames this item uses to animate. Set to 0 or 1 for no animation.

Animation Speed 

How fast this item animates. Set to 0 for no animation.

Initial Delay 

The amount of time, in frames, that this item "waits" before animating. This cycles endlessly with the rest of the animation.

Link Tile Modification 

The number of tiles that all of Link's tiles shift by when this item is picked up. If this number were set to 20, then all of the Link tiles would reset to 20 right of their original positions in the tile pages. If it were -20, then all Link tiles would shift left 20 tiles. Link Tile Modifications are cumulative.

If Possible, Use Slash Tiles (checkbox)

When checked, the item will use slash tiles (set on the Action tab) if Link has learned slash. Only certain items are affected by this. Affected items include swords and wands in the most current ZQuest version.

Tile Image 

Click here to select a new tile.

Flash (checkbox) 

Turn flashing when Link picks up the item on or off.

2-Hand (checkbox) 

Link uses both hands to lift up this item.

Test 

Brings up a new dialogue that lets the user preview the animation cycle for the item.

[edit] Pickup

This page determines what happens when you pick up this item. ZC has several internal counters for things like Link's hearts, rupees, arrows etc. Which ones are affected can be determined on this page.

Increase Amount 

For items like bombs, rupees or keys this tells you how much you gain. For instance, the 100-rupee item has this set to 100. Set to 0 if you don't use a counter.

Counter Reference 

Which counter this item uses. Set to -1 for none. The counters are listed below.

DCounter (checkbox) 

This is a technicality. Set it according to the "List of Counters" below.

Full Max 

The highest your maximum can get when you collect the item. The only time when you would want this higher than +Max would be with items which you would collect more than once, like Heart Containers. Set to 0 if you don't need to change the maximum. This setting is for items like quivers, wallets or bomb bags which don't change the number of items (arrows) you have, but the maximum you can carry.

+Max 

How much the maximum actually increases. For instance, if this is a wallet and you set Full Max to 500 and +Max to 500, you can carry up to 500 rupees in total. If you instead set this to 50, you can carry 50 more than you could before.

Script 

Run a script when the item is picked up. Note: it runs before everything else (such as counter increments) does. See compiling scripts and assigning scripts (ZScript) for details on how to compile and use scripts with items.

Sound 

which sound slot plays when you pick up this item.

Hearts Required 

refuse pickup if Link doesn't have enough hearts. In The Legend of Zelda, you needed a certain number of hearts to get the White Sword for instance. Leave blank or as 0 to disable.

Keep Lower Level Items 

If Link had previously collected lower-level items of the same class, then the lower-level items are not removed from his inventory when this item is collected.

Gain All Lower Level Items 

When Link collects this item, all lower-level items of the same class are added to his inventory. This means that if this item is destroyed or eaten, Link will revert to the next highest item of the same class.

Can be eaten by Enemies 

If Link is engulfed by a Like Like, this item will be removed from his inventory if he doesn't escape quickly enough.

Upgrade Item when collected twice 

Getting two of this item gives one of the same class but higher level. In The Legend of Zelda, collecting a Blue Potion while already possessing a Blue Potion would cause Link to obtain a Red Potion.

[edit] Action

This page controls what happens when this item is used.

Script 

Notes the number of the script to be run when Link uses the item. If this value is 0, then no script will run. See compiling scripts and assigning scripts (ZScript) for details on how to compile and use scripts with items.

Magic 

Depletes the magic counter by this value whenever the item is used. If Link does not have enough magic, the item will not do anything. If this value is set to 0, then no magic is used by this item.

Sound 

Notes the sound slot that plays when this item is used. If this value is set to 0, then no sound will play. Sound slots can be assigned with the SFX Editor. At the current version of ZQuest, some items' sounds are defined, and others are not.

Remove Item When Used (checkbox) 

When this box is checked, the item is removed from Link's inventory when he uses it. This checkbox is mainly used for potions, keys, rupees, arrows, bombs, and other collectible items.

Uses Rupees Instead of Magic (checkbox) 

When checked, this item deducts an amount of rupees equal to the number set in the "Magic" box.

Weapon 1-4 

The graphics that this item displays when used. At the current version of ZQuest, some items' graphic slots are labeled, and others are not.

[edit] List of Counters

This is a list of the standard counters in ZC. Check the DCounter checkbox (on the Pickup Tab) only for counters marked as such.

0: Life.

1: Rupees. Uses DCounter.

2: Bombs.

3: Arrows.

4: Magic. Uses DCounter.

5: Keys.

6: Super Bombs.

[edit] See Also

• Compiling scripts
• Assigning scripts (ZScript)