Give - Revision history

Asie at 13:02, 24 December 2025

2025-12-24T13:02:03Z

← Older revision		Revision as of 13:02, 24 December 2025
Line 31:		Line 31:
	The command argument is rarely used with '''#give''', though it is available to use if necessary.		The command argument is rarely used with '''#give''', though it is available to use if necessary.

	== Bugs ~~and~~ Quirks ==		== Bugs/Quirks ==

	* The time counter actually stores the number of seconds ''elapsed'', not the number of seconds ''remaining''; as such, one has to '''#give''' time in order to reduce the amount of time remaining.		* The time counter actually stores the number of seconds ''elapsed'', not the number of seconds ''remaining''; as such, one has to '''#give''' time in order to reduce the amount of time remaining.

Asie at 17:12, 29 September 2022

2022-09-29T17:12:20Z

@@ Line 1: / Line 1: @@
 '''#give''' and '''#take''' are [[ZZT-OOP]] commands for adding and subtracting to counters.
 == Syntax ==
@@ Line 5: / Line 17: @@
 * <code>#give <counter> <amount> [<command>]</code>
 * <code>#take <counter> <amount> [<command>]</code>
 If the '''#give''' or '''#take''' would result in the counter having a value less than 0 or greater than 32767, then the result of the operation is not stored, and the command is executed instead (if present). The command can be any ZZT-OOP command, but is usually the name of a [[Label|label]] to jump to, as in the following example:
@@ Line 33: / Line 33: @@
 == Bugs and Quirks ==
-* The Time counter actually stores the number of seconds ''elapsed'', not the number of seconds ''remaining''; as such, one has to '''#give''' time in order to reduce the amount of time remaining.
+* The time counter actually stores the number of seconds ''elapsed'', not the number of seconds ''remaining''; as such, one has to '''#give''' time in order to reduce the amount of time remaining.
 * The command argument does not need to be prefixed with an '''#'''; for example, '''#take gems 10 put s red key''' is as valid as '''#take gems 10 #put s red key'''.
 * ZZT displays sidebar numbers by adding a certain number of spaces to the value in question (two for ammo, one for other values). As such, a '''#take''' which reduces the value by a very large amount will cause a visual glitch. For example, '''#take health 95''' on '''Health: 100''' will display '''Health: 5 0''', while the true value of player health is equal to 5.

Asie at 17:11, 29 September 2022

2022-09-29T17:11:43Z

← Older revision		Revision as of 17:11, 29 September 2022
Line 1:		Line 1:
	'''#give''' and '''#take''' are [[ZZT-OOP]] commands for adding and subtracting to counters.		'''#give''' and '''#take''' are [[ZZT-OOP]] commands for adding and subtracting to counters.

	~~The syntax for the commands is:~~		== Syntax ==

	* <code>#give <counter> <amount> [<command>]</code>		* <code>#give <counter> <amount> [<command>]</code>
	* <code>#take <counter> <amount> [<command>]</code>		* <code>#take <counter> <amount> [<command>]</code>

			== Available counters ==

	The following counters can be modified with '''#give''' and '''#take''':		The following counters can be modified with '''#give''' and '''#take''':
Line 29:		Line 31:
	The command argument is rarely used with '''#give''', though it is available to use if necessary.		The command argument is rarely used with '''#give''', though it is available to use if necessary.

	==Bugs and Quirks==		== Bugs and Quirks ==

	* The Time counter actually stores the number of seconds ''elapsed'', not the number of seconds ''remaining''; as such, one has to '''#give''' time in order to reduce the amount of time remaining.		* The Time counter actually stores the number of seconds ''elapsed'', not the number of seconds ''remaining''; as such, one has to '''#give''' time in order to reduce the amount of time remaining.

Asie: /* Bugs and Quirks */ fix typo

2021-02-08T08:17:42Z

Bugs and Quirks: fix typo

← Older revision		Revision as of 08:17, 8 February 2021
Line 31:		Line 31:
	==Bugs and Quirks==		==Bugs and Quirks==

	* The Time counter actually ~~stored~~ the number of seconds ''elapsed'', not the number of seconds ''remaining''; as such, one has to '''#give''' time in order to reduce the amount of time remaining.		* The Time counter actually stores the number of seconds ''elapsed'', not the number of seconds ''remaining''; as such, one has to '''#give''' time in order to reduce the amount of time remaining.
	* The command argument does not need to be prefixed with an '''#'''; for example, '''#take gems 10 put s red key''' is as valid as '''#take gems 10 #put s red key'''.		* The command argument does not need to be prefixed with an '''#'''; for example, '''#take gems 10 put s red key''' is as valid as '''#take gems 10 #put s red key'''.
	* ZZT displays sidebar numbers by adding a certain number of spaces to the value in question (two for ammo, one for other values). As such, a '''#take''' which reduces the value by a very large amount will cause a visual glitch. For example, '''#take health 95''' on '''Health: 100''' will display '''Health: 5 0''', while the true value of player health is equal to 5.		* ZZT displays sidebar numbers by adding a certain number of spaces to the value in question (two for ammo, one for other values). As such, a '''#take''' which reduces the value by a very large amount will cause a visual glitch. For example, '''#take health 95''' on '''Health: 100''' will display '''Health: 5 0''', while the true value of player health is equal to 5.

Asie: clarify visual bug, document more things

2021-02-08T08:17:22Z

clarify visual bug, document more things

← Older revision		Revision as of 08:17, 8 February 2021
Line 3:		Line 3:
	The syntax for the commands is:		The syntax for the commands is:

	<code>#give <counter> <amount> [<command>]</code>		* <code>#give <counter> <amount> [<command>]</code>
	<code>#take <counter> <amount> [<command>]</code>		* <code>#take <counter> <amount> [<command>]</code>

	The following counters can be modified with '''#give''' and '''#take''':		The following counters can be modified with '''#give''' and '''#take''':
Line 31:		Line 31:
	==Bugs and Quirks==		==Bugs and Quirks==

	~~[TODO: Verify and explain these]~~		* The Time counter actually stored the number of seconds ''elapsed'', not the number of seconds ''remaining''; as such, one has to '''#give''' time in order to reduce the amount of time remaining.
			* The command argument does not need to be prefixed with an '''#'''; for example, '''#take gems 10 put s red key''' is as valid as '''#take gems 10 #put s red key'''.
	*The ~~time counter~~ is ~~weird~~.		* ZZT displays sidebar numbers by adding a certain number of spaces to the value in question (two for ammo, one for other values). As such, a '''#take''' which reduces the value by a very large amount will cause a visual glitch. For example, '''#take health 95''' on '''Health: 100''' will display '''Health: 5 0''', while the true value of player health is equal to 5.
	*~~Visual glitches can occur when taking sufficiently~~ large values.		** To work around this issue, one should '''#take''' values in smaller quantities.
			* Counters in ZZT are signed 16-bit values, as is the parsed integer; overflows and underflows outside the range '''-32768'''..'''32767''' are not checked for.
			** The Turbo Pascal standard library function for parsing integers from strings, however, operates in 32 bits; this may cause different classes of bugs on 32-bit overflow. (TODO: what bugs?)

	{{ZZT-OOP navbox}}		{{ZZT-OOP navbox}}

RT-55J at 02:15, 8 February 2021

2021-02-08T02:15:37Z

← Older revision		Revision as of 02:15, 8 February 2021
Line 16:		Line 16:
	* Z (''Super ZZT'' only)		* Z (''Super ZZT'' only)

	If the ~~result of the command~~ would result in the counter having a value less than 0 or greater than 32767, then the result of the ~~'''#give''' or '''#take'''~~ operation is not stored, and the command is executed instead (if present). The command can be any ZZT-OOP command, but is usually the name of a [[Label\|label]] to jump to, as in the following example:		If the '''#give''' or '''#take''' would result in the counter having a value less than 0 or greater than 32767, then the result of the operation is not stored, and the command is executed instead (if present). The command can be any ZZT-OOP command, but is usually the name of a [[Label\|label]] to jump to, as in the following example:

	<nowiki>@GemsForHealth		<nowiki>@GemsForHealth

RT-55J at 02:13, 8 February 2021

2021-02-08T02:13:33Z

← Older revision		Revision as of 02:13, 8 February 2021
Line 16:		Line 16:
	* Z (''Super ZZT'' only)		* Z (''Super ZZT'' only)

	If the result of the command would result in the counter having a value less than 0 or greater than 32767, then the result of the '''#give''' or '''#take''' operation is not stored, and the command is executed instead (if present). The command is can be any ZZT-OOP command, but is usually the name of a [[Label\|label]] to jump to as in the following example:		If the result of the command would result in the counter having a value less than 0 or greater than 32767, then the result of the '''#give''' or '''#take''' operation is not stored, and the command is executed instead (if present). The command can be any ZZT-OOP command, but is usually the name of a [[Label\|label]] to jump to, as in the following example:

	<nowiki>@GemsForHealth		<nowiki>@GemsForHealth

RT-55J: fixed the code box

2021-02-08T02:09:51Z

fixed the code box

← Older revision		Revision as of 02:09, 8 February 2021
Line 16:		Line 16:
	* Z (''Super ZZT'' only)		* Z (''Super ZZT'' only)

	If the result of the command would result in the counter having a value less than 0 or greater than 32767, then the result of the '''#give''' or '''#take''' operation is not stored, and the command is executed instead (if present). The command is usually the name of a [[Label\|label]] to jump to~~, but can also be any other ZZT-OOP operation if desired.~~		If the result of the command would result in the counter having a value less than 0 or greater than 32767, then the result of the '''#give''' or '''#take''' operation is not stored, and the command is executed instead (if present). The command is can be any ZZT-OOP command, but is usually the name of a [[Label\|label]] to jump to as in the following example:

	<~~code~~>		<nowiki>@GemsForHealth
	@GemsForHealth~~<br>~~		#end
	#end~~<br>~~		:touch
	:touch~~<br>~~		#take gems 10 tooPoor
	#take gems 10 tooPoor~~<br>~~		#give health 50
	#give health 50~~<br>~~		#end
	#end~~<br>~~		:tooPoor
	:tooPoor~~<br>~~		You're to poor to buy health!</nowiki>
	You're to poor to buy health!
	</~~code~~>

	The command argument is rarely used with '''#give''', though it is available to use		The command argument is rarely used with '''#give''', though it is available to use if necessary.

	== Bugs and Quirks ==		==Bugs and Quirks==

	[TODO: Verify and explain these]		[TODO: Verify and explain these]

	* The time counter is weird.		*The time counter is weird.
	* Visual glitches can occur when taking sufficiently large values.		*Visual glitches can occur when taking sufficiently large values.

	{{ZZT-OOP navbox}}		{{ZZT-OOP navbox}}

RT-55J: Yes, I verified the #give thing [command] thing in ZZT itself and in the source. You really can be :tooRich

2021-02-08T02:05:09Z

Yes, I verified the #give thing [command] thing in ZZT itself and in the source. You really can be :tooRich

New page

'''#give''' and '''#take''' are [[ZZT-OOP]] commands for adding and subtracting to counters.

The syntax for the commands is:

<code>#give <counter> <amount> [<command>]</code>
<code>#take <counter> <amount> [<command>]</code>

The following counters can be modified with '''#give''' and '''#take''':

* Health
* Ammo
* Gems
* Torches (''ZZT'' only)
* Score
* Time
* Z (''Super ZZT'' only)

If the result of the command would result in the counter having a value less than 0 or greater than 32767, then the result of the '''#give''' or '''#take''' operation is not stored, and the command is executed instead (if present). The command is usually the name of a [[Label|label]] to jump to, but can also be any other ZZT-OOP operation if desired.

<code>
@GemsForHealth 
#end 
:touch 
#take gems 10 tooPoor 
#give health 50 
#end 
:tooPoor 
You're to poor to buy health!
</code>

The command argument is rarely used with '''#give''', though it is available to use

== Bugs and Quirks ==

[TODO: Verify and explain these]

* The time counter is weird.
* Visual glitches can occur when taking sufficiently large values.

{{ZZT-OOP navbox}}