Tutorial:Creating Dungeons - Revision history

Imbion at 17:03, 9 March 2026

2026-03-09T17:03:36Z

← Older revision		Revision as of 17:03, 9 March 2026
Line 1:		Line 1:
	Dungeon creation is a complex process. For modders just starting out, it is usually easier to take an existing dungeon, and modify parts of it to suit their goals, rather than create one from scratch. This guide walks through that approach, using the Tropical Path.		Dungeon creation is a complex process. For modders just starting out, it is usually easier to take an existing dungeon, and modify parts of it to suit their goals, rather than create one from scratch. This guide walks through that approach, using the Tropical Path.


	The most common aspects of a dungeon that people are interested in editing are:		The most common aspects of a dungeon that people are interested in editing are:
Line 10:		Line 9:
	* Enemy Spawn tables		* Enemy Spawn tables
	* Events occurring on completion		* Events occurring on completion


	We will change them in that order.		We will change them in that order.


	This tutorial assumes you have completed the tutorial for [[Creating Ground Maps]], and the [[Creating Dungeon Maps]], although it does not use the ground and dungeon map created in it until the last section, “Editing Completion Events”.		This tutorial assumes you have completed the tutorial for [[Creating Ground Maps]], and the [[Creating Dungeon Maps]], although it does not use the ground and dungeon map created in it until the last section, “Editing Completion Events”.

	Before starting, it is highly recommended you begin with your game set to a mod with the [[Modding Intro]], so that you’re editing a mod instead of the base game. The tutorial will move forward with that assumption.		Before starting, it is highly recommended you begin with your game set to a mod with the [[Modding Intro]], so that you’re editing a mod instead of the base game. The tutorial will move forward with that assumption.


	== Editing Name ==		== Editing Name ==

Imbion: Imbion moved page Creating Dungeons to Tutorial:Creating Dungeons

2025-10-16T15:41:09Z

Imbion moved page Creating Dungeons to Tutorial:Creating Dungeons

← Older revision	Revision as of 15:41, 16 October 2025
(No difference)

Imbion at 22:20, 5 August 2025

2025-08-05T22:20:26Z

← Older revision		Revision as of 22:20, 5 August 2025
Line 684:		Line 684:


	[[Category:~~Modding Data~~]]		[[Category:Dungeon Generation]]

Shitpost Sunkern at 20:09, 16 April 2024

2024-04-16T20:09:16Z

← Older revision		Revision as of 20:09, 16 April 2024
Line 3:		Line 3:

	The most common aspects of a dungeon that people are interested in editing are:		The most common aspects of a dungeon that people are interested in editing are:
	* Attributes such as Dungeon Name, Music, Darkness		* Attributes such as Dungeon Name, Music, [[Darkness]]
	* Tileset		* Tileset
	* Floor Features		* Floor Features
Line 88:		Line 88:
	* Blind: You can’t see anything.		* Blind: You can’t see anything.
	* Any: Unused.		* Any: Unused.
			See [[Darkness\|this page]] for screenshots of what these settings look like in use.

	Change them to the settings below:		Change them to the settings below:

IDK: show snippet of code instead

2023-03-17T03:42:45Z

show snippet of code instead

@@ Line 616: / Line 616: @@
 And then open the contents.
-[[File:ModdingDungeons_ScriptEnd.png|frameless]]
+The ExitSegment block should look like this:
 We want to detect a case where the player has cleared segment 0, map 13.  Then, we want to end the dungeon day with the destination set to Guildmaster Island, Segment -1, Map 1, Entrance 0.  Aka Base Camp:
@@ Line 625: / Line 650: @@
 The result should look like this:
-[[File:ModdingDungeons_ScriptEndEdited.png|frameless]]
+<pre>
 Save the script, and run through the dungeon once more.  Defeating Dialga should properly end the dungeon with a victory screen now.

IDK: script corrections

2023-03-17T03:37:41Z

script corrections

← Older revision		Revision as of 03:37, 17 March 2023
Line 596:		Line 596:

	This will send the player into Temporal Pinnacle.		This will send the player into Temporal Pinnacle.

			Additionally, you can see lines 37, 38, and 39 all reference an exit through the secret room, to unlock a new dungeon. Since we removed the secret room, we can remove those lines too.

	Save this file, reload the scripts, and retry a run through the dungeon.		Save this file, reload the scripts, and retry a run through the dungeon.

IDK: text for connecting the dungeon

2023-03-16T06:07:59Z

text for connecting the dungeon

← Older revision		Revision as of 06:07, 16 March 2023
Line 569:		Line 569:
	The result should look like this.		The result should look like this.

	Open the folder ~~zone_2~~, and open <code>init.lua</code> in a text editor (Notepad++ recommended)		Open the folder tropical_path, and open <code>init.lua</code> in a text editor (Notepad++ recommended)

	[[File:ModdingDungeons_Script.png\|frameless]]		[[File:ModdingDungeons_Script.png\|frameless]]
Line 585:		Line 585:
	We are interested in Line 36:		We are interested in Line 36:
	<pre>		<pre>
	COMMON.EndDungeonDay(result, 1, -1, 3, 0)		COMMON.EndDungeonDay(result, "guildmaster_island", -1, 3, 0)
	</pre>		</pre>

	This method call is a general dungeon completion event, which increments the day count, restores everyone’s HP, displays the win/lose screen, and then warps them to the specified destination. In this case, it is warping the player to ~~Zone 1:~~ Guildmaster Island. Segment -1: Ground maps. Ground Map 3: Forest Camp. Entry 0: Default Entrance.		This method call is a general dungeon completion event, which increments the day count, restores everyone’s HP, displays the win/lose screen, and then warps them to the specified destination. In this case, it is warping the player to Guildmaster Island. Segment -1: Ground maps. Ground Map 3: Forest Camp. Entry 0: Default Entrance.

	We don’t want to end the dungeon adventure just yet. We just want to warp the player to the ground map for Temporal Pinnacle so that it can start the boss battle. Replace it with the following call:		We don’t want to end the dungeon adventure just yet. We just want to warp the player to the ground map for Temporal Pinnacle so that it can start the boss battle. Replace it with the following call:
	<pre>		<pre>
	GAME:EnterZone(1, -1, 13, 0)		GAME:EnterZone("guildmaster_island", -1, 13, 0)
	</pre>		</pre>

Line 604:		Line 604:


	Lastly, if we want to end the dungeon properly on completing the boss battle, we need to include a call to EndDungeonDay in the zone script where the boss battle takes place. In this case, it is in <code>Data/Script/Zone/~~zone_1~~</code>		Lastly, if we want to end the dungeon properly on completing the boss battle, we need to include a call to EndDungeonDay in the zone script where the boss battle takes place. In this case, it is in <code>Data/Script/Zone/guildmaster_island</code>

	[[File:ModdingDungeons_ScriptEndFolder.png\|frameless]]		[[File:ModdingDungeons_ScriptEndFolder.png\|frameless]]
Line 616:		Line 616:
	[[File:ModdingDungeons_ScriptEnd.png\|frameless]]		[[File:ModdingDungeons_ScriptEnd.png\|frameless]]

	We want to detect a case where the player has cleared segment 0, map 13. Then, we want to end the dungeon day with the destination set to ~~Zone 1~~, Segment -1, Map 1, Entrance 0. Aka Base Camp:		We want to detect a case where the player has cleared segment 0, map 13. Then, we want to end the dungeon day with the destination set to Guildmaster Island, Segment -1, Map 1, Entrance 0. Aka Base Camp:
	<pre>		<pre>
	COMMON.EndDungeonDay(result, 1, -1, 1, 0)		COMMON.EndDungeonDay(result, "guildmaster_island", -1, 1, 0)
	</pre>		</pre>

IDK: text corrections

2023-03-16T05:58:16Z

text corrections

← Older revision		Revision as of 05:58, 16 March 2023
Line 312:		Line 312:
	[[File:ModdingDungeons_FloorAdded.png\|frameless]]		[[File:ModdingDungeons_FloorAdded.png\|frameless]]

	There are 4 floors in total. ~~Click into~~ the first one with all of the Lava Path data we want.		There are 4 floors in total. Right click the first one with all of the Lava Path data we want, and you will see the option to copy and paste individual floors.

	~~[[File:ModdingDungeons_FloorCopy.png\|frameless]]~~		Paste this floor 3 more times, and then delete all the older floors.

	~~By right-clicking, we can copy all data from~~ this floor.

	~~[[File:ModdingDungeons_FloorPaste.png\|frameless]]~~

	~~Edit the other 4 floors~~, and ~~paste~~ the ~~data using the same right click~~.

	[[File:ModdingDungeons_FloorCopied.png\|frameless]]		[[File:ModdingDungeons_FloorCopied.png\|frameless]]

	We now have all 4 floors changed, but for our dungeon, we want more. We can add more until there are 7, using the same pasting method:		We now have all 4 floors changed, but for our dungeon, we want more. We can add more until there are 7, using the same pasting method:

	~~[[File:ModdingDungeons_FloorPasteNew.png\|frameless]]~~

	[[File:ModdingDungeons_FloorExtended.png\|frameless]]		[[File:ModdingDungeons_FloorExtended.png\|frameless]]
Line 383:		Line 375:
	Every spawn in this list has a Start, End, and Weight:		Every spawn in this list has a Start, End, and Weight:
	* Start and End are the first and last floors the item can appear in.		* Start and End are the first and last floors the item can appear in.
	* Weight controls how common the item is within this spawn group. To get its percent chance of appearing in a given floor, add together the weights of all the items and divide the item’s weight.		* Weight controls how common the item is within this spawn group. To get its percent chance of appearing in a given floor out of all possible items within this category, add together the weights of all the items and divide the item’s weight.

	If you add up the weights of all items on floor 4, you get:		If you add up the weights of all items on floor 4, you get:
Line 394:		Line 386:

	Let’s modify the Apple spawn to the above image. You must first by select it.		Let’s modify the Apple spawn to the above image. You must first by select it.
	* Lower the weight of the apple to 5. You can do this ~~using~~ the ~~slider~~ for weight.		* Lower the weight of the apple to 5. You can do this by changing the numeric value for weight.
	* Increase the End value of the apple to ~~8 (the current number of floors+1)~~. You can do this by changing the numeric value for End.		* Increase the End value of the apple to 7. You can do this by changing the numeric value for End.


Line 409:		Line 401:


	Now, let’s move on to SpawnRates. The Start and End control which floors the entire category of items appear in, and the Value controls the chance that the category itself has to spawn.		Now, let’s move on to SpawnRates. The Start and End control which floors the entire category of items appear in, and the Value controls the chance that the category itself has to spawn.
	Currently the “necessities” category itself is set to spawn only on floors 1-4, with a weight of 14.		Currently the “necessities” category itself is set to spawn only on floors 1-4, with a weight of 14.

Line 446:		Line 438:
	[[File:ModdingDungeons_ItemCategorySpawnDone.png\|frameless]]		[[File:ModdingDungeons_ItemCategorySpawnDone.png\|frameless]]

	~~And click~~ OK to save the item table as a whole.		You can preview a calculated percentage list of ALL items from ALL categories for a floor, by selecting the floor number at the bottom and clicking Get Summary. For example, this is what the full item table for floor 1 looks like:

			[[File:ModdingDungeons_ItemCategorySpawnSummary.png\|frameless]]

			Click OK to save the item table as a whole.

	[[File:ModdingDungeons_LayeredSegmentTeamSpawnZoneStep.png\|frameless]]		[[File:ModdingDungeons_LayeredSegmentTeamSpawnZoneStep.png\|frameless]]
Line 475:		Line 471:
	* Intrinsic is the ability. You can leave this blank to let the spawner roll it randomly.		* Intrinsic is the ability. You can leave this blank to let the spawner roll it randomly.
	* Change Tactic to change the AI of the Pokemon.		* Change Tactic to change the AI of the Pokemon.
			* Spawn Conditions make it such that the Pokemon only appears under certain conditions. Typically, this is used for version exclusives.
	* Spawn Features are additional modifications made to the Pokemon when it is spawned. Typically, most use MobSpawnWeak and MobSpawnMovesOff.		* Spawn Features are additional modifications made to the Pokemon when it is spawned. Typically, most use MobSpawnWeak and MobSpawnMovesOff.
	* Role is the role that the spawned Pokemon has in the team.		* Role is the role that the spawned Pokemon has in the team.
Line 542:		Line 539:
	Then, at floors 5-7 there will be a 4/12=33% chance to spawn a lone enemy, and a 8/12=66% chance of spawning a team of 3.		Then, at floors 5-7 there will be a 4/12=33% chance to spawn a lone enemy, and a 8/12=66% chance of spawning a team of 3.

			Click OK, and give the ZoneSteps list one more view:

			[[File:ModdingDungeons_RemoveNeutralNPCs.png\|frameless]]

			You may notice in your last playtest that you ran into some neutral NPCs wandering the map. The SpreadStepZoneStep is responsible for adding them randomly to the dungeon as a whole. Remove this step to delete those NPCs from the dungeon.

	~~Click~~ OK through everything and save the whole dungeon.		Then, click OK through everything and save the whole dungeon.

	[[File:ModdingDungeons_TestFull.png\|frameless]]		[[File:ModdingDungeons_TestFull.png\|frameless]]

IDK at 06:57, 15 March 2023

2023-03-15T06:57:11Z

← Older revision		Revision as of 06:57, 15 March 2023
Line 288:		Line 288:
	The map generator takes the total Money assigned to this floor (specified elsewhere), and divides it into X piles.		The map generator takes the total Money assigned to this floor (specified elsewhere), and divides it into X piles.

	The number of piles is specified in Div Amount, currently set to a range of 1-2. Set it to 4-6. Note that since we have divided the money into more piles, the amount from each pickup will be less. We will need to increase the money amount later.		The number of piles is specified in Div Amount, currently set to a range of 1-2. Set it to 6-10. Note that since we have divided the money into more piles, the amount from each pickup will be less. We will need to increase the money amount later.

	Click OK to save.		Click OK to save.

IDK: amt corrections

2023-03-15T06:40:16Z

amt corrections

← Older revision		Revision as of 06:40, 15 March 2023
Line 259:		Line 259:
	There are many settings here, but we are only worried about the Amount, which controls how many teams are spawned at the beginning.		There are many settings here, but we are only worried about the Amount, which controls how many teams are spawned at the beginning.

	It is currently set to a range of 2-4. Set it to a range of 6-10.		It is currently set to a range of 2-3 inclusive. Set it to a range of 6-9.

	Click OK to save.		Click OK to save.
Line 276:		Line 276:
	Similar to PlaceRandomMobsStep, we are only worried about the Amount, which controls how many items are spawned during generation.		Similar to PlaceRandomMobsStep, we are only worried about the Amount, which controls how many items are spawned during generation.

	It is currently set to a range of 2-4. Set it to a range of 5-7.		It is currently set to a range of 2-3. Set it to a range of 5-7.

	Click OK to save.		Click OK to save.
Line 288:		Line 288:
	The map generator takes the total Money assigned to this floor (specified elsewhere), and divides it into X piles.		The map generator takes the total Money assigned to this floor (specified elsewhere), and divides it into X piles.

	The number of piles is specified in Div Amount, currently set to a range of 2-4. Set it to 6~~-10~~.		The number of piles is specified in Div Amount, currently set to a range of 1-2. Set it to 4-6. Note that since we have divided the money into more piles, the amount from each pickup will be less. We will need to increase the money amount later.

	Click OK to save.		Click OK to save.