DEMOLOOP - Revision history

Printz: /* Explanation of fields */

2026-06-14T13:07:47Z

Explanation of fields

← Older revision		Revision as of 09:07, 14 June 2026
Line 36:		Line 36:
	*"data": must contain a single "entries" array of one or more elements (the example above shows two entries). Each element is described below:		*"data": must contain a single "entries" array of one or more elements (the example above shows two entries). Each element is described below:
	:*"type": can be 0 or 1. 0 means art screen, 1 means demo (game replay). Caution: demos will only replay reliably in Eternity if the they are recorded in MBF-compatible or below (Boom or vanilla Doom) ports. Do not rely on Eternity-recorded demos to stay in sync with any Eternity update.		:*"type": can be 0 or 1. 0 means art screen, 1 means demo (game replay). Caution: demos will only replay reliably in Eternity if the they are recorded in MBF-compatible or below (Boom or vanilla Doom) ports. Do not rely on Eternity-recorded demos to stay in sync with any Eternity update.
	:*"primarylump": if "type" is 0 (art screen), this is the name of the graphics lump to display as the art screen~~. Eternity tolerates a missing "primarylump", in which case it will show the Eternity credits screen, but this is nonstandard and not portable~~. If "type" is 1 (demo), this is the name of the demo lump, and it's required.		:*"primarylump": if "type" is 0 (art screen), this is the name of the graphics lump to display as the art screen. If "type" is 1 (demo), this is the name of the demo lump, and it's required.
	:*"outrowipe": can be 0 or 1. 0 means no screen wipe effect (e.g. melt) will occur after the end of the current stage. 1 means to apply the wipe effect.		:*"outrowipe": can be 0 or 1. 0 means no screen wipe effect (e.g. melt) will occur after the end of the current stage. 1 means to apply the wipe effect.
	:*"secondarylump": only applies if "type" is 0 (art screen). This is optional and will be the lump name of the music to play during the display of the art screen. Eternity allows omitting the game-specific prefix such as "D_" on Doom; for example both "runnin" and "D_RUNNIN" are valid for Doom 2. The name is case insensitive. Completely omitting "secondarylump" will just keep playing the music from the previous stage. Demos don't use this option because the levels they replay have their own music.		:*"secondarylump": only applies if "type" is 0 (art screen). This is optional and will be the lump name of the music to play during the display of the art screen. Eternity allows omitting the game-specific prefix such as "D_" on Doom; for example both "runnin" and "D_RUNNIN" are valid for Doom 2. The name is case insensitive. Completely omitting "secondarylump" will just keep playing the music from the previous stage. Demos don't use this option because the levels they replay have their own music.
	:*"duration": only applies when "type" is 0 (art screen). This is time in seconds that the art screen will display before going to the next stage. It can be expressed in decimal quantities. It should be set for every entry of "type" 0.		:*"duration": only applies when "type" is 0 (art screen). This is time in seconds that the art screen will display before going to the next stage. It can be expressed in decimal quantities. It should be set for every entry of "type" 0.

Printz at 13:07, 14 June 2026

2026-06-14T13:07:27Z

← Older revision		Revision as of 09:07, 14 June 2026
Line 40:		Line 40:
	:*"secondarylump": only applies if "type" is 0 (art screen). This is optional and will be the lump name of the music to play during the display of the art screen. Eternity allows omitting the game-specific prefix such as "D_" on Doom; for example both "runnin" and "D_RUNNIN" are valid for Doom 2. The name is case insensitive. Completely omitting "secondarylump" will just keep playing the music from the previous stage. Demos don't use this option because the levels they replay have their own music.		:*"secondarylump": only applies if "type" is 0 (art screen). This is optional and will be the lump name of the music to play during the display of the art screen. Eternity allows omitting the game-specific prefix such as "D_" on Doom; for example both "runnin" and "D_RUNNIN" are valid for Doom 2. The name is case insensitive. Completely omitting "secondarylump" will just keep playing the music from the previous stage. Demos don't use this option because the levels they replay have their own music.
	:*"duration": only applies when "type" is 0 (art screen). This is time in seconds that the art screen will display before going to the next stage. It can be expressed in decimal quantities. It should be set for every entry of "type" 0.		:*"duration": only applies when "type" is 0 (art screen). This is time in seconds that the art screen will display before going to the next stage. It can be expressed in decimal quantities. It should be set for every entry of "type" 0.

	~~==Example==~~
	Below is how the sequence in Ultimate Doom would be defined. Keep in mind that Eternity by default has it hardcoded, but a representation in the DEMOLOOP would look like the following. Important: only the value of "entries" is shown below, but remember to adhere to the complete format to make it valid:

	[
	{
	~~"type": 0,~~
	~~"primarylump": "TITLEPIC",~~
	~~"secondarylump": "intro",~~
	~~"outrowipe": 1,~~
	~~"duration": 4.85714285714285714286~~
	},
	{
	~~"type": 1,~~
	~~"primarylump": "DEMO1",~~
	~~"outrowipe": 1~~
	},
	{
	~~"type": 0,~~
	~~"outrowipe": 1,~~
	~~"duration": 11~~
	},
	{
	~~"type": 1,~~
	~~"primarylump": "DEMO2",~~
	~~"outrowipe": 1~~
	},
	{
	~~"type": 0,~~
	~~"primarylump": "CREDIT",~~
	~~"outrowipe": 1,~~
	~~"duration": 11~~
	},
	{
	~~"type": 1,~~
	~~"primarylump": "DEMO3",~~
	~~"outrowipe": 1~~
	},
	{
	~~"type": 1,~~
	~~"primarylump": "DEMO4",~~
	~~"outrowipe": 1~~
	}
	]

	The very exact "duration" of the title entry is equivalent to the built-in duration of 170 tics. The third entry (second art screen) is missing its "primarylump" because it shows the Eternity credits instead (Eternity extension).

Printz: /* Example */

2026-06-14T13:07:11Z

Example

← Older revision		Revision as of 09:07, 14 June 2026
Line 84:		Line 84:
	}		}
	]		]

			The very exact "duration" of the title entry is equivalent to the built-in duration of 170 tics. The third entry (second art screen) is missing its "primarylump" because it shows the Eternity credits instead (Eternity extension).

Printz: /* Explanation of fields */

2026-06-14T13:04:37Z

Explanation of fields

← Older revision		Revision as of 09:04, 14 June 2026
Line 35:		Line 35:
	*"metadata": required id24 information. Eternity does not consume them, but they should be provided.		*"metadata": required id24 information. Eternity does not consume them, but they should be provided.
	*"data": must contain a single "entries" array of one or more elements (the example above shows two entries). Each element is described below:		*"data": must contain a single "entries" array of one or more elements (the example above shows two entries). Each element is described below:
	:*"type": can be 0 or 1. 0 means art screen, 1 means demo (game replay).		:*"type": can be 0 or 1. 0 means art screen, 1 means demo (game replay). Caution: demos will only replay reliably in Eternity if the they are recorded in MBF-compatible or below (Boom or vanilla Doom) ports. Do not rely on Eternity-recorded demos to stay in sync with any Eternity update.
	:*"primarylump": if "type" is 0 (art screen), this is the name of the graphics lump to display as the art screen. Eternity tolerates a missing "primarylump", in which case it will show the Eternity credits screen, but this is nonstandard and not portable. If "type" is 1 (demo), this is the name of the demo lump, and it's required.		:*"primarylump": if "type" is 0 (art screen), this is the name of the graphics lump to display as the art screen. Eternity tolerates a missing "primarylump", in which case it will show the Eternity credits screen, but this is nonstandard and not portable. If "type" is 1 (demo), this is the name of the demo lump, and it's required.
	:*"outrowipe": can be 0 or 1. 0 means no screen wipe effect (e.g. melt) will occur after the end of the current stage. 1 means to apply the wipe effect.		:*"outrowipe": can be 0 or 1. 0 means no screen wipe effect (e.g. melt) will occur after the end of the current stage. 1 means to apply the wipe effect.

Printz at 13:01, 14 June 2026

2026-06-14T13:01:49Z

← Older revision		Revision as of 09:01, 14 June 2026
Line 1:		Line 1:
	Eternity supports the DEMOLOOP lump, which is part of the id24 specifications. This lump lets you define the startup sequence, when the game typically shows you various screens and game demos (replays) in sequence, repeating in a loop. Previously you would need to replace various lumps (like TITLEPIC and credits for the art screens, or the DEMOx lumps, possibly emptying them to remove demos), but the DEMOLOOP lump gives you complete control over this sequence.		Eternity supports the DEMOLOOP lump, which is part of the id24 specifications. This lump lets you define the startup sequence, when the game typically shows you various screens and game demos (replays) in sequence, repeating in a loop. Previously you would need to replace various lumps (like TITLEPIC and credits for the art screens, or the DEMOx lumps, possibly emptying them to remove demos) or set EDF [[gameproperties]], but the DEMOLOOP lump gives you complete control over this sequence.

	DEMOLOOP must contain a JSON text data. The content of DEMOLOOP must be of the form:		DEMOLOOP must contain a JSON text data. The content of DEMOLOOP must be of the form:

Printz: /* Explanation of fields */

2026-06-14T12:59:07Z

Explanation of fields

← Older revision		Revision as of 08:59, 14 June 2026
Line 39:		Line 39:
	:*"outrowipe": can be 0 or 1. 0 means no screen wipe effect (e.g. melt) will occur after the end of the current stage. 1 means to apply the wipe effect.		:*"outrowipe": can be 0 or 1. 0 means no screen wipe effect (e.g. melt) will occur after the end of the current stage. 1 means to apply the wipe effect.
	:*"secondarylump": only applies if "type" is 0 (art screen). This is optional and will be the lump name of the music to play during the display of the art screen. Eternity allows omitting the game-specific prefix such as "D_" on Doom; for example both "runnin" and "D_RUNNIN" are valid for Doom 2. The name is case insensitive. Completely omitting "secondarylump" will just keep playing the music from the previous stage. Demos don't use this option because the levels they replay have their own music.		:*"secondarylump": only applies if "type" is 0 (art screen). This is optional and will be the lump name of the music to play during the display of the art screen. Eternity allows omitting the game-specific prefix such as "D_" on Doom; for example both "runnin" and "D_RUNNIN" are valid for Doom 2. The name is case insensitive. Completely omitting "secondarylump" will just keep playing the music from the previous stage. Demos don't use this option because the levels they replay have their own music.
	:*"duration": only applies when "type" is 0 (art screen). This is time in seconds that the art screen will display before going to the next stage. It can be expressed in decimal quantities. It should be set for every entry.		:*"duration": only applies when "type" is 0 (art screen). This is time in seconds that the art screen will display before going to the next stage. It can be expressed in decimal quantities. It should be set for every entry of "type" 0.

	==Example==		==Example==

Printz at 12:58, 14 June 2026

2026-06-14T12:58:50Z

← Older revision		Revision as of 08:58, 14 June 2026
Line 39:		Line 39:
	:*"outrowipe": can be 0 or 1. 0 means no screen wipe effect (e.g. melt) will occur after the end of the current stage. 1 means to apply the wipe effect.		:*"outrowipe": can be 0 or 1. 0 means no screen wipe effect (e.g. melt) will occur after the end of the current stage. 1 means to apply the wipe effect.
	:*"secondarylump": only applies if "type" is 0 (art screen). This is optional and will be the lump name of the music to play during the display of the art screen. Eternity allows omitting the game-specific prefix such as "D_" on Doom; for example both "runnin" and "D_RUNNIN" are valid for Doom 2. The name is case insensitive. Completely omitting "secondarylump" will just keep playing the music from the previous stage. Demos don't use this option because the levels they replay have their own music.		:*"secondarylump": only applies if "type" is 0 (art screen). This is optional and will be the lump name of the music to play during the display of the art screen. Eternity allows omitting the game-specific prefix such as "D_" on Doom; for example both "runnin" and "D_RUNNIN" are valid for Doom 2. The name is case insensitive. Completely omitting "secondarylump" will just keep playing the music from the previous stage. Demos don't use this option because the levels they replay have their own music.
	:*"duration": only applies when "type" is 0 (art screen). This is time in seconds that the art screen will display before going to the next stage. It can be expressed in decimal quantities.		:*"duration": only applies when "type" is 0 (art screen). This is time in seconds that the art screen will display before going to the next stage. It can be expressed in decimal quantities. It should be set for every entry.

	==Example==		==Example==
	Below is how the sequence in Ultimate Doom would be defined. Keep in mind that Eternity by default has it hardcoded, but a representation in the DEMOLOOP would look like the following. Important: only the value of "entries" is shown below, but remember to adhere to the complete format to make it valid:		Below is how the sequence in Ultimate Doom would be defined. Keep in mind that Eternity by default has it hardcoded, but a representation in the DEMOLOOP would look like the following. Important: only the value of "entries" is shown below, but remember to adhere to the complete format to make it valid:

Printz at 12:54, 14 June 2026

2026-06-14T12:54:28Z

@@ Line 36: / Line 36: @@
 *"data": must contain a single "entries" array of one or more elements (the example above shows two entries). Each element is described below:
 :*"type": can be 0 or 1. 0 means art screen, 1 means demo (game replay).
-:*"primarylump": if "type" is 0 (art screen), this is the name of the graphics lump to display as the art screen. Eternity tolerates a missing "primarylump", in which case it will show the credits screen, but this is nonstandard and not portable. If "type" is 1 (demo), this is the name of the demo lump, and it's required.
+:*"primarylump": if "type" is 0 (art screen), this is the name of the graphics lump to display as the art screen. Eternity tolerates a missing "primarylump", in which case it will show the Eternity credits screen, but this is nonstandard and not portable. If "type" is 1 (demo), this is the name of the demo lump, and it's required.
 :*"outrowipe": can be 0 or 1. 0 means no screen wipe effect (e.g. melt) will occur after the end of the current stage. 1 means to apply the wipe effect.
-:*"secondarylump": only applies if "type" is 0 (art screen). This is optional and will be the lump name of the music to play during the display of the art screen. Eternity allows omitting the game-specific prefix such as "D_" on Doom; for example both "runnin" and "D_RUNNIN" are valid for Doom 2. The name is case insensitive. Demos don't use this option because the levels they replay have their own music.
+:*"secondarylump": only applies if "type" is 0 (art screen). This is optional and will be the lump name of the music to play during the display of the art screen. Eternity allows omitting the game-specific prefix such as "D_" on Doom; for example both "runnin" and "D_RUNNIN" are valid for Doom 2. The name is case insensitive. Completely omitting "secondarylump" will just keep playing the music from the previous stage. Demos don't use this option because the levels they replay have their own music.
 :*"duration": only applies when "type" is 0 (art screen). This is time in seconds that the art screen will display before going to the next stage. It can be expressed in decimal quantities.

Printz at 12:38, 14 June 2026

2026-06-14T12:38:11Z

← Older revision		Revision as of 08:38, 14 June 2026
Line 1:		Line 1:
	Eternity supports the DEMOLOOP lump, which is part of the id24 specifications.		Eternity supports the DEMOLOOP lump, which is part of the id24 specifications. This lump lets you define the startup sequence, when the game typically shows you various screens and game demos (replays) in sequence, repeating in a loop. Previously you would need to replace various lumps (like TITLEPIC and credits for the art screens, or the DEMOx lumps, possibly emptying them to remove demos), but the DEMOLOOP lump gives you complete control over this sequence.

	DEMOLOOP must contain a JSON text data. The content of DEMOLOOP must be of the form:		DEMOLOOP must contain a JSON text data. The content of DEMOLOOP must be of the form:
Line 34:		Line 34:
	*"version": must be "1.0.0" maximum.		*"version": must be "1.0.0" maximum.
	*"metadata": required id24 information. Eternity does not consume them, but they should be provided.		*"metadata": required id24 information. Eternity does not consume them, but they should be provided.
	*"data": must contain a single "entries" array of one or more elements. Each element is described below:		*"data": must contain a single "entries" array of one or more elements (the example above shows two entries). Each element is described below:
	:*"type": can be 0 or 1. 0 means art screen, 1 means demo (game replay).		:*"type": can be 0 or 1. 0 means art screen, 1 means demo (game replay).
	:*"primarylump": if "type" is 0 (art screen), this is the name of the graphics lump to display as the art screen. Eternity tolerates a missing "primarylump", in which case it will show the credits screen, but this is nonstandard and not portable. If "type" is 1 (demo), this is the name of the demo lump, and it's required.		:*"primarylump": if "type" is 0 (art screen), this is the name of the graphics lump to display as the art screen. Eternity tolerates a missing "primarylump", in which case it will show the credits screen, but this is nonstandard and not portable. If "type" is 1 (demo), this is the name of the demo lump, and it's required.

Printz: /* Explanation of fields */

2026-06-14T12:34:30Z

Explanation of fields

← Older revision		Revision as of 08:34, 14 June 2026
Line 38:		Line 38:
	:*"primarylump": if "type" is 0 (art screen), this is the name of the graphics lump to display as the art screen. Eternity tolerates a missing "primarylump", in which case it will show the credits screen, but this is nonstandard and not portable. If "type" is 1 (demo), this is the name of the demo lump, and it's required.		:*"primarylump": if "type" is 0 (art screen), this is the name of the graphics lump to display as the art screen. Eternity tolerates a missing "primarylump", in which case it will show the credits screen, but this is nonstandard and not portable. If "type" is 1 (demo), this is the name of the demo lump, and it's required.
	:*"outrowipe": can be 0 or 1. 0 means no screen wipe effect (e.g. melt) will occur after the end of the current stage. 1 means to apply the wipe effect.		:*"outrowipe": can be 0 or 1. 0 means no screen wipe effect (e.g. melt) will occur after the end of the current stage. 1 means to apply the wipe effect.
	:*"secondarylump": only applies if "type" is 0 (art screen). This is optional and will be the lump name of the music to play during the display of the art screen. Eternity allows omitting the game-specific prefix such as "D_" on Doom. The name is case insensitive. Demos don't use this option because the levels they replay have their own music.		:*"secondarylump": only applies if "type" is 0 (art screen). This is optional and will be the lump name of the music to play during the display of the art screen. Eternity allows omitting the game-specific prefix such as "D_" on Doom; for example both "runnin" and "D_RUNNIN" are valid for Doom 2. The name is case insensitive. Demos don't use this option because the levels they replay have their own music.
	:*"duration": only applies when "type" is 0 (art screen). This is time in seconds that the art screen will display before going to the next stage. It can be expressed in decimal quantities.		:*"duration": only applies when "type" is 0 (art screen). This is time in seconds that the art screen will display before going to the next stage. It can be expressed in decimal quantities.