Key - Revision history

RT-55J at 15:58, 26 December 2025

2025-12-26T15:58:53Z

← Older revision		Revision as of 15:58, 26 December 2025
Line 13:		Line 13:
	Keys can be placed in any of the default colors recognized by [[ZZT-OOP]], as well as the darker colors enabled by external editors. The foreground color is used to determine what the color of the key is when it is collected. The engine treats the dark colors the same as the default bright colors when collected, with the side effect that a brown key will be treated and addressed as a yellow key when collected.		Keys can be placed in any of the default colors recognized by [[ZZT-OOP]], as well as the darker colors enabled by external editors. The foreground color is used to determine what the color of the key is when it is collected. The engine treats the dark colors the same as the default bright colors when collected, with the side effect that a brown key will be treated and addressed as a yellow key when collected.

	Unlike other items, a key cannot be given directly to the player through ZZT-OOP; an [[object]] must first use [[Put\|#put]], [[Change\|#change]] or [[Become\|#become]] to create a key for the player to collect.		Unlike other items, a key cannot be given directly to the player through ZZT-OOP; an [[object]] must first use [[Put\|#put]], [[Change\|#change]] or [[Become\|#become]] to create a key for the player to collect. Alternatively, a [[duplicator]] may duplicate a key directly onto a [[player]] or player clone to force collection without any player input.

	While keys are pushable, they cannot be pushed by a player since attempting to do so will collect them. However, a player can move them by pushing a [[boulder]] against them, or letting a [[pusher]] shove them.		While keys are pushable, they cannot be pushed by a player since attempting to do so will collect them. However, a player can move them by pushing a [[boulder]] against them, or letting a [[pusher]] shove them.

RT-55J: "Modern worlds"? No that's been a thing since Caves.

2025-12-26T15:57:57Z

"Modern worlds"? No that's been a thing since Caves.

← Older revision		Revision as of 15:57, 26 December 2025
Line 9:		Line 9:
	\|uses zzt-oop color=yes		\|uses zzt-oop color=yes
	}}		}}
	The '''key''' element is one of the built-in puzzle elements of [[ZZT]]. A key can be used to open a [[door]] of the corresponding color; together, they allow a designer to create a simple lock-and-key puzzle. When the [[player]] collects a key, the engine prints "You now have the X key." where X is the key color, adds the key to the "Keys" counter on the HUD, and leaves an identically-colored [[empty]] where the key was. If the player already has a key of a certain color, the game prints "You already have a X key!" where X is the color, and prevents the player from collecting it. ~~A number~~ of ~~modern worlds~~ have exploited this attribute to create puzzles where the player is blocked by multiple keys of the same color and must find enough correctly-colored doors in order to consume each one.		The '''key''' element is one of the built-in puzzle elements of [[ZZT]]. A key can be used to open a [[door]] of the corresponding color; together, they allow a designer to create a simple lock-and-key puzzle. When the [[player]] collects a key, the engine prints "You now have the X key." where X is the key color, adds the key to the "Keys" counter on the HUD, and leaves an identically-colored [[empty]] where the key was. If the player already has a key of a certain color, the game prints "You already have a X key!" where X is the color, and prevents the player from collecting it. Ever since [[Caves of ZZT]], authors have exploited this attribute to create puzzles where the player is blocked by multiple keys of the same color and must find enough correctly-colored doors in order to consume each one.<ref>Sweeney, Tim. (1991) ''Caves of ZZT'', board 34. [https://museumofzzt.com/file/view/zzt/?file=CAVES.ZZT&board=34 Museum of ZZT]</ref>

	Keys can be placed in any of the default colors recognized by [[ZZT-OOP]], as well as the darker colors enabled by external editors. The foreground color is used to determine what the color of the key is when it is collected. The engine treats the dark colors the same as the default bright colors when collected, with the side effect that a brown key will be treated and addressed as a yellow key when collected.		Keys can be placed in any of the default colors recognized by [[ZZT-OOP]], as well as the darker colors enabled by external editors. The foreground color is used to determine what the color of the key is when it is collected. The engine treats the dark colors the same as the default bright colors when collected, with the side effect that a brown key will be treated and addressed as a yellow key when collected.
Line 30:		Line 30:

	Note that attempting to collect a black key while already having 256 or more gems will fail, as the would-be boolean will already be set to <tt>01</tt> (or beyond).		Note that attempting to collect a black key while already having 256 or more gems will fail, as the would-be boolean will already be set to <tt>01</tt> (or beyond).

			== References ==

			<references/>

	[[Category:Elements]]		[[Category:Elements]]
	{{ElementsNavbox}}		{{ElementsNavbox}}

The Green Herring: set to -> increased by

2021-02-10T02:08:48Z

set to -> increased by

← Older revision		Revision as of 02:08, 10 February 2021
Line 27:		Line 27:

	=== Counters ===		=== Counters ===
	The key counter in the world format is defined in GAMEVARS.PAS line 111, under <tt>TWorldInfo</tt>, as a boolean array named <tt>Keys</tt> which ranges from 1 to 7, covering CGA color indexes 1 to 7. Collecting the keys of these colors sets their equivalent boolean to "true", which is indicated internally as <tt>01</tt>; when used, they are set to false, or <tt>00</tt>. When the engine attempts to access the entry of this array for color index 0, the color black, it adds <tt>01</tt> in the byte prior to that of the Blue key, and in doing so goes out of bounds into the second byte of the gems counter, a 16-bit signed integer that thus uses the second byte to indicate units of 256. Because of this, the player's gems counter is ~~set to~~ 256. The bug can be fixed by changing the <tt>Keys</tt> array range from <tt>1..7</tt> to <tt>0..7</tt>, but doing so will also change the world format, making all standard world files incompatible with the engine.		The key counter in the world format is defined in GAMEVARS.PAS line 111, under <tt>TWorldInfo</tt>, as a boolean array named <tt>Keys</tt> which ranges from 1 to 7, covering CGA color indexes 1 to 7. Collecting the keys of these colors sets their equivalent boolean to "true", which is indicated internally as <tt>01</tt>; when used, they are set to false, or <tt>00</tt>. When the engine attempts to access the entry of this array for color index 0, the color black, it adds <tt>01</tt> in the byte prior to that of the Blue key, and in doing so goes out of bounds into the second byte of the gems counter, a 16-bit signed integer that thus uses the second byte to indicate units of 256. Because of this, the player's gems counter is increased by 256. The bug can be fixed by changing the <tt>Keys</tt> array range from <tt>1..7</tt> to <tt>0..7</tt>, but doing so will also change the world format, making all standard world files incompatible with the engine.

	Note that attempting to collect a black key while already having 256 or more gems will fail, as the would-be boolean will already be set to <tt>01</tt> (or beyond).		Note that attempting to collect a black key while already having 256 or more gems will fail, as the would-be boolean will already be set to <tt>01</tt> (or beyond).

The Green Herring: collecting a key leaves an identically-colored empty

2021-02-10T01:50:51Z

collecting a key leaves an identically-colored empty

← Older revision		Revision as of 01:50, 10 February 2021
Line 9:		Line 9:
	\|uses zzt-oop color=yes		\|uses zzt-oop color=yes
	}}		}}
	The '''key''' element is one of the built-in puzzle elements of [[ZZT]]. A key can be used to open a [[door]] of the corresponding color; together, they allow a designer to create a simple lock-and-key puzzle. When the [[player]] collects a key, the engine prints "You now have the X key." where X is the key color, ~~and~~ adds the key to the "Keys" counter on the HUD. If the player already has a key of a certain color, the game prints "You already have a X key!" where X is the color, and prevents the player from collecting it. A number of modern worlds have exploited this attribute to create puzzles where the player is blocked by multiple keys of the same color and must find enough correctly-colored doors in order to consume each one.		The '''key''' element is one of the built-in puzzle elements of [[ZZT]]. A key can be used to open a [[door]] of the corresponding color; together, they allow a designer to create a simple lock-and-key puzzle. When the [[player]] collects a key, the engine prints "You now have the X key." where X is the key color, adds the key to the "Keys" counter on the HUD, and leaves an identically-colored [[empty]] where the key was. If the player already has a key of a certain color, the game prints "You already have a X key!" where X is the color, and prevents the player from collecting it. A number of modern worlds have exploited this attribute to create puzzles where the player is blocked by multiple keys of the same color and must find enough correctly-colored doors in order to consume each one.

	Keys can be placed in any of the default colors recognized by [[ZZT-OOP]], as well as the darker colors enabled by external editors. The foreground color is used to determine what the color of the key is when it is collected. The engine treats the dark colors the same as the default bright colors when collected, with the side effect that a brown key will be treated and addressed as a yellow key when collected.		Keys can be placed in any of the default colors recognized by [[ZZT-OOP]], as well as the darker colors enabled by external editors. The foreground color is used to determine what the color of the key is when it is collected. The engine treats the dark colors the same as the default bright colors when collected, with the side effect that a brown key will be treated and addressed as a yellow key when collected.

The Green Herring: ♀

2021-02-10T01:41:27Z

♀

New page

{{Element
|zzt-oop name=key
|id={{Byte|8}}
|char={{CharSwatch|12}}
|category=item
|stats=no
|destructible=no
|effect on movement=pushable
|uses zzt-oop color=yes
}}
The '''key''' element is one of the built-in puzzle elements of [[ZZT]]. A key can be used to open a [[door]] of the corresponding color; together, they allow a designer to create a simple lock-and-key puzzle. When the [[player]] collects a key, the engine prints "You now have the X key." where X is the key color, and adds the key to the "Keys" counter on the HUD. If the player already has a key of a certain color, the game prints "You already have a X key!" where X is the color, and prevents the player from collecting it. A number of modern worlds have exploited this attribute to create puzzles where the player is blocked by multiple keys of the same color and must find enough correctly-colored doors in order to consume each one.

Keys can be placed in any of the default colors recognized by [[ZZT-OOP]], as well as the darker colors enabled by external editors. The foreground color is used to determine what the color of the key is when it is collected. The engine treats the dark colors the same as the default bright colors when collected, with the side effect that a brown key will be treated and addressed as a yellow key when collected.

Unlike other items, a key cannot be given directly to the player through ZZT-OOP; an [[object]] must first use [[Put|#put]], [[Change|#change]] or [[Become|#become]] to create a key for the player to collect.

While keys are pushable, they cannot be pushed by a player since attempting to do so will collect them. However, a player can move them by pushing a [[boulder]] against them, or letting a [[pusher]] shove them.

== Black keys ==
While keys can be placed in all of the available colors, black keys and dark-grey keys will have glitched behavior when collected:
# The engine will print a garbled mess in place of the key color that includes "Blue", "Green", "Cyan" and "Red";
# The gems counter will be incremented by 256.
Both of these are out-of-bounds errors related to the arrays used for keys, as follows:

=== Color naming ===
The color naming for pickup messages is handled by the <tt>ColorNames</tt> array in GAME.PAS line 92, which has entries for color indexes 1 to 7 of the CGA color palette. This is an array of strings up to eight characters in length. When the engine attempts to access the color name for index 0, the color black, it attempts to access the entry prior to the first entry, <tt>Blue</tt>, and goes out of bounds into where the preceding <tt>ProgressAnimStrings</tt> array exists in memory. It then fails to detect when an entry ends, and prints as much of the succeeding portion of memory as it can fit in a message string after the initial "<tt>You now have the </tt>", producing the glitched message. When editing the engine, the bug can be fixed by changing the array range from <tt>1 .. 7</tt> to <tt>0 .. 7</tt> and adding <tt>'Black',</tt> to the start of the array before <tt>'Blue',</tt>.

=== Counters ===
The key counter in the world format is defined in GAMEVARS.PAS line 111, under <tt>TWorldInfo</tt>, as a boolean array named <tt>Keys</tt> which ranges from 1 to 7, covering CGA color indexes 1 to 7. Collecting the keys of these colors sets their equivalent boolean to "true", which is indicated internally as <tt>01</tt>; when used, they are set to false, or <tt>00</tt>. When the engine attempts to access the entry of this array for color index 0, the color black, it adds <tt>01</tt> in the byte prior to that of the Blue key, and in doing so goes out of bounds into the second byte of the gems counter, a 16-bit signed integer that thus uses the second byte to indicate units of 256. Because of this, the player's gems counter is set to 256. The bug can be fixed by changing the <tt>Keys</tt> array range from <tt>1..7</tt> to <tt>0..7</tt>, but doing so will also change the world format, making all standard world files incompatible with the engine.

Note that attempting to collect a black key while already having 256 or more gems will fail, as the would-be boolean will already be set to <tt>01</tt> (or beyond).

[[Category:Elements]]
{{ElementsNavbox}}