High scores - Revision history

RT-55J: De-stubbified

2025-12-26T03:38:42Z

De-stubbified

← Older revision		Revision as of 03:38, 26 December 2025
Line 1:		Line 1:
	~~{{Stub}}~~		ZZT has the ability to save the '''high scores''' for worlds. The scores are stored in files named <code>[world name].HI</code>.

			If a <code>.HI</code> file exists, the high score list are loaded when a world is initially loaded. The list can be viewed by pressing <code>H</code> on the [[title screen]].

			If the player gets a [[game over]], the player's [[score]] is greater than zero, and the player's score is not less than the 30th place score, then the player is given the chance to input their name. The text "-- You! --" is displayed on the line where the player's score is. If the player's score is tied with another, then the newer score takes precedence on the list.

			If a player opts not to enter a name for their high score, their high score is saved to the file regardless. However, since the high score window only displays scores with a name longer than zero characters the score will be effectively invisible, but it will still count against the 30 score limit. The score can still be seen by inspecting the file with a hex editor.

			High score files have no internal means of verifying they are associated with the correct world, nor any sort of anti-tampering measures.

	== File Format ==		== File Format ==

	~~High scores for a given world are stored in a file named <code>[world name].HI</code>.~~ Each entry in the high score table has the following format:		Each entry in the high score table has the following format:

	{\|class="wikitable"		{\|class="wikitable"
Line 16:		Line 24:
	\|}		\|}

	This format of NameLength, Name, High Score repeats 30 times, from the highest score to the lowest.		This format of NameLength, Name, High Score repeats 30 times, from the highest score to the lowest. A proper high score file should be exactly 1590 bytes in size.

	[[Category:File formats]]		[[Category:File formats]]

RT-55J: Added category.

2025-12-25T10:28:11Z

Added category.

← Older revision		Revision as of 10:28, 25 December 2025
Line 1:		Line 1:
			{{Stub}}

	== File Format ==		== File Format ==

	Each high score ~~entry~~ has the following format.		High scores for a given world are stored in a file named <code>[world name].HI</code>. Each entry in the high score table has the following format:

	{\|class="wikitable"		{\|class="wikitable"
Line 15:		Line 17:

	This format of NameLength, Name, High Score repeats 30 times, from the highest score to the lowest.		This format of NameLength, Name, High Score repeats 30 times, from the highest score to the lowest.

			[[Category:File formats]]

RT-55J: RT-55J moved page Dr. Dos/ZZT High Score Format to High scores

2025-12-25T10:22:58Z

RT-55J moved page Dr. Dos/ZZT High Score Format to High scores

← Older revision	Revision as of 10:22, 25 December 2025
(No difference)

RT-55J: RT-55J moved page User:Dr. Dos/ZZT High Score Format to Dr. Dos/ZZT High Score Format: High scores

2025-12-25T10:22:41Z

RT-55J moved page User:Dr. Dos/ZZT High Score Format to Dr. Dos/ZZT High Score Format: High scores

← Older revision	Revision as of 10:22, 25 December 2025
(No difference)

RT-55J at 10:22, 25 December 2025

2025-12-25T10:22:05Z

← Older revision		Revision as of 10:22, 25 December 2025
Line 1:		Line 1:
	~~Hey sorry if I'm doing this wrong. I touch wiki pages like once a year max~~.		== File Format ==

			Each high score entry has the following format.

	{\|class="wikitable"		{\|class="wikitable"
Line 12:		Line 14:
	\|}		\|}

	This format of NameLength, Name, High Score repeats 30 times.		This format of NameLength, Name, High Score repeats 30 times, from the highest score to the lowest.

RT-55J at 01:53, 24 December 2025

2025-12-24T01:53:02Z

← Older revision		Revision as of 01:53, 24 December 2025
Line 4:		Line 4:
	!Offset!!Hex!!Data type!!Description		!Offset!!Hex!!Data type!!Description
	\|-		\|-
	\|0\|\|0x00\|\|[[~~UNIT8~~]]\|\|<i>NameLength</i><br>Length of the name entered for the high score.		\|0\|\|0x00\|\|[[UINT8]]\|\|<i>NameLength</i><br>Length of the name entered for the high score.
	\|-		\|-
	\|1\|\|0x01\|\|[[char]][50]\|\|<i>Name</i><br>Name associated with the high score. While the format allows 50 characters to be stored, a maximum of 34 characters may be input on the name entry screen. Due to the reserved space when displaying scores, names 37 or more characters will begin to print over the window's border and into the board area. Up to 43 characters will be drawn to the screen this way, with any additional characters remaining completely hidden.		\|1\|\|0x01\|\|[[char]][50]\|\|<i>Name</i><br>Name associated with the high score. While the format allows 50 characters to be stored, a maximum of 34 characters may be input on the name entry screen. Due to the reserved space when displaying scores, names 37 or more characters will begin to print over the window's border and into the board area. Up to 43 characters will be drawn to the screen this way, with any additional characters remaining completely hidden.

Dr. Dos at 18:17, 16 March 2024

2024-03-16T18:17:15Z

← Older revision		Revision as of 18:17, 16 March 2024
Line 4:		Line 4:
	!Offset!!Hex!!Data type!!Description		!Offset!!Hex!!Data type!!Description
	\|-		\|-
	\|0\|\|~~0x0~~\|\|[[UNIT8]]\|\|<i>NameLength</i><br>Length of the name entered for the high score.		\|0\|\|0x00\|\|[[UNIT8]]\|\|<i>NameLength</i><br>Length of the name entered for the high score.
	\|-		\|-
	\|1\|\|0x01\|\|[[char]][50]\|\|<i>Name</i><br>Name associated with the high score		\|1\|\|0x01\|\|[[char]][50]\|\|<i>Name</i><br>Name associated with the high score. While the format allows 50 characters to be stored, a maximum of 34 characters may be input on the name entry screen. Due to the reserved space when displaying scores, names 37 or more characters will begin to print over the window's border and into the board area. Up to 43 characters will be drawn to the screen this way, with any additional characters remaining completely hidden.
	\|-		\|-
	\|4\|\|~~0x004~~\|\|[[INT16LE]]\|\|<i>~~PlayerAmmo~~</i><br>~~Player's ammunition.~~		\|51\|\|0x33\|\|[[INT16LE]]\|\|<i>High Score</i><br>The numeric value of the high score.
	\|-
	~~\|6\|\|0x006\|\|[[INT16LE]]\|\|<i>PlayerGems</i><br>Player's gems.~~
	\|-
	~~\|8\|\|0x008\|\|[[char]][7]\|\|<i>PlayerKeys</i><br>Player's keys. A nonzero~~ value ~~means the player has the specified key. The keys are in this order: Blue, Green, Cyan, Red, Purple, Yellow, White.~~
	\|-
	~~\|15\|\|0x00F\|\|[[INT16LE]]\|\|<i>PlayerHealth</i><br>Player's health.~~
	\|-
	\|17\|\|0x011\|\|[[INT16LE]]\|\|<i>PlayerBoard</i><br>In a world file, this will be the starting board for the player (the title screen, board 0, is always shown first). In a saved game, this will be the board that the ~~player is currently on~~.
	\|-		\|-
	\|}		\|}

			This format of NameLength, Name, High Score repeats 30 times.

Dr. Dos at 18:02, 16 March 2024

2024-03-16T18:02:10Z

← Older revision		Revision as of 18:02, 16 March 2024
Line 1:		Line 1:
	Hey sorry if I'm doing this wrong. I touch wiki pages like once a year max.		Hey sorry if I'm doing this wrong. I touch wiki pages like once a year max.

			{\|class="wikitable"
			!Offset!!Hex!!Data type!!Description
			\|-
			\|0\|\|0x0\|\|[[UNIT8]]\|\|<i>NameLength</i><br>Length of the name entered for the high score.
			\|-
			\|1\|\|0x01\|\|[[char]][50]\|\|<i>Name</i><br>Name associated with the high score
			\|-
			\|4\|\|0x004\|\|[[INT16LE]]\|\|<i>PlayerAmmo</i><br>Player's ammunition.
			\|-
			\|6\|\|0x006\|\|[[INT16LE]]\|\|<i>PlayerGems</i><br>Player's gems.
			\|-
			\|8\|\|0x008\|\|[[char]][7]\|\|<i>PlayerKeys</i><br>Player's keys. A nonzero value means the player has the specified key. The keys are in this order: Blue, Green, Cyan, Red, Purple, Yellow, White.
			\|-
			\|15\|\|0x00F\|\|[[INT16LE]]\|\|<i>PlayerHealth</i><br>Player's health.
			\|-
			\|17\|\|0x011\|\|[[INT16LE]]\|\|<i>PlayerBoard</i><br>In a world file, this will be the starting board for the player (the title screen, board 0, is always shown first). In a saved game, this will be the board that the player is currently on.
			\|-
			\|}

Dr. Dos: Initial page creation

2024-03-16T17:54:10Z

Initial page creation

New page

Hey sorry if I'm doing this wrong. I touch wiki pages like once a year max.