ProjectPokemon Wiki - User contributions [en]

PMD2 Strings

2015-01-25T07:11:00Z

Nerketur: /* Pause during text display */ Added [W]

=Change color of text=
[CS:<type>]text[CR]
A: Identified Item
B: Forbidden Choice
C: Caution
D: Standard Color
E: Bold Text
F: Team Pokémon Name
G: Money
H: Traps (not in scripts, but used in game)
I: Item Name
J: Effect (of move)
K: Poké Species Name
L: Title Color (Also in testing)
M: Move Name
N: Pokémon Name
O: (unused?)
P: Place Name
Q: (unused?)
R: Selling Price
S: Multiple Items Selected
T: Transparent
U: Unidentified Item
V: Number
W: Warning
X: Team name
Y: Team pokemon?
Z: Exclusive items

=lines=
A horizontal line width of window
[BAR]

=Pause during text display=
pause for tap, print the rest after interaction from the user
[K]
Pause at end, rest in new message
[C]
Pause for <int> frames, then automatically continue
[W:<int>]

=Name replacers=
name of player
[hero]
name of partner
[partner]
name of player team
[team:]

[c_kind:<type>]
[c_name:<type>]
PLAYER: player
ATTENDANT1: partner/second on team
ATTENDANT2: 3rd person on team (not used in-game)
ATTENDANT3: 4th person on team (not used in-game)
NPC_HERO: Hero, used when hero is NPC (first time seen hero)
NPC_PARTNER: partner, used when partner is NPC or possibility of partner not in second slot
NPC_NEW_FRIEND: friend that just joined the team
NPC_MANAFI: manaphy
--tests--
NPC_TEST006: name of ?
NPC_TEST007: name of ?
--used in sky only?--
NPC_HERO_REAL: hero(player) name. Same as [player] in main story
NPC_PARTNER_REAL: (partner) name. Same as [partner] in main story
NPC_HERO_FIRST: hero(player) name. Same as [player] in main story, used in special missions
NPC_PARTNER_FIRST: (partner) name. Same as [partner] in main story, used in special missions

=Alignment=
following text is centered?
[CN]

=Font=
[FT:<int>]
0: all following text is normal text
1: all following text is unown text
2: all following text is buttons/same as B on the M format code, where the order in B is 'A-Za-z0-9' and two others. 64 in all.

Note: the [FT:?] format code doesn't reset at the end of a string. It stays in effect until a message with another format code is displayed.

=Objects=
[M:<type>] -- All of these (except the debug commands) can be accessed with B as well, only the "official" letter-numbers are used.
--buttons--
B0: Start
B1: Select
B2: A
B3: B
B4: X
B5: Y
B6: L
B7: R
B8: d-pad
--reg buttons--
B9: -
B10: o
B11: x
B12: ^
B13: v
B14: <
B15: >
B16: <<
B17: >>
B18: (list)
B19: (search)
B20: dpad updown
B21: dpad leftright
--gold buttons- (active)
B22: -
B23: o
B24: x
B25: ^
B26: v
B27: <
B28: >
B29: <<
B30: >>
B31: (list)
B32: (search)
--designs--
S0: Poké
S1: blank
S2: check
S3: Star
S4: x
S5: checkx
--hearts--
H0: pink heart 1/4
H1: pink heart 2/4
H2: pink heart 3/4
H3: pink heart 4/4
H4: yellow heart 1/4
H5: yellow heart 2/4
H6: yellow heart 3/4
H7: yellow heart 4/4
--dungeon?--
R0: -
R1: halfstar
R2: ? golden egg?
R3: closed letter
R4: open letter
R5: design?
R6: job post?
R7: new story dungeon
?R8: Wifi icon
?R9: email icon
--text?--
T0: :
T1: ' '
T2: chat balloon
T3: japanese chara
T4: different japanese chara
--items--
I0: TM (T5)
I1: Orb (T6)
--debug?--
D0: ? turn debug off?
D1: Used in wireless and debug mode text
D2: used rarely

=Links=
[LS:<integer>]
integer: which help info to link to

=Spaces=
integer determines how many pixels of space to leave.
[S:<int>]

PMD2 Strings

2015-01-24T15:37:08Z

Nerketur: All tested, created string format page. More to come.

=Change color of text=
[CS:<type>]text[CR]
A: Identified Item
B: Forbidden Choice
C: Caution
D: Standard Color
E: Bold Text
F: Team Pokémon Name
G: Money
H: Traps (not in scripts, but used in game)
I: Item Name
J: Effect (of move)
K: Poké Species Name
L: Title Color (Also in testing)
M: Move Name
N: Pokémon Name
O: (unused?)
P: Place Name
Q: (unused?)
R: Selling Price
S: Multiple Items Selected
T: Transparent
U: Unidentified Item
V: Number
W: Warning
X: Team name
Y: Team pokemon?
Z: Exclusive items

=lines=
A horizontal line width of window
[BAR]

=Pause during text display=
pause for tap, print the rest after interaction from the user
[K]
Pause at end, rest in new message
[C]

=Name replacers=
name of player
[hero]
name of partner
[partner]
name of player team
[team:]

[c_kind:<type>]
[c_name:<type>]
PLAYER: player
ATTENDANT1: partner/second on team
ATTENDANT2: 3rd person on team (not used in-game)
ATTENDANT3: 4th person on team (not used in-game)
NPC_HERO: Hero, used when hero is NPC (first time seen hero)
NPC_PARTNER: partner, used when partner is NPC or possibility of partner not in second slot
NPC_NEW_FRIEND: friend that just joined the team
NPC_MANAFI: manaphy
--tests--
NPC_TEST006: name of ?
NPC_TEST007: name of ?
--used in sky only?--
NPC_HERO_REAL: hero(player) name. Same as [player] in main story
NPC_PARTNER_REAL: (partner) name. Same as [partner] in main story
NPC_HERO_FIRST: hero(player) name. Same as [player] in main story, used in special missions
NPC_PARTNER_FIRST: (partner) name. Same as [partner] in main story, used in special missions

=Alignment=
following text is centered?
[CN]

=Font=
[FT:<int>]
0: all following text is normal text
1: all following text is unown text
2: all following text is buttons/same as B on the M format code, where the order in B is 'A-Za-z0-9' and two others. 64 in all.

Note: the [FT:?] format code doesn't reset at the end of a string. It stays in effect until a message with another format code is displayed.

=Objects=
[M:<type>] -- All of these (except the debug commands) can be accessed with B as well, only the "official" letter-numbers are used.
--buttons--
B0: Start
B1: Select
B2: A
B3: B
B4: X
B5: Y
B6: L
B7: R
B8: d-pad
--reg buttons--
B9: -
B10: o
B11: x
B12: ^
B13: v
B14: <
B15: >
B16: <<
B17: >>
B18: (list)
B19: (search)
B20: dpad updown
B21: dpad leftright
--gold buttons- (active)
B22: -
B23: o
B24: x
B25: ^
B26: v
B27: <
B28: >
B29: <<
B30: >>
B31: (list)
B32: (search)
--designs--
S0: Poké
S1: blank
S2: check
S3: Star
S4: x
S5: checkx
--hearts--
H0: pink heart 1/4
H1: pink heart 2/4
H2: pink heart 3/4
H3: pink heart 4/4
H4: yellow heart 1/4
H5: yellow heart 2/4
H6: yellow heart 3/4
H7: yellow heart 4/4
--dungeon?--
R0: -
R1: halfstar
R2: ? golden egg?
R3: closed letter
R4: open letter
R5: design?
R6: job post?
R7: new story dungeon
?R8: Wifi icon
?R9: email icon
--text?--
T0: :
T1: ' '
T2: chat balloon
T3: japanese chara
T4: different japanese chara
--items--
I0: TM (T5)
I1: Orb (T6)
--debug?--
D0: ? turn debug off?
D1: Used in wireless and debug mode text
D2: used rarely

=Links=
[LS:<integer>]
integer: which help info to link to

=Spaces=
integer determines how many pixels of space to leave.
[S:<int>]

Pmd2 SSB

2015-01-24T14:58:16Z

Nerketur: /* Const/String */ added more info, link to string format page.

SSB files are always found with an associated .[[Pmd2_SSA|SSA]], .SSE, or .SSS file, with the single exception of unionall.ssb, found in the '''/SCRIPT/COMMON/''' folder of the Nitro File System. These files contain the actual scripting code, much like the canon series of Pokémon games. The main differences are the number and format of these commands.

SSB files are all 16-bit word-based. Because of this, the file itself ''must'' be an even number of bytes, and in fact the string and constant tables have special rules to ensure this.

=Special cases=
==unionall==
This file is a very special case for two reasons. It does not have an SSA, SSE, or SSS file connected with it, and it stays in memory for the entire time scripts are being run.

This is the master script that is the first to run when the power is turned on, and handles all the scene changes, events, and anything else that can be scripted. The entire titlescreen is run with unionall.ssb, as is the entire game. It is the ONLY script that is called through ASM, and is put in a very special location in memory, staying there until the game is turned off.

When scripts end that this script calls, the script continues from where it left off, doing various things depending on the outcome of these scripts. More research needs to be done to find out everything this script does.

=File Format=
==Header==
{| class="wikitable"
|-
! Hex !! Short Name !! Description
|-
! 00
| numConst || The number of 'constants' in the file
|-
! 02
| numString || The number of 'strings' in the file
|-
! 04
| offsetConst || First const offset or beginning of string table
|-
! 06
| sizeConst || Size of the 'constant' table (in words)
|-
! 08
| sizeString || Size of the 'string' table (in words)
|-
! 0A
| unknown || Unknown
|-
! 0C
| rowspan="2" | data... || rowspan="2" | Script data
|-
! ...
|}

==Data==
===Header===
{| class="wikitable"
|-
! Hex !! Short Name !! Description
|-
! 00
| LEN || Length of data, usually first constant offset + 2*numConst
|-
! 02
| numGroups || The number of 'groups' in the file
|-
! 04
| rowspan="3" | entry... (numGroup entries) || rowspan="3" | Group entries
|-
! 06
|-
! 08
|-
! ...
| more groups if numGroups > 1 || extra groups, up to numGroups
|-
! ...
| commands... (LEN words) || Script commands area
|}

===Groups===
{| class="wikitable"
|-
! Hex !! Short Name !! Description
|-
! 00
| scriptLoc || Commands location (will always be at the start of a valid command)
|-
! 02
| type? || possibly the type of group? unsure
|-
! 04
| unknown || Unknown (char if type=3?)
|}

===Commands===
{{main|Table of PMD2 Scripting Commands}}
====Time/Darkness====
Time has 0x150 commands in total in its scripting subsystem. It is currently unknown what every one does, but a lot have been figured out.

====Sky====
Sky has 0x180 commands in total in its scripting subsystem. It is currently unknown what every one does, but a lot have been figured out. Also, EVERY command from Time is in these commands as well. This means there are 0x30 new commands introduced in Sky. Some of the old commands are also changed slightly.

The introduced commands were inserted into various locations in the time commands, which means the same command in Time/Darkness and Sky usually has two different command numbers. For example, 0x8B in Time is the same as 0x9D in Sky.

===Constants/strings tables===
If there is nothing in a particular table, then that table is omitted. The strings table strings are at (offset from string table) + (LEN)

The constant table strings have offsets as if they were part of the string table. Therefore, the constants are actually at (offset from const table) + (LEN) - (2 * numStrings). Another way of calculating the constants offset is assume the first offset leads to offsetConst, subtract the first offset from all the others and you will get the offset from offsetConst. Or (offset from const table) - (first offset from const table) + (offsetConst)

Regardless of the table, if the size in bytes of the table + offsets is an odd number, then an extra null byte is added to the end of the otherwise complete table before being stored.

===Constant table entry===
0000: (word) start of string + 2* num strings.

===String table entry===
0000: (word) start of string (from end of script section+1).

===Const/String===
The differences between these two types of strings are unknown. What is known is as follows:
* Every constant and every string is null-terminated.
* Constants are always in all-caps
* Strings can hold special [[PMD2 Strings|formatting instructions]] and be any conceivable length
* Commands that accept strings will also accept constants and display them as if they would a string.
* Commands that accept constants can conceivably accept strings, but it is unknown if this will work in most cases

=Notes=
==Constant Locations==
Constant offsets - 2*numStrings = actual constant locations.
It is unclear why this is the case, but it is clear that the script commands act as if constants and strings were all in the same big array.

User:Nerketur

2015-01-23T04:26:29Z

Nerketur: /* Project Pokémon */

Hi! I'm Nerketur, quite possibly the pioneer of PMD2 hacking. A long history, and just recently started helping out on this Wiki

=Goal=
Working on something is rather pointless if you don't have a goal to achieve, and my goal is no different. I started this project with the intent of adding in a battle with Team Skull. It's what motivates me to continue this effort, and I will not stop until I finally accomplish this task. A secondary goal is simply to learn as much as I can about PMD2, and a tertiary goal, is to make a tool that people can use to make their own hacks with. Seems I have my work cut out for me, no?

=Background=
I wasn't always interested in hacking. I've always been interested in programming and in computers, but my story here begins waaay back with PokéCommunity.

==Experience==
I currently am a masters student for Computer Science. I am very interested in how things work, and I program at least something almost every day!

===Programming languages===
I know far too many to count now, but my favorites are C#, Python, Ruby, Java, Go, and Euphoria.

Recently, I've started learning all about ARM assembler, and I'm fairly good at that now too! Really helps with reverse-engineering!

==History==
===PokéCommunity===
My saga starts here, with my first day on PokéCommunity. I got interested in Pokémon hacks, started a few tries on a hack of my own, but never really got too far with it. I eventually found PMD2, and fell in love with it. I wanted to learn everything I could.

===Pokémon Hacking===
And so I really truly got started in the hacking scene. I was experienced with all the tools for FireRed/LeafGreen, started a thread on mapping the entire game. I still haven't finished it, but I might try to in the future. That's when I decided to try to start trying to actually make a PMD2 hack. And it started out really bumpy.

===PMD2===
My first ever test of being a hacker/reverse engineer started with .SSB files. Started with the first few scenes in the game. Started with Time/Darkness, started with learning the scripting subsystem. And boy was there a lot to learn. The first command I learned was 0x0077, which meant character action. And all the other commands came from there.

===Hiatus===
After a while of coding, and releasing various updates to my tool that I made, I kind of dropped off of PC for a long while. A few months at least, and it took emails from PC to get me to realize that I was still a member there and people were counting on me to succeed. Every once in a while I was still tweaking my program, I wasn't about to let it die, but it turned into maybe once or twice a month. At least until my thread was locked. And that's when I started working on it again.

===I'm back!===
So I messaged most of my old friends, I cleaned up my code, and I finally updated my thread after so long. I was finally back in the game, and that's when I met someone important. He kept discussing things with me through my PC thread, and we finally exchanged Skype info, and have been in contact ever since! As it turns out, he's the one that keeps me actively figuring things out, even with College and things going on, finding a job, etc. I do have to thank him. And he's here, [[User:Psy commando|Psy commando]]. If it wasn't for him, I bet I'd have already been on another hiatus.

A second important person I re-met from before my hiatus, through dropbox. Man, I felt bad for forgetting about him, but as it turns out, the three of us are in a Skype group, and discuss a few things each day we get new info. Less than a year ago, I would have felt a team was pointless and unneccesary, but now, I feel its a vital reason so many things are getting done.

===Project Pokémon===
And that brings us to today. I was brought here by Psy, to finally get a few wiki pages up detailing my findings. I'm still sorting through things on my end to figure out what all to put here, and how to set it all up, but so far it's also been a great process, as it allowed me to learn more info than I knew before.

User:Nerketur

2015-01-23T04:25:36Z

Nerketur: /* I'm back! */ fixed up an area, added a few more tidbits of info.

Hi! I'm Nerketur, quite possibly the pioneer of PMD2 hacking. A long history, and just recently started helping out on this Wiki

=Goal=
Working on something is rather pointless if you don't have a goal to achieve, and my goal is no different. I started this project with the intent of adding in a battle with Team Skull. It's what motivates me to continue this effort, and I will not stop until I finally accomplish this task. A secondary goal is simply to learn as much as I can about PMD2, and a tertiary goal, is to make a tool that people can use to make their own hacks with. Seems I have my work cut out for me, no?

=Background=
I wasn't always interested in hacking. I've always been interested in programming and in computers, but my story here begins waaay back with PokéCommunity.

==Experience==
I currently am a masters student for Computer Science. I am very interested in how things work, and I program at least something almost every day!

===Programming languages===
I know far too many to count now, but my favorites are C#, Python, Ruby, Java, Go, and Euphoria.

Recently, I've started learning all about ARM assembler, and I'm fairly good at that now too! Really helps with reverse-engineering!

==History==
===PokéCommunity===
My saga starts here, with my first day on PokéCommunity. I got interested in Pokémon hacks, started a few tries on a hack of my own, but never really got too far with it. I eventually found PMD2, and fell in love with it. I wanted to learn everything I could.

===Pokémon Hacking===
And so I really truly got started in the hacking scene. I was experienced with all the tools for FireRed/LeafGreen, started a thread on mapping the entire game. I still haven't finished it, but I might try to in the future. That's when I decided to try to start trying to actually make a PMD2 hack. And it started out really bumpy.

===PMD2===
My first ever test of being a hacker/reverse engineer started with .SSB files. Started with the first few scenes in the game. Started with Time/Darkness, started with learning the scripting subsystem. And boy was there a lot to learn. The first command I learned was 0x0077, which meant character action. And all the other commands came from there.

===Hiatus===
After a while of coding, and releasing various updates to my tool that I made, I kind of dropped off of PC for a long while. A few months at least, and it took emails from PC to get me to realize that I was still a member there and people were counting on me to succeed. Every once in a while I was still tweaking my program, I wasn't about to let it die, but it turned into maybe once or twice a month. At least until my thread was locked. And that's when I started working on it again.

===I'm back!===
So I messaged most of my old friends, I cleaned up my code, and I finally updated my thread after so long. I was finally back in the game, and that's when I met someone important. He kept discussing things with me through my PC thread, and we finally exchanged Skype info, and have been in contact ever since! As it turns out, he's the one that keeps me actively figuring things out, even with College and things going on, finding a job, etc. I do have to thank him. And he's here, [[User:Psy commando|Psy commando]]. If it wasn't for him, I bet I'd have already been on another hiatus.

A second important person I re-met from before my hiatus, through dropbox. Man, I felt bad for forgetting about him, but as it turns out, the three of us are in a Skype group, and discuss a few things each day we get new info. Less than a year ago, I would have felt a team was pointless and unneccesary, but now, I feel its a vital reason so many things are getting done.

===Project Pokémon===
And that brings us to today. I was brought here by that same person, to finally get a few wiki pages up detailing my findings. I'm still sorting through things on my end to figure out what all to put here, and how to set it all up, but so far it's also been a great process, as it allowed me to learn more info than I knew before.

User:Nerketur

2015-01-23T04:19:26Z

Nerketur: created my user page! Because why not?

Hi! I'm Nerketur, quite possibly the pioneer of PMD2 hacking. A long history, and just recently started helping out on this Wiki

=Goal=
Working on something is rather pointless if you don't have a goal to achieve, and my goal is no different. I started this project with the intent of adding in a battle with Team Skull. It's what motivates me to continue this effort, and I will not stop until I finally accomplish this task. A secondary goal is simply to learn as much as I can about PMD2, and a tertiary goal, is to make a tool that people can use to make their own hacks with. Seems I have my work cut out for me, no?

=Background=
I wasn't always interested in hacking. I've always been interested in programming and in computers, but my story here begins waaay back with PokéCommunity.

==Experience==
I currently am a masters student for Computer Science. I am very interested in how things work, and I program at least something almost every day!

===Programming languages===
I know far too many to count now, but my favorites are C#, Python, Ruby, Java, Go, and Euphoria.

Recently, I've started learning all about ARM assembler, and I'm fairly good at that now too! Really helps with reverse-engineering!

==History==
===PokéCommunity===
My saga starts here, with my first day on PokéCommunity. I got interested in Pokémon hacks, started a few tries on a hack of my own, but never really got too far with it. I eventually found PMD2, and fell in love with it. I wanted to learn everything I could.

===Pokémon Hacking===
And so I really truly got started in the hacking scene. I was experienced with all the tools for FireRed/LeafGreen, started a thread on mapping the entire game. I still haven't finished it, but I might try to in the future. That's when I decided to try to start trying to actually make a PMD2 hack. And it started out really bumpy.

===PMD2===
My first ever test of being a hacker/reverse engineer started with .SSB files. Started with the first few scenes in the game. Started with Time/Darkness, started with learning the scripting subsystem. And boy was there a lot to learn. The first command I learned was 0x0077, which meant character action. And all the other commands came from there.

===Hiatus===
After a while of coding, and releasing various updates to my tool that I made, I kind of dropped off of PC for a long while. A few months at least, and it took emails from PC to get me to realize that I was still a member there and people were counting on me to succeed. Every once in a while I was still tweaking my program, I wasn't about to let it die, but it turned into maybe once or twice a month. At least until my thread was locked. And that's when I started working on it again.

===I'm back!===
So I messaged most of my old friends, I cleaned up my code, and I finally updated my thread after so long. I was finally back in the game, and that's when I met someone important. He kept discussing things with me through my PC thread, and we finally exchanged Skype info, and have been in contact ever since! As it turns out, he's the one that keeps me actively figuring things out, even with College and things going on, finding a job, etc. I do have to thank him. And he's here, [[User:Psy commando|Psy commando]]. If it wasn't for him,. I bet I'd have already been on another hiatus.

===Project Pokémon===
And that brings us to today. I was brought here by that same person, to finally get a few wiki pages up detailing my findings. I'm still sorting through things on my end to figure out what all to put here, and how to set it all up, but so far it's also been a great process, as it allowed me to learn more info than I knew before.

Table of PMD2 Scripting Commands

2015-01-23T00:41:03Z

Nerketur: created SSB command table, working on descriptions, might change colors soon, saving for now

{| class="wikitable" caption="Color code"
|-
! Color !! Meaning
|-
| bgcolor="blue" |   || sky only
|-
| bgcolor="green" |   || time only
|-
| bgcolor="grey" |   || name not formulated
|-
|   || everything (mostly) known
|}
If a row matches two or more colors, the higher color in the chart takes precedence.
{| class="wikitable"
|-
! Sky !! Time !! Short Name !! Len !! Description
|-
| 0 || 0 || NOP || 0 || Do nothing. Equivilant to nothing there.
|- bgcolor="grey"
| 1 || 1 ||   || 1 || ???
|- bgcolor="grey"
| 2 || 2 ||   || 1 || ???
|- bgcolor="grey"
| 3 || 3 ||   || 2 || ???
|-
| 4 || 4 || scroll? x x || 2 || pixels?:%v ?:%v
|- bgcolor="blue"
| 5 || --- ||   || 2 || ???
|- bgcolor="blue"
| 6 || --- || chaptTitle x x x x num title || 6 || rowspan="2" bgcolor="inherit" | Same command in both cases, the last two params of each are the chapter number and the string displayed as the chapter title. This is a large black screen with a blue line under the words "Chapter <num>", and the words in the specified title underneath that.
|- bgcolor="green"
| --- || 5 || chaptTitle num title || 2
|- bgcolor="grey"
| 7 || 6 ||   || 2 || ???
|-
| 8 || 7 || loadbottxt A B || 2 || Loads text to the bottom screen
|-
| 9 || 8 || loadbotpic A || 1 || Loads the specified pic 'A' to the bottom screen
|- bgcolor="blue"
| A || --- || sky:A || 2 || ???
|- bgcolor="blue"
| B || --- || sky:B || 2 || ???
|-
| C || 9 || centerwhite ypos str || 2 || The string 'str', in white, centered on a black background, where the y position is at 'ypos'.
|- bgcolor="blue"
| D || --- || sky:D || 2 || ???
|- bgcolor="grey"
| E || A ||   || 1 || ???
|- bgcolor="grey"
| F || B ||   || 1 || ???
|- bgcolor="grey"
| 10 || C ||   || 2 || ???
|- bgcolor="grey"
| 11 || D ||   || 2 || ???
|- bgcolor="grey"
| 12 || E ||   || 1 || ???
|- bgcolor="grey"
| 13 || F ||   || 2 || ???
|- bgcolor="grey"
| 14 || 10 ||   || 2 || ???
|- bgcolor="grey"
| 15 || 11 ||   || 2 || ???
|- bgcolor="grey"
| 16 || 12 ||   || 2 || ???
|-
| 17 || 13 || loadtoppic pic || 1 || rowspan="2" | loads a picture 'pic' to the top screen. Differences between these commands are unknown
|-
| 18 || 14 || loadtoppic2 pic || 1 ||
|- bgcolor="grey"
| 19 || 15 ||   || 3 || ???
|- bgcolor="grey"
| 1A || 16 ||   || 1 || ???
|- bgcolor="grey"
| 1B || 17 ||   || 1 || ???
|- bgcolor="grey"
| 1C || 18 ||   || 2 || ???
|- bgcolor="grey"
| 1D || 19 ||   || 2 || ???
|-
| 1E || 1A || bgmfadeout frames || 1 || fade out the current BGM playing in 'frames' frames.
|-
| 1F || 1B || bgmplay songID || 1 || play song 'songID' on in BGM
|-
| 20 || 1C || bgmfadein songID frames vol || 3 || Fade in song 'songID' in 'frames' frames to volume 'vol'.
|-
| 21 || 1D || bgmstop || 0 || Stop the curently playing BGM
|-
| 22 || 1E || bgmfadetovol frames vol || 2 || Fade the curent BM playing out to 'vol' in 'frames' frames.
|-
| 23 || 1F || bgm2fadeout frames || 1 || rowspan="5" | Same as the bgm counterpart, but with bgm2.
|-
| 24 || 20 || bgm2play songID || 1
|-
| 25 || 21 || bgm2fadein songID frames vol || 3
|-
| 26 || 22 || bgm2stop || 0
|-
| 27 || 23 || bgm2fadetovol frames vol || 2
|- bgcolor="grey"
| 28 || 24 ||   || 3 || ?:%x ?:%x %g
|-
| 29 || 25 || ifvartrue || 3 || vargroup?:%x var?:%x %g
|-
| 2A || 26 || checkdebug || 2 || ?:%v %g
|- bgcolor="grey"
| 2B || 27 ||   || 2 || ???
|- bgcolor="grey"
| 2C || 28 ||   || 2 || ???
|- bgcolor="grey"
| 2D || 29 ||   || 3 || ???
|-
| 2E || 2A || ifvar1? || 4 || ?:%x ?:%x ?:%x %g
|-
| 2F || 2B || checkstoryvar? || 4 || kind?:%x sect?:%x val:%x %g
|-
| 30 || 2C || ifvar3? || 4 || ?:%x ?:%x ?:%x %g
|-
| 31 || 2D || ifvar4? || 4 || ?:%x ?:%x ?:%x %g
|-
| 32 || 2E || ifvar5? || 4 || ?:%x ?:%x ?:%x %g
|- bgcolor="grey"
| 33 || 2F ||   || 4 || ???
|- bgcolor="grey"
| 34 || 30 ||   || 4 || ???
|- bgcolor="grey"
| 35 || 31 ||   || 4 || ???
|- bgcolor="grey"
| 36 || 32 ||   || 2 || ?:%x %g
|-
| 37 || 33 || call || 1 || %g
|-
| 38 || 34 || waittap? || 1 || ?:%x
|- bgcolor="grey"
| 39 || 35 ||   || 1 || ???
|- bgcolor="grey"
| 3A || 36 ||   || 1 || ???
|- bgcolor="grey"
| 3B || 37 ||   || 1 || ???
|- bgcolor="blue"
| 3C || --- ||   || ff || ???
|- bgcolor="grey"
| 3D || 38 ||   || 5 || ???
|- bgcolor="grey"
| 3E || 39 ||   || 1 || ???
|- bgcolor="grey"
| 3F || 3A ||   || 1 || ???
|- bgcolor="grey"
| 40 || 3B ||   || 1 || ???
|- bgcolor="blue"
| 41 || --- ||   || ff || ???
|- bgcolor="grey"
| 42 || 3C ||   || 5 || ???
|- bgcolor="grey"
| 43 || 3D ||   || 1 || ???
|- bgcolor="grey"
| 44 || 3E ||   || 1 || ???
|- bgcolor="grey"
| 45 || 3F ||   || 1 || ???
|- bgcolor="blue"
| 46 || --- ||   || ff || ???
|- bgcolor="grey"
| 47 || 40 ||   || 5 || ???
|- bgcolor="grey"
| 48 || 41 ||   || 0 || ???
|- bgcolor="grey"
| 49 || 42 ||   || 3 || ???
|- bgcolor="grey"
| 4A || 43 ||   || 0 || ???
|- bgcolor="grey"
| 4B || 44 ||   || 0 || ???
|-
| 4C || 45 || charpos || 4 || X:%v Y:%v X2:%v Y2:%v
|- bgcolor="grey"
| 4D || 46 ||   || 1 || ???
|- bgcolor="grey"
| 4E || 47 ||   || 1 || ???
|- bgcolor="grey"
| 4F || 48 ||   || 1 || ???
|- bgcolor="blue"
| 50 || --- ||   || ff || ???
|- bgcolor="grey"
| 51 || 49 ||   || 5 || ???
|- bgcolor="grey"
| 52 || 4A ||   || 1 || ???
|- bgcolor="grey"
| 53 || 4B ||   || 1 || ???
|- bgcolor="grey"
| 54 || 4C ||   || 1 || ???
|- bgcolor="blue"
| 55 || -- ||   || ff || ???
|- bgcolor="grey"
| 56 || 4D ||   || 5 || ???
|- bgcolor="grey"
| 57 || 4E ||   || 1 || ???
|- bgcolor="grey"
| 58 || 4F ||   || 1 || ???
|- bgcolor="grey"
| 59 || 50 ||   || 1 || ???
|- bgcolor="blue"
| 5A || --- ||   || ff || ???
|- bgcolor="grey"
| 5B || 51 ||   || 5 || ???
|- bgcolor="grey"
| 5C || 52 ||   || 0 || ???
|-
| 5D || 53 || imageanims? || 3 || ???
|- bgcolor="grey"
| 5E || 54 ||   || 0 || ???
|- bgcolor="grey"
| 5F || 55 ||   || 0 || ???
|-
| 60 || 56 || imagepos || 4 || C:%v R:%v X:%v Y:%v
|- bgcolor="blue"
| 61 || --- || sky:61 || 0 || ???
|- bgcolor="blue"
| 62 || --- || sky:62 || 1 || ???
|-
| 63 || 57 || case || 2 || %v %g
|-
| 64 || 58 || choice || 2 || '%s' %g
|- bgcolor="blue"
| 65 || --- || sky:65 || 2 || ???
|-
| 66 || 59 || ifvareq || 3 || var:%x val:%v %g
|-
| 67 || 5A || iftype || 2 || %d disp:'%s'
|-
| 68 || 5B || ifresult || 3 || #%x %d %g
|-
| 69 || 5C || ifresult2? || 3 || #%x %d %g
|- bgcolor="grey"
| 6A || 5D ||   || 1 || ???
|-
| 6B || 5E || runscript || 1 || '%s'
|-
| 6C || 5F || runscript2? || 2 || ?:%x '%s'
|- bgcolor="grey"
| 6D || 60 ||   || 2 || ???
|-
| 6E || 61 || else || 1 || '%s'
|-
| 6F || 62 || diganim? || 0 || ???
|-
| 70 || 63 || ENDSCRIPT || 0 || ???
|- bgcolor="blue"
| 71 || --- ||   || 0 || ???
|- bgcolor="grey"
| 72 || 64 ||   || 1 || ???
|- bgcolor="grey"
| 73 || 65 ||   || 2 || ???
|-
| 74 || 66 || setvar || 3 || vartype?:%x var:%x value:%d
|-
| 75 || 67 || giveuser? 3 words? || 3 || ?:%x ?:%x amt:%d
|- bgcolor="grey"
| 76 || 68 ||   || 3 || ???
|- bgcolor="grey"
| 77 || 69 ||   || 1 || ???
|- bgcolor="grey"
| 78 || 6A ||   || 1 || ???
|-
| 79 || 6B || partytest || 2 || position:%x char:%x
|- bgcolor="grey"
| 7A || 6C ||   || 0 || ???
|- bgcolor="grey"
| 7B || 6D ||   || 1 || ???
|- bgcolor="grey"
| 7C || 6E ||   || 1 || ???
|-
| 7D || 6F || dungeonmode || 2 || dungeon:%x, mode:%d
|- bgcolor="grey"
| 7E || 70 ||   || 2 || ???
|- bgcolor="grey"
| 7F || 71 ||   || 2 || ???
|-
| 80 || 72 || setstoryvar || 3 || kind:%x, sect:%x, val:%x
|- bgcolor="grey"
| 81 || 73 ||   || 0 || ???
|-
| 82 || 74 || return? || 0 || ???
|- bgcolor="blue"
| 83 || --- || sky:83 || 2 || ???
|- bgcolor="blue"
| 84 || --- || sky:84 || 3 || ???
|- bgcolor="blue"
| 85 || --- || sky:85 || 2 || ???
|- bgcolor="blue"
| 86 || --- || sky:86 || 2 || ???
|-
| 87 || 75 || goto || 1 || %g
|-
| 88 || 76 || gotogrp || 1 || %d
|-
| 89 || 77 || action || 1 || for:%x
|- bgcolor="grey"
| 8A || 78 ||   || 1 || ???
|- bgcolor="grey"
| 8B || 79 ||   || 1 || ???
|- bgcolor="grey"
| 8C || 7A ||   || 2 || ???
|-
| 8D || 7B || loadscene || 2 || scene:%v ?:%x
|- bgcolor="grey"
| 8E || 7C ||   || 2 || ???
|- bgcolor="grey"
| 8F || 7D ||   || 3 || ???
|- bgcolor="grey"
| 90 || 7E ||   || 1 || ???
|-
| 91 || 7F || dojo? || 2 || ???
|-
| 92 || 80 || dojo2? || 2 || ???
|-
| 93 || 81 || clearvar??? || 1 || var:%x
|- bgcolor="grey"
| 94 || 82 ||   || 1 || ???
|- bgcolor="grey"
| 95 || 83 ||   || 0 || ???
|-
| 96 || 84 || pausescript? || 0 || ???
|- bgcolor="grey"
| 97 || 85 ||   || 0 || ???
|-
| 98 || 86 || Msg(#86) || 1 || '%s'
|-
| 99 || 87 || pokepicpos || 2 || X:%v, Y:%v
|-
| 9A || 88 || Msg(#88) || 1 || '%s'
|- bgcolor="grey"
| 9B || 89 ||   || 0 || ???
|-
| 9C || 8A || msgmail || 1 || '%s'
|-
| 9D || 8B || special || 1 || %x
|-
| 9E || 8C || msgmonologue || 1 || '%s'
|-
| 9F || 8D || Msgdark || 2 || frames:%d '%s'
|-
| A0 || 8E || msgnotice || 1 || '%s'
|- bgcolor="grey"
| A1 || 8F ||   || 0 || ???
|-
| A2 || 90 || deletepicspeak || 0 || ???
|-
| A3 || 91 || speakchar || 1 || chara:%x
|-
| A4 || 92 || picspeakchar || 3 || chara:%x facetype:%x facepos:%x
|- bgcolor="grey"
| A5 || 93 ||   || 3 || ???
|-
| A6 || 94 || picchar || 3 || chara:%x facetype:%x facepos:%x
|-
| A7 || 95 || setfacepos || 1 || type:%x
|-
| A8 || 96 || wait? || 2 || ???
|- bgcolor="grey"
| A9 || 97 ||   || 1 || ???
|-
| AA || 98 || choicemsg || 2 || ?:%x choices:%d
|- bgcolor="blue"
| AB || --- || sky:AB || 3 || ???
|-
| AC || 99 || msgherosex || 1 || ???
|-
| AD || 9A || msgpartnertype || 1 || ???
|-
| AE || 9B || msgtalk || 1 || '%s'
|- bgcolor="grey"
| AF || 9C ||   || 3 || ???
|- bgcolor="grey"
| B0 || 9D ||   || 2 || ???
|- bgcolor="blue"
| B1 || --- ||   || ff || ???
|- bgcolor="grey"
| B2 || 9E ||   || 5 || ???
|- bgcolor="blue"
| B3 || --- || sky:B3 || ff || does FF mean not used? or really 255? maybe something special like multi-length? This is from the ROM
|-
| B4 || 9F || move1 || 3 || char:%d X:%v Y:%v
|- bgcolor="grey"
| B5 || A0 ||   || 3 || ???
|- bgcolor="grey"
| B6 || A1 ||   || 3 || ???
|- bgcolor="grey"
| B7 || A2 ||   || 2 || ???
|- bgcolor="blue"
| B8 || --- ||   || ff || ???
|- bgcolor="grey"
| B9 || A3 ||   || 5 || ???
|- bgcolor="blue"
| BA || --- ||   || ff || ???
|-
| BB || A4 || move2 || 3 || char:%d X:%v Y:%v
|- bgcolor="grey"
| BC || A5 ||   || 3 || ???
|-
| BD || A6 || movesinglebound || 3 || dist:%v mult:%v dir:%v
|- bgcolor="grey"
| BE || A7 ||   || 2 || ???
|- bgcolor="grey"
| BF || A8 ||   || 3 || ???
|- bgcolor="grey"
| C0 || A9 ||   || 2 || ???
|- bgcolor="grey"
| C1 || AA ||   || 3 || ???
|- bgcolor="blue"
| C2 || --- || sky:C2 || 10 (ff) || multi-length?
|-
| C3 || AB || movedest || 5 || ?:%x ?:%x ?:%x destX:%v destY:%v
|- bgcolor="grey"
| C4 || AC ||   || 6 || ???
|- bgcolor="blue"
| C5 || --- ||   || ff || ???
|-
| C6 || AD || moverel || 3 || ?:%x changeX:%v changeY:%v
|-
| C7 || AE || moveAE || 3 || ???
|-
| C8 || AF || moveAF || 3 || ???
|-
| C9 || B0 || objaction || 1 || obj:%x
|- bgcolor="blue"
| CA || --- || sky:CA || 1 || ???
|-
| CB || B1 || bgaction || 1 || bg:%x
|-
| CC || B2 || checkitem || 3 || what:%x item:%x
|- bgcolor="blue"
| CD || --- ||   || 4 || ???
|- bgcolor="blue"
| CE || --- ||   || 4 || ???
|- bgcolor="grey"
| CF || B3 ||   || 1 || ???
|- bgcolor="grey"
| D0 || B4 ||   || 1 || ???
|- bgcolor="grey"
| D1 || B5 ||   || 1 || ???
|- bgcolor="grey"
| D2 || B6 ||   || 1 || ???
|- bgcolor="grey"
| D3 || rowspan="2" | B7 ||   || rowspan="2" | 1 || rowspan="2" | ???
|- bgcolor="grey"
| D4 ||  
|- bgcolor="grey"
| D5 || B8 ||   || 0 || ???
|- bgcolor="grey"
| D6 || B9 ||   || 1 || ???
|-
| D7 || BA || fadeyellow || 4 || block:%d frames:%d from:%d to:%d
|- bgcolor="grey"
| D8 || BB ||   || 4 || ???
|-
| D9 || BC || fadeinbotbg || 2 || block:%d frames:%d
|-
| DA || BD || fadeinbotbg2? || 2 || block:%d frames:%d
|-
| DB || BE || fadeoutbotbg || 2 || block:%d frames:%d
|-
| DC || BF || fadeinbgm? || 2 || ???
|- bgcolor="grey"
| DD || C0 ||   || 8 || ???
|-
| DE || C1 || colorchangebotoff || 6 || block:%d frames:%d type:%x R:%d G:%d B:%d
|-
| DF || C2 || colorchangeboton || 6 || block:%d frames:%d type:%x R:%d G:%d B:%d
|- bgcolor="grey"
| E0 || C3 ||   || 4 || ???
|- bgcolor="grey"
| E1 || C4 ||   || 4 || ???
|- bgcolor="grey"
| E2 || C5 ||   || 2 || ???
|- bgcolor="grey"
| E3 || C6 ||   || 2 || ???
|-
| E4 || C7 || fadebotwhite || 2 || block:%d frames:%d
|- bgcolor="grey"
| E5 || C8 ||   || 2 || ???
|- bgcolor="grey"
| E6 || C9 ||   || 4 || ???
|- bgcolor="grey"
| E7 || CA ||   || 4 || ???
|-
| E8 || CB || fadeintopbg || 2 || block:%d frames:%d
|- bgcolor="grey"
| E9 || CC ||   || 2 || ???
|-
| EA || CD || fadeouttopbg || 2 || block:%d frames:%d
|- bgcolor="grey"
| EB || CE ||   || 2 || ???
|- bgcolor="grey"
| EC || CF ||   || 8 || ???
|-
| ED || D0 || colorchangetopoff || 6 || block:%d frames:%d type:%x R:%d G:%d B:%d
|-
| EE || D1 || colorchangetopon || 6 || block:%d frames:%d type:%x R:%d G:%d B:%d
|- bgcolor="grey"
| EF || D2 ||   || 4 || ???
|- bgcolor="grey"
| F0 || D3 ||   || 4 || ???
|- bgcolor="grey"
| F1 || D4 ||   || 2 || ???
|- bgcolor="grey"
| F2 || D5 ||   || 2 || ???
|- bgcolor="grey"
| F3 || D6 ||   || 2 || ???
|- bgcolor="grey"
| F4 || D7 ||   || 2 || ???
|- bgcolor="blue"
| F5 || --- || sepan || 3 || %x frames:%d pan?:%v
|- bgcolor="blue"
| F6 || --- || sevol || 3 || %x, frames:%d vol:%d
|-
| F7 || D8 || sefadeout || 2 || %x frames:%d
|-
| F8 || D9 || seplay || 1 || %x
|- bgcolor="blue"
| F9 || --- || seplayvolpan || 3 || %x vol:%d pan?:%v
|- bgcolor="blue"
| FA || --- || seplay2 || 2 || %x vol:%d
|- bgcolor="blue"
| FB || --- || seplay3 || 2 || %x vol:%d
|-
| FC || DA || sestop || 1 || %x
|- bgcolor="grey"
| FD || DB ||   || 1 || ???
|- bgcolor="grey"
| FE || DC ||   || 1 || ???
|- bgcolor="blue"
| FF || --- ||   || 2 || ???
|- bgcolor="grey"
| 100 || DD ||   || 1 || ???
|- bgcolor="grey"
| 101 || DE ||   || 2 || ???
|-
| 102 || DF || emoticon || 2 || %d ?:%x
|- bgcolor="grey"
| 103 || E0 ||   || 1 || ???
|- bgcolor="grey"
| 104 || E1 ||   || 1 || ???
|- bgcolor="grey"
| 105 || E2 ||   || 1 || ???
|- bgcolor="grey"
| 106 || E3 ||   || 6 || ???
|- bgcolor="grey"
| 107 || E4 ||   || 1 || ???
|- bgcolor="grey"
| 108 || E5 ||   || 2 || ???
|- bgcolor="grey"
| 109 || E6 ||   || 0 || ???
|- bgcolor="grey"
| 10A || E7 ||   || 1 || ???
|- bgcolor="grey"
| 10B || E8 ||   || 4 || ???
|- bgcolor="grey"
| 10C || E9 ||   || 2 || ???
|- bgcolor="grey"
| 10D || EA ||   || 2 || ???
|- bgcolor="grey"
| 10E || EB ||   || 1 || ???
|- bgcolor="grey"
| 10F || EC ||   || 3 || ???
|- bgcolor="blue"
| 110 || --- ||   || 3 || ???
|- bgcolor="grey"
| 111 || ED ||   || 2 || ???
|- bgcolor="blue"
| 112 || --- ||   || ff || ???
|- bgcolor="grey"
| 113 || EE ||   || 5 || ???
|- bgcolor="blue"
| 114 || --- ||   || ff || ???
|-
| 115 || EF || move5 || 3 || char:%v X:%v Y:%v
|- bgcolor="grey"
| 116 || F0 ||   || 3 || ???
|- bgcolor="grey"
| 117 || F1 ||   || 3 || ???
|- bgcolor="grey"
| 118 || F2 ||   || 2 || ???
|- bgcolor="blue"
| 119 || --- ||   || ff || ???
|- bgcolor="grey"
| 11A || F3 ||   || 5 || ???
|- bgcolor="blue"
| 11B || --- ||   || ff || ???
|-
| 11C || F4 || move6 || 3 || char:%d X:%v Y:%v
|- bgcolor="grey"
| 11D || F5 ||   || 3 || ???
|- bgcolor="grey"
| 11E || F6 ||   || 2 || ???
|- bgcolor="grey"
| 11F || F7 ||   || 3 || ???
|- bgcolor="grey"
| 120 || F8 ||   || 2 || ???
|- bgcolor="grey"
| 121 || F9 ||   || 3 || ???
|- bgcolor="blue"
| 122 || --- ||   || ff || ???
|- bgcolor="grey"
| 123 || FA ||   || 5 || ???
|- bgcolor="grey"
| 124 || FB ||   || 6 || ???
|- bgcolor="blue"
| 125 || --- ||   || ff || ???
|- bgcolor="grey"
| 126 || FC ||   || 3 || ???
|-
| 127 || FD || soundfadeout || 1 || frames:%d
|-
| 128 || FE || soundstop || 0 || ???
|- bgcolor="blue"
| 129 || --- || sky:129 || 0 || ???
|-
| 12A || FF || sectplace || 1 || %v
|- bgcolor="blue"
| 12B || --- || sky:12B || 1 || ???
|-
| 12C || 100 || execscript || 3 || '%f/%s' ?:%x
|-
| 12D || 101 || execscript2 || 3 || '%f/%s' ?:%x
|- bgcolor="grey"
| 12E || 102 ||   || 1 || ???
|- bgcolor="grey"
| 12F || 103 ||   || 1 || ???
|- bgcolor="grey"
| 130 || 104 ||   || 3 || ???
|-
| 131 || 105 || addvar || 2 || var:%x, val:%v
|- bgcolor="grey"
| 132 || 106 ||   || 2 || ???
|- bgcolor="grey"
| 133 || 107 ||   || 3 || ?:%x '%s' ?:%x
|- bgcolor="grey"
| 134 || 108 ||   || 1 || ???
|- bgcolor="blue"
| 135 || --- || runscript3? || 1 || '%s'
|- bgcolor="grey"
| 136 || 109 ||   || 2 || ???
|- bgcolor="grey"
| 137 || 10A ||   || 1 || ???
|-
| 138 || 10B || sectdel || 1 || %v
|-
| 139 || 10C || objdel || 1 || obj:%x
|- bgcolor="grey"
| 13A || 10D ||   || 3 || ???
|- bgcolor="grey"
| 13B || 10E ||   || 1 || ???
|-
| 13C || 10F || objadd || 1 || obj:%x
|- bgcolor="grey"
| 13D || 110 ||   || 1 || ???
|- bgcolor="grey"
| 13E || 111 ||   || 3 || ???
|-
| 13F || 112 || switchvar || 1 || (%x)
|- bgcolor="grey"
| 140 || 113 ||   || 1 || ???
|- bgcolor="grey"
| 141 || 114 ||   || 1 || ???
|- bgcolor="grey"
| 142 || 115 ||   || 1 || ???
|- bgcolor="grey"
| 143 || 116 ||   || 4 || ???
|- bgcolor="grey"
| 144 || 117 ||   || 1 || ???
|- bgcolor="grey"
| 145 || 118 ||   || 1 || ???
|- bgcolor="grey"
| 146 || 119 ||   || 1 || ???
|- bgcolor="grey"
| 147 || 11A ||   || 1 || ???
|-
| 148 || 11B || switchvar2 || 1 || (%x)
|-
| 149 || 11C || switchparam || 0 || ???
|- bgcolor="grey"
| 14A || 11D ||   || 3 || ???
|- bgcolor="grey"
| 14B || 11E ||   || 3 || ???
|-
| 14C || 11F || actfacedir(fast) || 3 || char:%x dir:%d ?:%x
|-
| 14D || 120 || move120 || 3 || char:%x ?:%x ?:%x
|-
| 14E || 121 || move121 || 3 || char:%x ?:%x ?:%x
|- bgcolor="grey"
| 14F || 122 ||   || 8 || ???
|- bgcolor="grey"
| 150 || 123 ||   || 3 || ???
|- bgcolor="blue"
| 151 || --- || sky:151 || 4 || ???
|- bgcolor="grey"
| 152 || 124 ||   || 1 || ???
|- bgcolor="grey"
| 153 || 125 ||   || 2 || ???
|- bgcolor="grey"
| 154 || 126 ||   || 2 || ???
|- bgcolor="grey"
| 155 || 127 ||   || 5 || ???
|-
| 156 || 128 || toggleextraact? || 1 || char:%x
|-
| 157 || 129 || delay || 1 || frames:%d
|-
| 158 || 12A || actraisehand || 0 || ???
|- bgcolor="grey"
| 159 || 12B ||   || 0 || ???
|- bgcolor="grey"
| 15A || 12C ||   || 0 || ???
|-
| 15B || 12D || bgmwait || 1 || %x
|-
| 15C || 12E || bgm2wait || 1 || %x
|- bgcolor="grey"
| 15D || 12F ||   || 0 || ???
|-
| 15E || 130 || norep || 0 || ???
|- bgcolor="blue"
| 15F || --- || sky:15F || 0 || ???
|-
| 160 || 131 || waitanim || 1 || char:%x
|- bgcolor="grey"
| 161 || 132 ||   || 1 || ???
|- bgcolor="grey"
| 162 || 133 ||   || 1 || ???
|- bgcolor="grey"
| 163 || 134 ||   || 0 || ???
|- bgcolor="grey"
| 164 || 135 ||   || 2 || ???
|- bgcolor="grey"
| 165 || 136 ||   || 2 || ???
|- bgcolor="grey"
| 166 || 137 ||   || 2 || ???
|- bgcolor="grey"
| 167 || 138 ||   || 1 || ???
|- bgcolor="grey"
| 168 || 139 ||   || 1 || ???
|- bgcolor="grey"
| 169 || 13A ||   || 0 || ???
|- bgcolor="grey"
| 16A || 13B ||   || 0 || ???
|- bgcolor="grey"
| 16B || 13C ||   || 2 || ???
|- bgcolor="grey"
| 16C || 13D ||   || 0 || ???
|- bgcolor="grey"
| 16D || 13E ||   || 0 || ???
|- bgcolor="grey"
| 16E || 13F ||   || 0 || ???
|-
| 16F || 140 || sewait || 1 || %x
|- bgcolor="grey"
| 170 || 141 ||   || 0 || ???
|-
| 171 || 142 || mapwaitanim || 0 || ???
|- bgcolor="grey"
| 172 || 143 ||   || 0 || ???
|-
| 173 || 144 || mapmarkflash || 1 || %x
|-
| 174 || 145 || clearcloudlev || 1 || %x
|-
| 175 || 146 || maparrowclear || 0 || ???
|-
| 176 || 147 || mapcameramove || 1 || %x
|-
| 177 || 148 || maplabelclear || 0 || ???
|-
| 178 || 149 || maparrowplace || 1 || %x
|-
| 179 || 14A || mapcharaplace || 1 || %x
|-
| 17A || 14B || loadmap || 1 || %d
|-
| 17B || 14C || mapmarkunflash || 1 || %x
|- bgcolor="grey"
| 17C || 14D ||   || 1 || ???
|-
| 17D || 14E || maplabelshow || 1 || %x
|-
| 17E || 14F || maptype || 1 || %x
|}

Pmd2 SSB

2015-01-21T16:32:30Z

Nerketur: added SSA link

SSB files are always found with an associated .[[Pmd2_SSA|SSA]], .SSE, or .SSS file, with the single exception of unionall.ssb, found in the '''/SCRIPT/COMMON/''' folder of the Nitro File System. These files contain the actual scripting code, much like the canon series of Pokémon games. The main differences are the number and format of these commands.

SSB files are all 16-bit word-based. Because of this, the file itself ''must'' be an even number of bytes, and in fact the string and constant tables have special rules to ensure this.

=Special cases=
==unionall==
This file is a very special case for two reasons. It does not have an SSA, SSE, or SSS file connected with it, and it stays in memory for the entire time scripts are being run.

This is the master script that is the first to run when the power is turned on, and handles all the scene changes, events, and anything else that can be scripted. The entire titlescreen is run with unionall.ssb, as is the entire game. It is the ONLY script that is called through ASM, and is put in a very special location in memory, staying there until the game is turned off.

When scripts end that this script calls, the script continues from where it left off, doing various things depending on the outcome of these scripts. More research needs to be done to find out everything this script does.

=File Format=
==Header==
{| class="wikitable"
|-
! Hex !! Short Name !! Description
|-
! 00
| numConst || The number of 'constants' in the file
|-
! 02
| numString || The number of 'strings' in the file
|-
! 04
| offsetConst || First const offset or beginning of string table
|-
! 06
| sizeConst || Size of the 'constant' table (in words)
|-
! 08
| sizeString || Size of the 'string' table (in words)
|-
! 0A
| unknown || Unknown
|-
! 0C
| rowspan="2" | data... || rowspan="2" | Script data
|-
! ...
|}

==Data==
===Header===
{| class="wikitable"
|-
! Hex !! Short Name !! Description
|-
! 00
| LEN || Length of data, usually first constant offset + 2*numConst
|-
! 02
| numGroups || The number of 'groups' in the file
|-
! 04
| rowspan="3" | entry... (numGroup entries) || rowspan="3" | Group entries
|-
! 06
|-
! 08
|-
! ...
| more groups if numGroups > 1 || extra groups, up to numGroups
|-
! ...
| commands... (LEN words) || Script commands area
|}

===Groups===
{| class="wikitable"
|-
! Hex !! Short Name !! Description
|-
! 00
| scriptLoc || Commands location (will always be at the start of a valid command)
|-
! 02
| type? || possibly the type of group? unsure
|-
! 04
| unknown || Unknown (char if type=3?)
|}

===Commands===
{{main|Table of PMD2 Scripting Commands}}
====Time/Darkness====
Time has 0x150 commands in total in its scripting subsystem. It is currently unknown what every one does, but a lot have been figured out.

====Sky====
Sky has 0x180 commands in total in its scripting subsystem. It is currently unknown what every one does, but a lot have been figured out. Also, EVERY command from Time is in these commands as well. This means there are 0x30 new commands introduced in Sky. Some of the old commands are also changed slightly.

The introduced commands were inserted into various locations in the time commands, which means the same command in Time/Darkness and Sky usually has two different command numbers. For example, 0x8B in Time is the same as 0x9D in Sky.

===Constants/strings tables===
If there is nothing in a particular table, then that table is omitted. The strings table strings are at (offset from string table) + (LEN)

The constant table strings have offsets as if they were part of the string table. Therefore, the constants are actually at (offset from const table) + (LEN) - (2 * numStrings). Another way of calculating the constants offset is assume the first offset leads to offsetConst, subtract the first offset from all the others and you will get the offset from offsetConst. Or (offset from const table) - (first offset from const table) + (offsetConst)

Regardless of the table, if the size in bytes of the table + offsets is an odd number, then an extra null byte is added to the end of the otherwise complete table before being stored.

===Constant table entry===
0000: (word) start of string + 2* num strings.

===String table entry===
0000: (word) start of string (from end of script section+1).

===Const/String===
Constants/Strings are null-terminated.

=Notes=
==Constant Locations==
Constant offsets - 2*numStrings = actual constant locations.
It is unclear why this is the case, but it is clear that the script commands act as if constants and strings were all in the same big array.

Pmd2 SSB

2015-01-21T16:28:40Z

Nerketur: created SSB page with link to table page that will be created for scripting commands.

SSB files are always found with an associated .SSA, .SSE, or .SSS file, with the single exception of unionall.ssb, found in the '''/SCRIPT/COMMON/''' folder of the Nitro File System. These files contain the actual scripting code, much like the canon series of Pokémon games. The main differences are the number and format of these commands.

SSB files are all 16-bit word-based. Because of this, the file itself ''must'' be an even number of bytes, and in fact the string and constant tables have special rules to ensure this.

=Special cases=
==unionall==
This file is a very special case for two reasons. It does not have an SSA, SSE, or SSS file connected with it, and it stays in memory for the entire time scripts are being run.

This is the master script that is the first to run when the power is turned on, and handles all the scene changes, events, and anything else that can be scripted. The entire titlescreen is run with unionall.ssb, as is the entire game. It is the ONLY script that is called through ASM, and is put in a very special location in memory, staying there until the game is turned off.

When scripts end that this script calls, the script continues from where it left off, doing various things depending on the outcome of these scripts. More research needs to be done to find out everything this script does.

=File Format=
==Header==
{| class="wikitable"
|-
! Hex !! Short Name !! Description
|-
! 00
| numConst || The number of 'constants' in the file
|-
! 02
| numString || The number of 'strings' in the file
|-
! 04
| offsetConst || First const offset or beginning of string table
|-
! 06
| sizeConst || Size of the 'constant' table (in words)
|-
! 08
| sizeString || Size of the 'string' table (in words)
|-
! 0A
| unknown || Unknown
|-
! 0C
| rowspan="2" | data... || rowspan="2" | Script data
|-
! ...
|}

==Data==
===Header===
{| class="wikitable"
|-
! Hex !! Short Name !! Description
|-
! 00
| LEN || Length of data, usually first constant offset + 2*numConst
|-
! 02
| numGroups || The number of 'groups' in the file
|-
! 04
| rowspan="3" | entry... (numGroup entries) || rowspan="3" | Group entries
|-
! 06
|-
! 08
|-
! ...
| more groups if numGroups > 1 || extra groups, up to numGroups
|-
! ...
| commands... (LEN words) || Script commands area
|}

===Groups===
{| class="wikitable"
|-
! Hex !! Short Name !! Description
|-
! 00
| scriptLoc || Commands location (will always be at the start of a valid command)
|-
! 02
| type? || possibly the type of group? unsure
|-
! 04
| unknown || Unknown (char if type=3?)
|}

===Commands===
{{main|Table of PMD2 Scripting Commands}}
====Time/Darkness====
Time has 0x150 commands in total in its scripting subsystem. It is currently unknown what every one does, but a lot have been figured out.

====Sky====
Sky has 0x180 commands in total in its scripting subsystem. It is currently unknown what every one does, but a lot have been figured out. Also, EVERY command from Time is in these commands as well. This means there are 0x30 new commands introduced in Sky. Some of the old commands are also changed slightly.

The introduced commands were inserted into various locations in the time commands, which means the same command in Time/Darkness and Sky usually has two different command numbers. For example, 0x8B in Time is the same as 0x9D in Sky.

===Constants/strings tables===
If there is nothing in a particular table, then that table is omitted. The strings table strings are at (offset from string table) + (LEN)

The constant table strings have offsets as if they were part of the string table. Therefore, the constants are actually at (offset from const table) + (LEN) - (2 * numStrings). Another way of calculating the constants offset is assume the first offset leads to offsetConst, subtract the first offset from all the others and you will get the offset from offsetConst. Or (offset from const table) - (first offset from const table) + (offsetConst)

Regardless of the table, if the size in bytes of the table + offsets is an odd number, then an extra null byte is added to the end of the otherwise complete table before being stored.

===Constant table entry===
0000: (word) start of string + 2* num strings.

===String table entry===
0000: (word) start of string (from end of script section+1).

===Const/String===
Constants/Strings are null-terminated.

=Notes=
==Constant Locations==
Constant offsets - 2*numStrings = actual constant locations.
It is unclear why this is the case, but it is clear that the script commands act as if constants and strings were all in the same big array.

Pokémon Mystery Dungeon Explorers

2015-01-21T11:51:31Z

Nerketur: Changed links to point to the same page (because SSA, SSE, and SSS files are the same format.)

[[Category:Incomplete Articles]]
[[Category:ROM Hacking]]
[[Category:Technical References]]
{{DISPLAYTITLE:Pokémon Mystery Dungeon : Explorers of Sky/Time/Darkness}}

== General Information ==
This page contains data on the Pokémon Mystery Dungeon: Explorers of Sky/Time/Darkness games.

== ROM File Structure ==
A detailed list of the file structure of the ROM's nitro-fs filesystem.

*Note: A lot of files in the ROM have an identifier that correspond to which level/event/cutscene/etc, they're used in. Something like: "s17p01" for example.

First/Second level directories:
: '''/BACK/'''
:: Contains large compressed [[pmd2_BGP|BGP]] images. Some of those appear on the main menu, some later during the game.
:: In Explorers of Sky, the backgrounds used in Explorers of Time and Darkness are present but unused.
: '''/BALANCE/'''
:: Seems to contain value relative to pokemon stats and various information about levels/dungeons.
: '''/DUNGEON/'''
:: Contains what seems to be some dungeon tiles.
: '''/DWC/'''
:: Data for the standard NDS Wifi setup screen.
: '''/EFFECT/'''
:: Contains some of the effect sprites.
: '''/FONT/'''
:: Contains fonts, UI element resources, palettes, and the portraits for the talking pokemon during the game.
: '''/GROUND/'''
:: Contains various sprites, apparently mostly for decorating the maps.
: '''/MAP_BG/'''
:: Contains what seems to be map tiles.
: '''/MESSAGE/'''
:: Contains the strings for most of the game!
: '''/MONSTER/'''
:: Contains the pokemon sprites for battle and the "overworld".
: '''/RESCUE/'''
:: Possibly linked to SOS code generation.
: '''/SCRIPT/'''
:: Contains the scripts for the whole game. Each directories has an identifier related to the context it takes place in.
: '''/SOUND/BGM/'''
:: Contains the main instrument sounds bank, "bgm.swd", and all the music in the game. With each tracks being a pair of a [[pmd2_SMDL|SMD]] and [[pmd2_SWDL|SWD]] file.
: '''/SOUND/ME/'''
::
: '''/SOUND/SE/'''
::
: '''/SOUND/SWD/'''
:: A bunch of sound effects stored as [[pmd2_SWDL|SWD]]s
: '''/SYSTEM/'''
::
: '''/SYNTH/'''
:: Possibly data for the swap cauldron.
: '''/SYSTEM/'''
::
: '''/TABLEDAT/'''
::
: '''/TOP/'''
:: Contains [[pmd2_BGP|BGP]] files for the backgrounds used in Pokémon Mystery Dungeon: Blue Rescue Team.
:: It can be deleted with no immediately apparent side effects, as the backgrounds are unused.

== ROM Overlays Details ==
A list of all the overlays, and what they're used for.

===== NDS9/ARM9 Overlays( Explorers of Sky ): =====

: '''Overlay #00''':
:* RAM Load address: 0x022BCA80
:* Length in RAM: 395,680 bytes
:* Description: Possibly contains data and code related to wifi multiplayer.

: '''Overlay #01''':
:* RAM Load address: 0x02329520
:* Length in RAM: 77,088 bytes
:* Description: Seems related to wifi rescue. It mentions several files from the GROUND and BACK folders:
:** 0x11ab8 : "BACK/expback.bgp"
:** 0x11b00 : "BACK/s07p02a.bgp"
:** 0x11b38 : "BACK/expback.bgp"
:** 0x11b70 : "BACK/expback.bgp"
:** 0x11b84 : "GROUND/s18p01a4.wan"
:** 0x11b98 : "GROUND/s18p01a2.wan"
:** 0x11bac : "GROUND/s18p01a3.wan"
:** 0x11be4 : "GROUND/s18p01a1.wan"
:** 0x11bf8 : "BACK/s18p01a.bgp"

: '''Overlay #02''':
:* RAM Load address: 0x02329520
:* Length in RAM: 176,032 bytes
:* Description: Most likely code for the Nintendo wifi setup.

: '''Overlay #03''':
:* RAM Load address: 0x0233CA80
:* Length in RAM: 41,312 bytes
:* Description: Unknown so far. Contains a single mention of "TABLEDAT/item00.dat" at 0xA078.

: '''Overlay #04''':
:* RAM Load address: 0x0233CA80
:* Length in RAM: 11,232 bytes
:* Description: Unknown so far. Contains a single mention of "TABLEDAT/item00.dat" at 0x2BA4.

: '''Overlay #05''':
:* RAM Load address: 0x0233CA80
:* Length in RAM: 12,864 bytes
:* Description: Unknown so far. Contain a single line of dialog formated text "[CS:X][string:0][CR][CLUM_SET:88][rank:0]" at 0x31EC

: '''Overlay #06''':
:* RAM Load address: 0x0233CA80
:* Length in RAM: 9,312 bytes
:* Description: Probably linked to WiFi rescue. Found those strings:
:** 0x2354 : "Mysterious WiFi: Illegal Identifier"
:** 0x237C : "Mysterious WiFi: Difference Version"
:** 0x23A4 : "Mysterious WiFi: Difference Language"
:** 0x23CC : "Mysterious WiFi: Difference Check Sum: 0x%08x 0x%08x"
:** 0x2404 : "Mysterious WiFi: Illegal Data"

: '''Overlay #07''':
:* RAM Load address: 0x0233CA80
:* Length in RAM: 20,736 bytes
:* Description: Unknown so far.

: '''Overlay #08''':
:* RAM Load address: 0x0233CA80
:* Length in RAM: 8,704 bytes
:* Description: Seems related to WiFi communications, from the string search results.

: '''Overlay #09''':
:* RAM Load address: 0x0233CA80
:* Length in RAM: 11,648 bytes
:* Description: Unknown this far. Has a single mention of "BACK/s18p02a.bgp" at 0x2D00

: '''Overlay #10''':
:* RAM Load address: 0x022BCA80
:* Length in RAM: 128,928 bytes
:* Description: Unknown this far. Some interesting strings:
:** 0x1F58C : "Lv. %d"
:** 0x1F594 : "[value:0:3]/[value:1:3]"
:** 0x1F5AC : "Lv. %d [CLUM_SET:44][value:0:3]/[value:1:3]"
:** 0x1F5D8 : "%s[CLUM_SET:70]%s"
:** 0x1F5EC : "/DUNGEON/sub2.bgp"
:** 0x1F600 : "/DUNGEON/sub.bgp"
:** 0x1F614 : "MainGame enter dungeon mode %d %d"
:** 0x1F638 : "dungeon fade out mode %d"
:** 0x1F654 : "dungeon getout result %d"
:** 0x1F694 : "rom0:BALANCE/mappa_gs.bin"
:** 0x1F6B0 : "dungeon map index %3d floor %3d -> dg index %3d floor max %3d -> bg index %3d table index %3d"
:** 0x1F710 : "rom0:BALANCE/fixed.bin"

: '''Overlay #11''':
:* RAM Load address: 0x022DC240
:* Length in RAM: 298,048 bytes
:* Description: Most likely the script engine for the game !

: '''Overlay #12''':
:* RAM Load address: 0x0238A140
:* Length in RAM: 32 bytes
:* Description: Empty, 32 bytes of zeros.

: '''Overlay #13''':
:* RAM Load address: 0x0238A140
:* Length in RAM: 11,904 bytes
:* Description: Controls the personality test, including the available partners and playable Pokémon. Personality test questions are stored in the MESSAGE folder.

: '''Overlay #14''':
:* RAM Load address: 0x0238A140
:* Length in RAM: 15,072 bytes
:* Description: Probably what runs the gatekeeper mini-game(String search returned mention of footprints).

: '''Overlay #15''':
:* RAM Load address: 0x0238A140
:* Length in RAM: 4,192 bytes
:* Description: Possibly has to do with Duskull's bank. Got this "Menu_Bank_Mode_Cancel" at 0xFB4.

: '''Overlay #16''':
:* RAM Load address: 0x0238A140
:* Length in RAM: 11,552 bytes
:* Description: Possibly linked to the Chimecho's assembly menu. Got this string "menuMonsterPictureBook_IsBusy busy" at 0x2CC4.

: '''Overlay #17''':
:* RAM Load address: 0x0238A140
:* Length in RAM: 7,392 bytes
:* Description: Unknown this far.

: '''Overlay #18''':
:* RAM Load address: 0x0238A140
:* Length in RAM: 13,568 bytes
:* Description: Unknown this far.

: '''Overlay #19''':
:* RAM Load address: 0x0238A140
:* Length in RAM: 16,960 bytes
:* Description: Possibly linked to Spinda's cafe.

: '''Overlay #20''':
:* RAM Load address: 0x0238A140
:* Length in RAM: 12,288 bytes
:* Description: Unknown this far.

: '''Overlay #21''':
:* RAM Load address: 0x0238A140
:* Length in RAM: 11,808 bytes
:* Description: Most likely for the swap shop menu.

: '''Overlay #22''':
:* RAM Load address: 0x0238A140
:* Length in RAM: 19,264 bytes
:* Description: Most likely for the Keckleon shop menu.

: '''Overlay #23''':
:* RAM Load address: 0x0238A140
:* Length in RAM: 14,208 bytes
:* Description: Most likely for the Kangashkan storage menu.

: '''Overlay #24''':
:* RAM Load address: 0x0238A140
:* Length in RAM: 9,440 bytes
:* Description: Unknown this far.

: '''Overlay #25''':
:* RAM Load address: 0x0238A140
:* Length in RAM: 5,312 bytes
:* Description: Unknown this far.

: '''Overlay #26''':
:* RAM Load address: 0x0238A140
:* Length in RAM: 3,648 bytes
:* Description: Unknown this far.

: '''Overlay #27''':
:* RAM Load address: 0x0238A140
:* Length in RAM: 11,616 bytes
:* Description: Most likely another menu for item handling storage..

: '''Overlay #28''':
:* RAM Load address: 0x0238A140
:* Length in RAM: 3,168 bytes
:* Description: Unknown this far.

: '''Overlay #29''':
:* RAM Load address: 0x022DC240
:* Length in RAM: 488,992 bytes
:* Description: Possibly having to do with running the in-dungeon game. Spotted strings for the in-dungeon menu.

: '''Overlay #30''':
:* RAM Load address: 0x02382820
:* Length in RAM: 14,496 bytes
:* Description: Unknown this far.

: '''Overlay #31''':
:* RAM Load address: 0x02382820
:* Length in RAM: 31,360 bytes
:* Description: Possibly the tactics menu.

: '''Overlay #32''':
:* RAM Load address: 0x02382820
:* Length in RAM: 32 bytes
:* Description: Empty, 32 bytes of zeros.

: '''Overlay #33''':
:* RAM Load address: 0x02382820
:* Length in RAM: 32 bytes
:* Description: Empty, 32 bytes of zeros.

: '''Overlay #34''':
:* RAM Load address: 0x022DC240
:* Length in RAM: 3,680 bytes
:* Description: Possibly having to do with launching the game. There are mention in the strings of the ERSB logo and the "n_logo" logo.

: '''Overlay #35''':
:* RAM Load address: 0x022BCA80
:* Length in RAM: 32 bytes
:* Description: Empty, 32 bytes of zeros.

== File/Data Formats ==
A list of all the file/data formats used in the game.

;Graphics Formats:
: [[pmd2_BGP|BGP]]
: [[pmd2_WAN|WAN]]
: [[pmd2_WBA|WBA]]
: [[pmd2_W16|W16]]
: [[pmd2_WTE_and_WTU|WTE and WTU]]
: [[pmd2_CHR|CHR]]
: [[pmd2_PAL|PAL]]
: [[pmd2_BMA|BMA]]
: [[pmd2_BPC|BPC]]
: [[pmd2_BPL|BPL]]
: [[pmd2_BPA|BPA]]
: [[pmd2_smd_img|SMD(image)]]
: [[pmd2_sma|SMA]]
;Audio Formats:
: [[pmd2_SWDL|SWD]]
: [[pmd2_SMDL|SMD(Music Sequence)]]
: [[pmd2_SEDL|SED]]
;Data Formats:
: [[pmd2_BIN|BIN]]
: [[pmd2_DAT|DAT]]
: [[pmd2_monster.md|MD]]
: [[pmd2_tbl_talk.tlk|TLK]]
: [[pmd2_text_strings|STR]]
;Script Engine Formats
: [[pmd2_SSB|SSB]]
: [[pmd2_SSA|SSA]]
: [[pmd2_SSA|SSS]]
: [[pmd2_SSA|SSE]]
: [[pmd2_LSD|LSD]]
;Container Formats:
: [[pmd2_BIN_pack|BIN]](pack files)
: [[pmd2_kaomado.kao|KAO]]
: [[pmd2_SIR0|SIR0]]
;Compressed Container Formats:
: [[pmd2_AT4PX|AT4PX]]
: [[pmd2_AT4PN|AT4PN]]
: [[pmd2_PKDPX|PKDPX]]
;Misc:
: [[pmd2_DIC|DIC]]
: [[pmd2_SRL|SRL]]

Additionally, several files have a file extension that doesn't match their content. For example, "/SYSTEM/hsd_jap.dat" and "/SYSTEM/hsd_eng.dat" are AT4PX files, but their extension is ".dat".

== Files with Unique Formats ==
A list of files that have their own unique format.

* /BALANCE/[[pmd2_monster.md|monster.md]]
* /FONT/[[pmd2_kaomado.kao|kaomado.kao]]
* /MESSAGE/[[pmd2_tbl_talk.tlk|tbl_talk.tlk]]
* /MESSAGE/[[pmd2_text_strings|text_*.str]]
* /RESCUE/[[pmd2_rescue.bin|rescue.bin]]
* /SYNTH/[[pmd2_synth.bin|synth.bin]]

Pmd2 SSA

2015-01-21T11:46:57Z

Nerketur: started page for SSA/SSS/SSE files

.SSA, .SSE, and .SSS files all use the exact same format, and as far as is currently known all do the same things. The only differences appear to be which links exist. These files and their respectively named [[Pmd2 SSB|.SSB]] files are effectively linked, as within the script they are not called by extension, but by name.

These are ''never'' found alone. They are like C/C++ .h files, in that they are connected to a certain file, and therefore useless by themselves. They are used to determine the starting positions of Pokémon, backgrounds, and interactable areas (including ones that you simply move into to interact). There are still some secrets that are unknown, however.

All data contained in these files is in groups of words. {{wplink|Word_(computer_architecture)|Word}} (as defined here) refers to the '''16-bit word''', or the values between 0x0000 and 0xFFFF inclusive. It is also referred to as a ''short'' in most common programming languages (on 32-bit OS's and above), or a 'halfword' as in the ARM processors used in the NDS.

=Specifics=
==SSE==
The only known .SSE file is 'enter.sse' All known links from this file go to other enter files, 'enterXX.ssb', and the files are all linked. All the Pokémon, backgrounds, etc. in this file are used as initial positions for all enter files.

This file will always exist in every subfolder of '''/SCRIPT/''', that describes an area that can be entered by the player during normal play. (some folders contain visual effects, or only cutscenes)

==SSS==
There are two types of .SSS files. The first is 'umXX.sss', and the second is 'usXX.sss'. In both cases, the XX can stand for any decimal number. Differences between the two types are unknown at this time.

===umXX.sss===
These are linked to all the umXXYY.ssb files where XX is the same in both files. The links themselves are determined in the .SSS file

===usXX.sss===
These are linked to all the usXXYY.ssb files where XX is the same in both files. The links themselves are determined in the .SSS file

==SSA==
Every other known .SSB file, with one exception, has this file as a "metafile" of sorts, showing all initial locations, background areas, etc. A file named 'm22a0201.ssb', for example, would have 'm22a0201.ssa' as this file. The sole exception to this rule is [[Pmd2 SSB#unionall|unionall.ssb]], contained inside the '''/SCRIPT/COMMON/''' folder. It has no .SSA, .SSE, or .SSS file connected with it.
=File Format=
Items with question-marks are unknown at this time, but believed. Short names are only to give a simple mnemonic to remember by. These names are not used inside the game
==Header==
:{| class="wikitable"
|-
! Hex !! Short Name !! Description
|-
! 0000
| numGroups (N) || The number of 'groups' in the file (N)
|-
! 0002
| dataOffset (Z) || Length of non-groups/start of groups (Z)
|-
! 0004
| unkn (A) || Start of something (only enter.sse?)
|-
! 0006
| pokéPos (B) || Pokémon posititions
|-
! 0008
| objPos (C) || Object positions
|-
! 000A
| backPos (D) || Default backgrounds (pos?)
|-
! 000C
| unknown (E) || Start of third non-6 group
|-
! 000E
| movements (F) || Start of movements (actions)
|-
! 0010
| 4wordsLoc (G) || start of 4 unknown words (usually 9, -1, -1, -1)
|}
==A words from start==
This is apparently usually only used in enter.sse.
:{| class="wikitable"
|-
! Hex !! Short Name !! Description
|-
! 00
| unknown1 || rowspan="3" | Unknown
|-
! 02
| unknown2
|-
! 04
| unknown3
|-
! 06
| entryNum || Number entry (enterXX.ssb if enter.sse) to go to.
|}
'''B words from start:''' (chara group)
:{| class="wikitable"
|-
! Hex !! Short Name !! Description
|-
! 00
| pokémon || Pokémon to change
|-
! 02
| faceDir || Direction to face
|-
! 04
| xPos || X coordinate -- 8 pixel increments. -- 0 = half of shadow there
|-
! 06
| yPos || Y coordinate -- 0 = Shadow 1 pixel down
|-
! 08
| xOffset || x offset? 0-1, 2-3, 4-7 = 0, 4, 16
|-
! 0A
| yOffset || y offset? 0-1, 2-3, 4-7 = 0, 4, invis
|-
! 0C
| entryNum || Numbered entry (XX in enterXX.ssb if enter.sse), usually FFFF (means none)
|-
! 0E
| unknown || Unknown, usually FFFF
|}
==C words from start:==
This group works with objects. Each group of 8 words defines a new object, and has the following structure:
:{| class="wikitable"
|-
! Hex !! Short Name !! Description
|-
! 00
| object || Object to change
|-
! 02
| unknown1 || rowspan="3" | Unknown
|-
! 04
| unknown2
|-
! 06
| unknown3
|-
! 08
| xPos || X coordinate -- 8 pixel increments. -- 0 = half of shadow there
|-
! 0A
| yPos || Y coordinate -- 0 = Shadow 1 pixel down
|-
! 0C
| xOffset || x offset? 0-1, 2-3, 4-7 = 0, 4, ?
|-
! 0E
| yOffset || y offset? 0-1, 2-3, 4-7 = 0, 4, ?
|-
! 10
| entryNum || Numbered entry (XX in enterXX.ssb if enter.sse) to run on interact, usually FFFF (means none)
|-
! 12
| unknown4 || Unknown, usually FFFF
|}
==D words from start==
Deals with backgrounds.
:{| class="wikitable"
|-
! Hex !! Short Name !! Description
|-
! 00
| object || Spot used in code B1 (EoT/EoD)
|-
! 02
| unknown1 || rowspan="3" | Unknown
|-
! 04
| unknown2
|-
! 06
| unknown3
|-
! 08
| xPos || X coordinate -- 8 pixel increments.
|-
! 0A
| yPos || Y coordinate
|-
! 0C
| xOffset || x offset? 0-1, 2-3, 4-7 = 0, 4, ?
|-
! 0E
| yOffset || y offset? 0-1, 2-3, 4-7 = 0, 4, ?
|-
! 10
| entryNum || Numbered entry (XX in enterXX.ssb if enter.sse) to run on interact, usually FFFF (means none)
|-
! 12
| unknown4 || Unknown, usually FFFF
|}
==E words from start==
:{| class="wikitable"
|-
! Hex !! Short Name !! Description
|-
! 00
| what? || What to change?
|-
! 02
| unknown1 || Possibly facing?
|-
! 04
| xPos? || X coordinate?
|-
! 06
| yPos? || Y coordinate?
|-
! 08
| xOffset? || x offset?
|-
! 0A
| yOffset? || y offset?
|-
! 0C
| entryNum? || All that is known is this is NOT enterXX.ssb numbers
|-
! 0E
| unknown2 || Unknown, usually FFFF
|}
==F words from start==
Deals with movements.
:{| class="wikitable"
|-
! Hex !! Short Name !! Description
|-
! 00
| xPos? || X coordinate? -- 8 pixel increments.
|-
! 02
| yPos? || Y coordinate?
|-
! 04
| xOffset? || x offset?
|-
! 06
| yOffset? || y offset?
|-
! 08
| unknown1 || rowspan="4" | Unknown
|-
! 0A
| unknown2
|-
! 0C
| unknown3
|-
! 0E
| unknown4
|}
==G words from start==
:{| class="wikitable"
|-
! Hex !! Short Name !! Description
|-
! 00
| unknown1 (9) || Usually 0009
|-
! 02
| unknown2 (-1) || rowspan="3" | Usually FFFF
|-
! 04
| unknown3 (-1)
|-
! 06
| unknown4 (-1)
|}
==Z words from start==
Not much is known about this group, other than the fact it is always 10*N words long.
:{| class="wikitable"
|-
! Hex !! Short Name !! Description
|-
! 00
| unknown1 || rowspan="10" | All are apparently used, a lot of repeats
|-
! 02
| unknown2
|-
! 04
| unknown3
|-
! 06
| unknown4
|-
! 08
| unknown5
|-
! 0A
| unknown6
|-
! 0C
| unknown7
|-
! 0E
| unknown8
|-
! 10
| unknown9
|-
! 12
| unknown10
|}

Pokémon DP Save File Structure

2015-01-21T11:16:45Z

Nerketur: changed links from word_(computing) to point to the actual page Word_(computer_architecture) instead of the disambiguation page.

== General Save File Structure ==

A Pokémon Diamond and Pearl save file is divided into two pairs of blocks. Each pair consists of one general block, one storage box block, and one hall of fame block. The storage box block contains current information regarding [[Bebe|Bebe's]] storage system, including stored Pokémon, box names, box wallpapers, and the current open box. The general block contains current information on every other aspect of the game's progress, such as the trainer's name, ID number, acquired badges, party Pokémon, items, and much more. The hall of fame block contains information about the Pokémon used to defeat the Elite 4. The other pair is a backup from the previous save.

The first general block in the file begins at 0x00000. The first storage block begins at 0x0C100. The first hall of fame block starts at 0x20000. The second general, storage, and hall of fame blocks are at the same address + 0x40000. The current blocks are not always stored in linear order in the save file (i.e. if the second general block is the more current, the first or second storage box block can possibly be the current as well).

== Block Footers ==

The last 20 bytes of each general and storage box block is a footer. The last 24 bytes of each hall of fame block is a footer. The footer is used to determine:

* The size of the block
* Whether the block is current or a backup.
* Which big & small blocks link together.

===General/Storage Box Footer===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Purpose
|- style="background: #eee;" align="center"
| 0x00 - 0x03
| Storage Block Save Count
|- style="background: #eee;" align="center"
| 0x04 - 0x07
| General Block Save Count
|- style="background: #eee;" align="center"
| 0x08 - 0x0B
| Size of block
|- style="background: #eee;" align="center"
| 0x0C - 0x0F
| ''Run-time usage''
|- style="background: #eee;" align="center"
| 0x10 - 0x11
| ''Run-time usage''
|- style="background: #eee;" align="center"
| 0x12 - 0x13
| [[Pokémon NDS Save File Checksum|Checksum]]
|}

===Hall of Fame Footer===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Purpose
|- style="background: #eee;" align="center"
| 0x00 - 0x03
| Save ID number
|- style="background: #ddd;" align="center"
| 0x04 - 0x07
| Save index number
|- style="background: #eee;" align="center"
| 0x08 - 0x0B
| ''Run-time usage''
|- style="background: #ddd;" align="center"
| 0x0C - 0x0F
| ''Run-time usage''
|- style="background: #eee;" align="center"
| 0x10 - 0x13
| Size of block
|- style="background: #ddd;" align="center"
| 0x14 - 0x15
| ''Run-time usage''
|- style="background: #eee;" align="center"
| 0x16 - 0x17
| [[Pokémon NDS Save File Checksum|Checksum]]
|}

== Loading/Saving A Save File ==

When one starts a new game for the very first time, every byte of the save file is set to 0xFF. The first time the game is saved, the "current" info is written to the second half of the save file. This is important to note when loading a save.

When the game loads a save file, it first compares the small block save count of both general blocks. If the general block with the highest save count has a correct checksum, then the game moves on to check the storage blocks. The storage block with the highest storage block save count is chosen first, and if its general block save count matches the currently chosen general block (and has a correct checksum), the file is successfully loaded. If both storage blocks have the same storage block save count, then the storage block with a higher general block save count is chosen instead, and the if the checksum is correct, the file is successfully loaded. If the checksum was incorrect for either block, the game falls on the other pair of general and storage blocks; if the checksums are correct in both, the game reports a save file corruption error, and that is the data loaded. If the checksum in either block is incorrect, the game reports a save file corruption error, and the save file is not loaded. A new game must be started at that point.

When the game saves data, the general block save count is incremented + 1. If nothing in the storage block has changed, then no changes are made to the storage block and no further changes are made to the general block. However, if changes have been made to the storage block, then the storage block save count is incremented by 1 in both the storage block and general block footers. At this point, the backup general block is overwritten with the new general block data, and (if changes were made to the storage block), the backup storage block is also overwritten. This is the reason why the game varies on how long it takes to save.

Thus, either general block can be linked with either storage block, and the current pair is identified using the footer information.

==Small block offsets==

===Adventure Started - 0x34===
*Unsigned 32bit integer.
*Number of seconds since 1/1/2000 00:00:00

===Pokémon League Champ Date - 0x3C===
*Unsigned 32bit integer.
*Number of seconds since 1/1/2000 00:00:00

===Trainer Name - 0x64===
*8 unsigned 16bit integers.
*Each {{wplink|Word_(computer_architecture)|word}} represents a character in the game's [[Pokémon NDS Character Table|character table]].

===Trainer ID - 0x74===
*Random unsigned 16bit integer
*The visible identification number of a trainer
*Determines ownership of Pokémon.

===Secret ID - 0x76===
*Random unsigned 16bit integer
* The hidden identification number of a trainer
*Determines ownership of Pokémon.
*Determines variation in the game.

===Money - 0x78===
*Unsigned 32bit integer.
*Limited to 0xF423F (999,999)

===Trainer Gender - 0x7C===
*0 if male, 1 if female.
*Determines ownership of Pokémon.

===Country of Origin - 0x7D===
*Unsigned 8bit integer.
*Determines whether or not Pokémon get an outsider EXP bonus.
: 0x1 = 日本語 (Japan)
: 0x2 = English (US/UK/AU)
: 0x3 = Français (France/Québec)
: 0x4 = Italiano (Italy)
: 0x5 = Deutsch (Germany)
: 0x7 = Español (Spain/Latin Americas)
: 0x8 = 한국어 (South Korea)

===Badges - 0x7E===
*Unsigned 8bit bitfield
*Determines what PokéMart items are for sale, what level outsider Pokémon will obey until, and flags certain in-game events.
: 0x01 = Coal Badge
: 0x02 = Forest Badge
: 0x04 = Cobble Badge
: 0x08 = Fen Badge
: 0x10 = Relic Badge
: 0x20 = Mine Badge
: 0x40 = Icicle Badge
: 0x80 = Beacon Badge

===Multiplayer Avatar - 0x7F===
*Unsigned 8bit integer.
*Determines the sprite seen by other players in a multiplayer environment such as the Union Room.
: 0x00 = None
: 0x03 = School Kid
: 0x05 = Bug Catcher
: 0x06 = Lass
: 0x07 = Battle Girl
: 0x0B = Ace Trainer Male
: 0x0D = Beauty
: 0x0E = Ace Trainer Female
: 0x0F = Roughneck
: 0x1F = Pop Idol
: 0x23 = Social
: 0x25 = Cowgirl
: 0x2A = Ruin Maniac
: 0x32 = Black Belt
: 0x3E = Rich Boy
: 0x3F = Lady
: 0x46 = Psychic

===Total Playtime - 0x86===
*Hours = unsigned 16bit integer.
*Minutes = unsigned 8bit integer.
*Seconds = unsigned 8bit integer.

===Number of Current Party Pokémon - 0x94===
*Unsigned 8bit integer.

===Party Pokémon - 0x98===
The Pokémon in the trainer's party.
*6 blocks of 236byte structures
{{main|Pokemon NDS Structure}}

===General Items - 0x624===
{{main|Other items}}
The items in the Trainer's general Items bag pocket.
*165 blocks of 4 byte structures (two bytes for [[item index]], two bytes for quantity)

===Key Items - 0x8B8===
{{main|Key items}}
The items in the Trainer's Key Items bag pocket.
*50 blocks of 4 byte structures (two bytes for item index, two bytes for quantity).

===TMs & HMs - 0x980===
{{main|TMs and HMs}}
The items in the Trainer's TMs & HMs bag pocket.
*100 blocks of 4 byte structures (two bytes for item index, two bytes for quantity).
*TMs & HMs are auto-sorted by item index in ascending order.

===Mail - 0xB10===
{{main|Mail}}
The items in the Trainer's Mail bag pocket.
*12 blocks of 4 byte structures (two bytes for item index, two bytes for quantity).

===Medicine - 0xB40===
{{main|Medicine}}
The items in the Trainer's Medicine bag pocket.
*40 blocks of 4 byte structures (two bytes for item index, two bytes for quantity).

===Berries - 0xBE0===
{{main|Berries}}
The items in the Trainer's Berries bag pocket.
*64 blocks of 4 byte structures (two bytes for item index, two bytes for quantity).
*Berries are auto-sorted by item index in ascending order.

===Balls - 0xCE0===
{{main|Pokéballs}}
The items in the Trainer's Balls bag pocket.
*15 blocks of 4 byte structures (two bytes for item index, two bytes for quantity).

===Battle Items - 0xD1C===
{{main|Battle items}}
The items in the Trainer's Battle Items bag pocket.
*56 (?) blocks of 4 byte structures (two bytes for item index, two bytes for quantity).

===Starter Pokémon - 0xDFC===
The [[Nationaldex|Pokédex]] number of the starter chosen.
*Unsigned 16bit integer.

===Lotto number - 0xE14===
*Unsigned 16bit integer.

===Fly Locations - 0x1112===
*9byte bit field

===Has obtained lotto prize - 0x1131===
*1 if obtained, 0 if not yet obtained

===Pokétch Enabled (?) - 0x114C===
*0x00 if disabled, can be 0x03 or 0x07 if enabled

===Number of Pokétch Apps Enabled - 0x114D===
*Max number = 25 (0x19)

===Currently Selected Pokétch App - 0x114E===
Pokétch app currently viewed in DS bottom screen.
*Pokétch apps are ordered like so:
: 0x00 = Digital Watch
: 0x01 = Calculator
: 0x02 = Memo Pad
: 0x03 = Pedometer
: 0x04 = Pokémon List
: 0x05 = Friendship Checker
: 0x06 = Dowsing Machine
: 0x07 = Berry Searcher
: 0x08 = Day-Care Checker
: 0x09 = Pokémon History
: 0x0A = Counter
: 0x0B = Analog Watch
: 0x0C = Marking Map
: 0x0D = Link Searcher
: 0x0E = Coin Toss
: 0x0F = Move Tester
: 0x10 = Calendar
: 0x11 = Dot Artist
: 0x12 = Roulette
: 0x13 = Trainer Counter
: 0x14 = Kitchen Timer
: 0x15 = Color Changer
: 0x16 = Matchup Checker
: 0x17 = Stopwatch
: 0x18 = Alarm Clock

===Pokétch Apps Enabled - 0x114F===
*25 one byte flags, each corresponding to one Pokétch app (in the same order as above)
*1 = enabled, 0 = disabled

===Map ID Number - 0x1238===
{{main|List of Maps}}
*Unsigned 16bit integer.

===Sinnoh Pokédex Unlocked - 0x1414===
*1 if unlocked, 0 if not unlocked.

===National Pokédex Unlocked - 0x1415===
*1 if unlocked, 0 if not unlocked.

===Berry Trees - 0x1E84===
*128 blocks of 14byte structures
*List of [[Berry Tree#Locations|Berry Tree locations]]
{{main|Berry Tree(Technical)|Berry Trees}}

===Rival's Name - 0x25A8===
*8 unsigned 16bit integers.
*Each {{wplink|Word_(computer_architecture)|word}} represents a character in the game's [[Pokémon NDS Character Table|character table]].

===Map X Coordinate - 0x25FA===
*Unsigned 16bit integer.

===Map Y Coordinate - 0x25FE===
*Unsigned 16bit integer.

===Map Z Coordinate - 0x2602===
*Unsigned 16bit integer.

===Players Met Underground - 0x3A2C===
*Unsigned 32bit integer
*Max value = 999999 (0xF423F)

===Spheres Obtained - 0x3A38===
*Unsigned 32bit integer
*Max value = 999999 (0xF423F)

===Fossils Obtained - 0x3A3C===
*Unsigned 32bit integer
*Max value = 999999 (0xF423F)

===Gifts Given - 0x3A40===
*Unsigned 32bit integer
*Max value = 999999 (0xF423F)

===Traps Hit - 0x3A44===
*Unsigned 32bit integer
*Max value = 999999 (0xF423F)

===Traps Triggered - 0x3A48===
*Unsigned 32bit integer
*Max value = 999999 (0xF423F)

===Flags Captured - 0x3A60===
*Unsigned 32bit integer
*Max value = 999999 (0xF423F)

===Poffins - 0x5050===
*98 (?) blocks of 8byte structures
: 0x00: Poffin Type (Overall flavor?)
: 0x01: Spicy/Cool Level
: 0x02: Dry/Beauty Level
: 0x03: Sweet/Cute Level
: 0x04: Bitter/Smart Level
: 0x05: Sour/Tough Level
: 0x06: Smooth Level
: 0x07: value is 0

===Trainer Card Signature - 0x5904===
The signature on the back of the Trainer Card.
*192 blocks of 8 byte structures
*The signature can be changed by speaking to the NPC behind the leftmost counter on the top floor of any Pokémon Center. It is created using the stylus.
{{main|Trainer Card Signature}}

===Score - 0x5F08===
A measure of the player's progress or performance in the game.
*Unsigned 32bit integer
*Max value = 999999 (0xF423F)

===Pokémon Caught - 0x5F2C===
*Unsigned 32bit integer
*Max value = 999999 (0xF423F)

===Pokémon Met While Fishing - 0x5F30===
*Unsigned 32bit integer
*Max value = 999999 (0xF423F)

===Pokémon Eggs - 0x5F34===
*Unsigned 32bit integer
*Max value = 999999 (0xF423F)

===Pokémon Defeated - 0x5FAC===
*Unsigned 32bit integer
*Max value = 999999 (0xF423F)

===Single Battle Wins - 0x5FCA===
*Unsigned 16bit integer
*Max value = 9999 (0x270F)

===Consecutive Single Battle Wins - 0x5FCC===
*Unsigned 16bit integer
*Max value = 9999 (0x270F)

===Double Battle Wins - 0x5FCE===
*Unsigned 16bit integer
*Max value = 9999 (0x270F)

===Consecutive Double Battle Wins - 0x5FD0===
*Unsigned 16bit integer
*Max value = 9999 (0x270F)

===Multi Battle Wins - 0x5FD2===
*Unsigned 16bit integer
*Max value = 9999 (0x270F)

===Consecutive Multi Battle Wins - 0x5FD4===
*Unsigned 16bit integer
*Max value = 9999 (0x270F)

===Link Multi Battle Wins - 0x5FD6===
*Unsigned 16bit integer
*Max value = 9999 (0x270F)

===Consecutive Link Multi Battle Wins - 0x5FD8===
*Unsigned 16bit integer
*Max value = 9999 (0x270F)

===Wi-Fi Battle Wins - 0x5FDA===
*Unsigned 16bit integer
*Max value = 9999 (0x270F)

===Consecutive Wi-Fi Battle Wins - 0x5FDC===
*Unsigned 16bit integer
*Max value = 9999 (0x270F)

===Contests Won - 0x5FE2===
*Unsigned 16bit integer
*Max value = 9999 (0x270F)

===Ribbons - 0x5FE6===
*Unsigned 16bit integer
*Max value = 9999 (0x270F)

===Capsules in PC - 0x6050===
*12 blocks of 24 bytes structures.

===Battle Points - 0x65F8===
*Unsigned 16bit integer
*Max value = 9999 (0x270F)

===Safari Zone Pokémon - 0x72D0===
*Unsigned 32bit integer result from the [[ARNG]].
*Four daily safari zone Pokémon
*''Index<sub>n</sub>'' = ( ''ARNG'' >> ( ''n'' * 0x5 ) ) & 0x1F
*List of [[Safari Zone Pokémon#Pokémon list|Safari Zone Pokémon]]
*''Notes'': Both Safari Zone Pokémon and [[#Swarm Pokémon - 0x72D0|Swarm Pokémon]] have the same [[ARNG]] value.

===Swarm Pokémon - 0x72D4===
*Unsigned 32bit integer result from the [[ARNG]].
*One daily swarm Pokémon
*''Index'' = ''ARNG'' % 0x1C
*List of [[Swarm Pokémon#Pokémon list|Swarm Pokémon]]
*''Notes'': Both [[#Safari Zone Pokémon - 0x72D0|Safari Zone Pokémon]] and Swarm Pokémon have the same [[ARNG]] value.

===Daily Trophy Pokémon Today - 0x72DC===
*Unsigned 8bit integer
*First daily trophy garden Pokémon
*List of [[Daily Trophy Pokémon#Pokémon list|Daily Trophy Pokémon]]

===Daily Trophy Pokémon Yesterday - 0x72DE===
*Unsigned 8bit integer
*Second daily trophy garden Pokémon
*List of [[Daily Trophy Pokémon#Pokémon list|Daily Trophy Pokémon]]
*''Notes'': Yesterday's Pokémon can be caught after beating the [[Elite 4]] and receiving the [[National Pokédex upgrade]].

===Honey Trees - 0x72E4===
*21 blocks of 8byte structures
*List of [[Honey Tree#Locations|Honey Tree locations]]
{{main|Honey Tree(Technical)|Honey Trees}}

===GTS Pokémon - 0x73E8===
One Pokémon
*1 block of 236byte structures
*The data for the Pokémon currently uploaded to the GTS (if any).
{{main|Pokemon NDS Structure}}

[[Category:Structures]]
[[Category:Game Mechanics]]
[[Category:Technical References]]