Generators - Revision history

NerdOfEpic at 21:14, 17 March 2026

2026-03-17T21:14:21Z

← Older revision		Revision as of 21:14, 17 March 2026
Line 2:		Line 2:
	Objective planning follows the key/lock pattern. This can mean literally keys and locks like "you need the red key to go through the door with the red lock," but it also could mean "you need to have high jump boots to get up here." Some logic needs to be used to prevent unbeatable worlds. For example, it would be an unbeatable situation to put the high jump boots after the ledge that is too high to get up to without the high jump boots. You'd never be able to get to any part of the world past that point.		Objective planning follows the key/lock pattern. This can mean literally keys and locks like "you need the red key to go through the door with the red lock," but it also could mean "you need to have high jump boots to get up here." Some logic needs to be used to prevent unbeatable worlds. For example, it would be an unbeatable situation to put the high jump boots after the ledge that is too high to get up to without the high jump boots. You'd never be able to get to any part of the world past that point.

	= Objective Planning =		== Objective Planning ==
	The first thing that happens when generating the world is objective planning. This process builds an objective traversal graph structure that goes from the escape pod through all of the bosses while laying out all of the items. It also ensures items needed to progress are in the available somewhere in the graph before the lock that needs them. This helps to guarantee that worlds are generated that can be fully explored.		The first thing that happens when generating the world is objective planning. This process builds an objective traversal graph structure that goes from the escape pod through all of the bosses while laying out all of the items. It also ensures items needed to progress are in the available somewhere in the graph before the lock that needs them. This helps to guarantee that worlds are generated that can be fully explored.

	= Map Parts =		= Map Parts =
	The map is a nested structure of rooms made of screens built up of structures.		The map is a nested structure of rooms made of screens built up of structures. The layout of the map takes into consideration the objective graph.

	== Rooms ==		== Rooms ==

NerdOfEpic at 21:12, 17 March 2026

2026-03-17T21:12:40Z

← Older revision		Revision as of 21:12, 17 March 2026
Line 1:		Line 1:
			= Keys / Locks =
			Objective planning follows the key/lock pattern. This can mean literally keys and locks like "you need the red key to go through the door with the red lock," but it also could mean "you need to have high jump boots to get up here." Some logic needs to be used to prevent unbeatable worlds. For example, it would be an unbeatable situation to put the high jump boots after the ledge that is too high to get up to without the high jump boots. You'd never be able to get to any part of the world past that point.

			= Objective Planning =
			The first thing that happens when generating the world is objective planning. This process builds an objective traversal graph structure that goes from the escape pod through all of the bosses while laying out all of the items. It also ensures items needed to progress are in the available somewhere in the graph before the lock that needs them. This helps to guarantee that worlds are generated that can be fully explored.

	= Map Parts =		= Map Parts =
	The map is a nested structure of rooms made of screens built up of structures.		The map is a nested structure of rooms made of screens built up of structures.

	== Rooms ==		== Rooms ==

NerdOfEpic: /* Room Generators */

2026-01-29T01:01:18Z

Room Generators

← Older revision		Revision as of 01:01, 29 January 2026
Line 56:		Line 56:

	== Room Generators ==		== Room Generators ==
	Room generators are pieces of code that generate individual rooms. They have several parameters that are provided by the ~~map~~ generator that control what is generated.		Room generators are pieces of code that generate individual rooms. They have several parameters that are provided by the world generator that control what is generated.

	'''All Room Generators receive parameters for:'''		'''All Room Generators receive parameters for:'''

NerdOfEpic: /* Map Generator */

2026-01-29T00:59:56Z

Map Generator

← Older revision		Revision as of 00:59, 29 January 2026
Line 42:		Line 42:
	There is a procedural generation system that creates the world. It's made up of nested layers that have specific roles in the process.		There is a procedural generation system that creates the world. It's made up of nested layers that have specific roles in the process.

	== ~~Map~~ Generator ==		== World Generator ==
	This is the top-level system that orchestrates the layout of the entire map. Essentially it manages the use of room generators ~~and~~ the placement and interconnection of ~~the generated rooms~~.		This is the top-level system that orchestrates the layout of the entire map. Essentially it manages the use of room generators, the placement of the rooms, and the interconnection of them.

	'''This System:'''		'''This System:'''

NerdOfEpic: /* Generators */

2026-01-27T23:35:42Z

Generators

← Older revision		Revision as of 23:35, 27 January 2026
Line 42:		Line 42:
	There is a procedural generation system that creates the world. It's made up of nested layers that have specific roles in the process.		There is a procedural generation system that creates the world. It's made up of nested layers that have specific roles in the process.

	== Map ~~Generation Manager~~ ==		== Map Generator ==
	This system orchestrates the layout of the entire map. Essentially it manages the use of room generators and the placement and interconnection of the generated rooms.		This is the top-level system that orchestrates the layout of the entire map. Essentially it manages the use of room generators and the placement and interconnection of the generated rooms.

	'''~~The Manager~~:'''		'''This System:'''
	* Owns the random number generator that provides the stream of random numbers used during generation.		* Owns the random number generator that provides the stream of random numbers used during generation. (It's passed down through other layers of generators.)
	* Makes decisions based on the world configuration.		* Makes decisions based on the world configuration.
	* Decides how room generators are used to fill in the map.		* Decides how room generators are used to fill in the map.
Line 56:		Line 56:

	== Room Generators ==		== Room Generators ==
	~~Generators~~ are pieces of code that generate individual ~~types of~~ rooms. They have several parameters that are provided by the map ~~generation manager~~ that control what is generated.		Room generators are pieces of code that generate individual rooms. They have several parameters that are provided by the map generator that control what is generated.

			'''All Room Generators receive parameters for:'''
			* The size of the room to generate, in screens.
			* Details about where doors have to be to in the room to satisfy requirements of the map as a whole.
			* Item limiters that are allowed to be used. These are items that could have been collected by the time the player gets to this room and can be used to limit travel through the room that will be generated.

	=== Types ===		=== Types ===
	There is a collection of room generators that is used to build the world. There are also [[Tutorial Generators]] that create the specific set of rooms used for the tutorial area if needed.		There is a collection of room generators that is used to build the world. There are also [[Tutorial Generators]] that create the specific set of rooms used for the tutorial area if needed.

	~~'''All generators receive parameters:'''~~
	* The world position of the upper-left screen in this room, in screens.
	* The size of the room to generate, in screens.
	* Information about where the room must make contact with the edges of its space so doors can be placed.
	* Item limiters that are allowed to be used. These are items that could have been collected by the time the player gets to this room and can be used to limit travel through the room that will be generated.

	'''Generators produce rooms that have markers for:'''		'''Generators produce rooms that have markers for:'''
	* Where doors can be placed (essentially any screen edge where the room touches the edge of the containing rectangle).
	* Enemy spawn points with difficulty flags.		* Enemy spawn points with difficulty flags.
	* Locations where upgrade items can be placed if needed.

	{\| class="wikitable"		{\| class="wikitable"

NerdOfEpic at 00:45, 13 January 2026

2026-01-13T00:45:45Z

Show changes

NerdOfEpic: /* Room Generators */

2026-01-10T05:05:46Z

Room Generators

← Older revision		Revision as of 05:05, 10 January 2026
Line 45:		Line 45:

	= Room Generators =		= Room Generators =
	Generators are pieces of code that generate individual rooms. They have several parameters that are provided by the map generation manager that control what is generated.		Generators are pieces of code that generate individual types of rooms. They have several parameters that are provided by the map generation manager that control what is generated.

	== Types ==		== Types ==
Line 51:		Line 51:

	'''All generators receive parameters:'''		'''All generators receive parameters:'''
	* ~~Maximum~~ size the room ~~is allowed~~ to be, in screens.		* The world position of the upper-left screen in this room, in screens.
			* The size of the room to generate, in screens.
	* Limiters that are allowed. These are items that could have been collected by the time the player gets to this room and can be used to limit travel through the room that will be generated.		* Limiters that are allowed. These are items that could have been collected by the time the player gets to this room and can be used to limit travel through the room that will be generated.

NerdOfEpic: /* Structures */

2026-01-10T05:03:32Z

Structures

← Older revision		Revision as of 05:03, 10 January 2026
Line 96:		Line 96:

	= Structures =		= Structures =
	Structures are parameterized chunks of "stuff" that go in a room. They ~~range from~~ statues and ~~platforms to puzzle mazes and hazards~~. The use of these is managed by the room generator that needs the stuff.		Structures are parameterized chunks of "stuff" that go in a room. They include platforms, room edges, doors, statues, hazards, generators, and anything else that can be visually placed on a screen. The use of these is managed by the room generator that needs the stuff in question.

	== Types ==		== Types ==
	There is a collection of structure ~~templates~~ that can be used by room generators to make things that go in the rooms during generation.		There is a collection of structure generators that can be used by room generators to make things that go in the rooms during generation.

	'''All structure ~~templates~~ receive parameters:'''		'''All structure generators receive parameters:'''
			* Position of the structure relative to the screen layout, in tiles.
	* Size of the structure, in tiles.		* Size of the structure, in tiles.

Line 111:		Line 112:
	* Horizontal		* Horizontal
	* Vertical		* Vertical
	'''~~End Caps~~'''		'''Junctions'''
	\|\|This structure builds a platform using pipe style parts. It can also utilize either decorative ~~caps~~ or simple pipe ends.		\|\|This structure builds a platform using pipe style parts. It can also utilize either decorative junctions or simple pipe ends.
	\|}		\|}

NerdOfEpic: /* Rooms */

2026-01-09T20:03:54Z

Rooms

← Older revision		Revision as of 20:03, 9 January 2026
Line 16:		Line 16:
	* The space they contain is always bounded by a rectangle that has a position in the world.		* The space they contain is always bounded by a rectangle that has a position in the world.
	* The space in the array does not need to be full of screens (gaps are allowed) as long as the room is used to make only a single connected space.		* The space in the array does not need to be full of screens (gaps are allowed) as long as the room is used to make only a single connected space.
			* The screens within the space of a room must touch all edges of the room.
	* Rooms are the level that represent a self contained space that is loadable by the game engine.		* Rooms are the level that represent a self contained space that is loadable by the game engine.
	* There is no specific design limit on how many screens can be involved in a single room.		* There is no specific design limit on how many screens can be involved in a single room.

NerdOfEpic at 18:12, 28 December 2025

2025-12-28T18:12:13Z

← Older revision		Revision as of 18:12, 28 December 2025
Line 96:		Line 96:
	= Structures =		= Structures =
	Structures are parameterized chunks of "stuff" that go in a room. They range from statues and platforms to puzzle mazes and hazards. The use of these is managed by the room generator that needs the stuff.		Structures are parameterized chunks of "stuff" that go in a room. They range from statues and platforms to puzzle mazes and hazards. The use of these is managed by the room generator that needs the stuff.

			== Types ==
			There is a collection of structure templates that can be used by room generators to make things that go in the rooms during generation.

			'''All structure templates receive parameters:'''
			* Size of the structure, in tiles.

			{\| class="wikitable"
			\|+ Types of Room Generators
			!Structure!!Extra Parameters!!Description
			\|-
			\|Platform\|\|'''Type'''<br />
			* Horizontal
			* Vertical
			'''End Caps'''
			\|\|This structure builds a platform using pipe style parts. It can also utilize either decorative caps or simple pipe ends.
			\|}