Pmd2 Level System - Revision history

UniqueGeek: Redirect

2017-10-14T21:21:52Z

Redirect

← Older revision		Revision as of 21:21, 14 October 2017
Line 7:		Line 7:
	{{DISPLAYTITLE:Level System in the PMD Explorers Games}}		{{DISPLAYTITLE:Level System in the PMD Explorers Games}}

			{{#externalredirect: https://projectpokemon.org/docs/mystery-dungeon-nds/level-system-in-the-pmd-explorers-games-r43/}}
	~~== Overview ==~~
	~~This article will try to describe how levels work in the pmd2 games~~.

	~~== Engine Modes ==~~
	~~There are essentially 2 modes that the game can run levels as. In~~-dungeon~~, referred to as simply "Dungeon", and out~~-~~of-dungeon, referred to as "Ground".~~
	~~Ground mode is the default mode. Dungeon mode is triggered from scripts run by the Ground engine.~~

	* '''Dungeon:''' The dungeon mode is run as soon as a script from the "ground" engine calls the command to run a dungeon. And once a dungeon concludes, execution returns to the line after the command to run the dungeon, and the game falls back into "ground" mode. Scripts aren't executed at all during dungeon mode, since the overlay running scripts is unloaded and replaced with the dungeon engine overlay.

	* '''Ground:''' The game runs in this mode as soon as the chunsoft logo pops up on screen. Game scripts are executed only in this mode.

	~~== The Level Table ==~~
	~~Located in the ARM9 binary. (arm9.bin)~~
	~~Its a table associating a level ID to~~ level ~~related data. Every "Ground" levels in the game have an entry in this table.~~

	~~=== Location in the Binaries ===~~
	~~The table is always inside the arm9 binary, and never in an overlay.~~

	~~{\| class="wikitable"~~
	~~! Game~~
	~~! Game Code~~
	~~! Table Offset~~
	~~! Nb Entries~~
	\|-
	~~\| '''North American Explorers of Sky'''~~
	~~\| C2SE~~
	~~\| 0xA5488~~
	~~\| 431~~
	\|-
	~~\| '''European Explorers of Sky'''~~
	~~\| C2SP~~
	~~\| 0xA5BE0~~
	~~\| 459~~
	\|-
	~~\| '''Japanese Explorers of Sky'''~~
	~~\| C2SJ~~
	~~\| 0xA689C~~
	~~\| 436~~
	\|}


	~~=== Format ===~~
	~~Each entry is 12 bytes and is laid out this way.~~

	~~{\| class="wikitable"~~
	~~! Offset~~
	~~! Length~~
	~~! Type~~
	~~! Name~~
	~~! Description~~
	\|-
	~~\| 0x00~~
	~~\| 2~~
	~~\| int16~~
	~~\| mapty~~
	~~\| Type of~~ the ~~map. A value from 0 to 11 defining how a map is loaded and displayed.~~
	\|-
	~~\| 0x02~~
	~~\| 2~~
	~~\| int16~~
	~~\| unk2~~
	~~\| Unknown value. (0 to 306)~~
	\|-
	~~\| 0x04~~
	~~\| 2~~
	~~\| int16~~
	~~\| mapid~~
	~~\| ID number of the map. Most likely used in the [[pmd2_bg_list.dat\|bg_list.dat]] file to look up the level's resources files.~~
	\|-
	~~\| 0x06~~
	~~\| 2~~
	~~\| int16~~
	~~\| unk4~~
	~~\| Unknown value. (~~-~~1 to 7)~~
	\|-
	~~\| 0x08~~
	~~\| 4~~
	~~\| uint32~~
	~~\| ptrstring~~
	~~\| Pointer to a null terminated string, containing the internal name of the level. Is used as directory name for the script to run, and for debugging.~~
	\|}

	~~== Level Constants and Map Types ==~~
	~~Depending on the map type, and on the command used to load a level, a different set of constant will be used by the game.~~

	~~<span style="color: red; text-decoration: bold;">TODO</span>~~

	~~== Credits ==~~

UniqueGeek at 00:06, 3 February 2017

2017-02-03T00:06:32Z

← Older revision		Revision as of 00:06, 3 February 2017
Line 2:		Line 2:
	[[Category:ROM Hacking]]		[[Category:ROM Hacking]]
	[[Category:Technical References]]		[[Category:Technical References]]
	[[Category:~~Pokemon~~ Mystery Dungeon ~~Series~~]]		[[Category:NDS Mystery Dungeon]]
			[[Category:Levels]]
			[[Category:Game Engine]]
	{{DISPLAYTITLE:Level System in the PMD Explorers Games}}		{{DISPLAYTITLE:Level System in the PMD Explorers Games}}

Psy commando: /* The Level Table */ cleared up something

2017-01-05T22:06:26Z

The Level Table: cleared up something

← Older revision		Revision as of 22:06, 5 January 2017
Line 18:		Line 18:

	== The Level Table ==		== The Level Table ==
	~~Table~~ associating a level ID to level related data. Every "Ground" levels in the game have an entry in this table.		Located in the ARM9 binary. (arm9.bin)
			Its a table associating a level ID to level related data. Every "Ground" levels in the game have an entry in this table.

	=== Location in the Binaries ===		=== Location in the Binaries ===
Line 86:		Line 87:
	\| Pointer to a null terminated string, containing the internal name of the level. Is used as directory name for the script to run, and for debugging.		\| Pointer to a null terminated string, containing the internal name of the level. Is used as directory name for the script to run, and for debugging.
	\|}		\|}


	== Level Constants and Map Types ==		== Level Constants and Map Types ==

Psy commando: initial commit of the page on the level system

2016-12-13T00:40:37Z

initial commit of the page on the level system

New page

[[Category:Incomplete Articles]]
[[Category:ROM Hacking]]
[[Category:Technical References]]
[[Category:Pokemon Mystery Dungeon Series]]
{{DISPLAYTITLE:Level System in the PMD Explorers Games}}

== Overview ==
This article will try to describe how levels work in the pmd2 games.

== Engine Modes ==
There are essentially 2 modes that the game can run levels as. In-dungeon, referred to as simply "Dungeon", and out-of-dungeon, referred to as "Ground".
Ground mode is the default mode. Dungeon mode is triggered from scripts run by the Ground engine.

* '''Dungeon:''' The dungeon mode is run as soon as a script from the "ground" engine calls the command to run a dungeon. And once a dungeon concludes, execution returns to the line after the command to run the dungeon, and the game falls back into "ground" mode. Scripts aren't executed at all during dungeon mode, since the overlay running scripts is unloaded and replaced with the dungeon engine overlay.

* '''Ground:''' The game runs in this mode as soon as the chunsoft logo pops up on screen. Game scripts are executed only in this mode.

== The Level Table ==
Table associating a level ID to level related data. Every "Ground" levels in the game have an entry in this table.

=== Location in the Binaries ===
The table is always inside the arm9 binary, and never in an overlay.

{| class="wikitable"
! Game
! Game Code
! Table Offset
! Nb Entries
|-
| '''North American Explorers of Sky'''
| C2SE
| 0xA5488
| 431
|-
| '''European Explorers of Sky'''
| C2SP
| 0xA5BE0
| 459
|-
| '''Japanese Explorers of Sky'''
| C2SJ
| 0xA689C
| 436
|}

=== Format ===
Each entry is 12 bytes and is laid out this way.

{| class="wikitable"
! Offset
! Length
! Type
! Name
! Description
|-
| 0x00
| 2
| int16
| mapty
| Type of the map. A value from 0 to 11 defining how a map is loaded and displayed.
|-
| 0x02
| 2
| int16
| unk2
| Unknown value. (0 to 306)
|-
| 0x04
| 2
| int16
| mapid
| ID number of the map. Most likely used in the [[pmd2_bg_list.dat|bg_list.dat]] file to look up the level's resources files.
|-
| 0x06
| 2
| int16
| unk4
| Unknown value. (-1 to 7)
|-
| 0x08
| 4
| uint32
| ptrstring
| Pointer to a null terminated string, containing the internal name of the level. Is used as directory name for the script to run, and for debugging.
|}

== Level Constants and Map Types ==
Depending on the map type, and on the command used to load a level, a different set of constant will be used by the game.

<span style="color: red; text-decoration: bold;">TODO</span>

== Credits ==