# Difference between revisions of "Super Pitfall:ROM map"

## Graphics

```Sprite manipulation parameters
00 = nothing
40 = flip H
80 = flip V
C0 = rotate 180

0x193E8 to 0x193EF = Harry's attributes

0x1842E to 0x18453 = Harry standing right
0x18454 to 0x18465 = Harry walking right 1
0x18466 to 0x18477 = Harry walking right 2
0x18478 to 0x18489 = Harry walking right 3
0x1848A to 0x1849B = Harry walking right 4
0x1849C to 0x184AD = Harry walking left 1
0x184AE to 0x184BF = Harry walking left 2
0x184C0 to 0x184D1 = Harry walking left 3
0x184D2 to 0x184E3 = Harry walking left 4
0x18506 to 0x18515 = Jumping right
0x18516 to 0x18527 = Jumping left

0x1854A to 0x18559 = Swimming right 1
0x1855A to 0x18569 = Swimming right 2
0x1856A to 0x18579 = Swimming right 3
0x1857A to 0x1858B = Swimming right 4

0x1858C to 0x1859D = Swimming left 1
0x1859E to 0x185AF = Swimming left 2
0x185B0 to 0x185C1 = Swimming left 3 (185BF change to 40 to fix the tile)
0x185C2 to 0x185D3 = Swimming left 4

0x185D4 to 0x185E5 = Ladder 1
0x185E6 to 0x185F7 = Ladder 2
0x185F8 to 0x18609 = Ladder 3
0x1860A to 0x1861B = Ladder 4

0x1861C to 0x1862D = Ducking

Bullet when shooting to the right:
0x18B3C to 0x----- = Amount of tiles
0x18B3D to 0x----- = Position
0x18B3E to 0x----- = Graphic (tile)
0x18B3F to 0x----- = Attribute

0x18B40 to 0x----- = Bullet left

0x190B0 to 0x190BD = Dying 1
0x190BE to 0x190CB = Dying 2

0x19144 to 0x19153 = Standing position fine tuning

0x1EC22 to 0x----- = Change to 0A so standing position is correct
when exiting ladder to the left
0x1EC42 to 0x----- = Change to 0A so standing position is correct
when exiting ladder to the right
0x020B5 to 0x----- = Change to 0A so standing position is correct
when standing on moving platforms
0x01F96 to 0x----- = Change to 0A so standing position is correct
when standing on falling platforms

0x1870C to 0x18743 = Spider walking
0x1877C to 0x1878F = Unused spider

0x18934 to 0x----- = Change to D5 to fix the waterfall's wrong tile
0x1895A to 0x----- = Change to D5 to fix the waterfall's wrong tile

0x188C2 to 0x----- = Change to FF to fix the moai's wrong tile
0x188F6 to 0x----- = Change to FF to fix the moai's wrong tile

0x189A2 to 0x----- = The balloon metatile 1
0x189C0 to 0x----- = The balloon metatile 2

dynamic (uses background bank):
0x01008 to 0x----- = Wide spikes chain
0x01018 to 0x----- = Moving spikes background
0x0102C to 0x----- = Narrow spikes chain
0x02133 to 0x----- = Lava top
0x0219E to 0x----- = Water top
0x0246A to 0x02479 = Crystal balls
0x0247A to 0x----- = Locks
0x02492 to 0x----- = Diamond
0x024A6 to 0x----- = Lion
0x205FF to 0x----- = Niece cursed

0x02905 to 0x----- = Width and height of replaced graphics

0x02327 to 0x----- = crystal balls

0x02587 to 0x----- = Niece  (AB40)
0x026A9 to 0x----- = Lion
0x02786 to 0x----- = Raj
0x02841 to 0x----- = Small gold
0x0284A to 0x----- = Width and height of replaced small gold
0x02877 to 0x----- = Small gold width and height
0x028FC to 0x----- = Medium gold
0x02932 to 0x----- = Medium gold width and height
0x029B7 to 0x----- = Big gold
0x029C0 to 0x----- = Width and height of replaced big gold
0x029ED to 0x----- = Big gold width and height

0x1D637 to 0x----- = Around that, intermission headers

0x01E8D to 0x----- = Color of the big moving platform
0x0201B to 0x----- = Color of the small moving platform

0x0261A to 0x----- = Which sprite to load for the lion cage
0x0261F to 0x----- = Which palette to use for the lion cage sprite
0x026EC to 0x----- = Lion cage's vertical hitbox
0x026F0 to 0x----- = Lion cage's horizontal hitbox
0x025DC to 0x----- = Niece's vertical hitbox
0x025E0 to 0x----- = Niece's horizontal hitbox

0x18D6A to 0x18D6D = Imp's shot right
0x18D6E to 0x18D71 = Imp's shot left

0x1936C to 0x19377 = Fix imp's metasprite positions
0x19194 to 0x1919B = Fix lobster's metasprite positions
0x192F6 to 0x19349 = Cavemen metasprites
```
(Source: nesrocks)

### Metasprite Types

```	max
length
type	(EST.)	used by
----	------	-------
00	08	Harry various positions
01	08
02	08
03	08
04	08
05	04
06	06
07	06	Unused
08	06	Unused
09	05	Unused
0A	07	Unused
0B	07
0C	16
0D	1C
0E	0E
0F	0D
10	08	Vine 1
11	08	Vine 2
12	08	Vine 3
13	08	Vine 4
14	08	Vine 5
15	08	Vine 6
16	08	Vine 7
17	08	Vine 8
18	04
19	07	Unused
1A	0D	Unused
1B	10
1C	0C
1D	0B
1E	12
1F		HUD
20	06
21	02
22	02
23	02	Key
24	08	Unused
25	09
26	05
27	08
28	08
29	0E	Unused
```
(Source: nesrocks)

## Maps

```0x04020 to 0x040EF = Overworld room ID map
0x040F0 to 0x07BFF = Start of each room mapping in 2x2 metatiles.
Each room is 15x16 (240) bytes long.

0x0C020 to 0x0C0EF = Darkworld room ID map
0x0C0F0 to 0x0E0CF = Darkworld metatile map

0x10020 to 0x100EF = Hidden areas room ID map
0x100F0 to 0x13A1F = The hidden areas rooms

0x13920 to 0x13A1F = An unused test room with gold and ladders

0x14000 to 0x1421F = Object list mapping for overworld quest 1.
They are read 1 by 1 depending on coordinates
on the map (1 for each room). These are simple
pointers to the object list bellow. Objects are
read from that point onward untill they hit a FF
room. an object list can have any number of objects,
just make sure pointers point to the right places
after FF
```
(Source: nesrocks)

### Room's Object List

Rooms can reutilize object lists.

```0x14220 to 0x147F6 = Object list for overworld quest 1. Each item takes 3 bytes.
First byte is type, second is horizontal position
and third is vertical position. Some items take 4
bytes, so the second is a parameter, and the last
two are the position

0x14A9F to 0x14C60 = Object list for darkworld

0x14E60 to 0x14FB8 = Object list for big warpzone
0x14FB9 to 0x15015 = Object list for medium warpzone
0x15016 to 0x15046 = Object list for small warpzone

0x1F71A to 0x----- = Spawn point list. This is just the screen coordinates
where to position harry when spawning on room. It doesn't
know which room it is on.
```
(Source: nesrocks)

## Random Stuff

```0x142dc to 0x----- = Where the first gun is stored
0x142dd to 0x----- = Item parameter. it's used on warps for example
(01 to 0x08 are preset warp destinations)
0x142de to 0x----- = Gun horizontal position
0x142df to 0x----- = Gun vertical position

0x142b1 to 0x----- = The warp to the darkworld
0x1dc44 to 0x----- = Warp list pointer
0x1dc66 to 0x----- = Warp list location. each warp is 4 bytes long.
(map, room, hor pos, vert pos).
map:
0 = main
1 = underworld
2 = alternate

0x144ED to 0x----- = Where one of the diamonds are stored (13).

0x1DBE6 to 0x1DC25 = The button sequence for the demo
```
(Source: nesrocks)

## Music

### Note Values

Increase a note by a halfstep by adding 15 to the hexidecimal value. To raise it by an octave, increase the hexidecimal value by one.

#### Square and Triangle

```Value	Note
----	----
0F	REST
00	A-1
01	A-2
02	A-3
10	A#1
11	A#2
12	A#3
20	B-1
21	B-2
22	B-3
30	C-2
31	C-3
32	C-4
40	C#2
41	C#3
42	C#4
50	D-2
51	D-3
52	D-4
60	D#2
61	D#3
62	D#4
70	E-2
71	E-3
72	E-4
80	F-2
81	F-3
82	F-4
90	F#2
91	F#3
92	F#4
A0	G-2
A1	G-3
A2	G-4
B0	G#2
B1	G#3
B2	G#4
F0	REPEAT
FF	STOP
```

#### Noise

```Value	Note
----	----
00	F-#
01	E-#
02	D-#
03	C-#
04	B-#
05	A-#
06	9-#
07	8-#
08	7-#
09	6-#
0A	5-#
0B	4-#
0C	3-#
0D	2-#
0E	1-#
0F	0-#
```
(Source: FCandChill, nesrocks)

### Music and Sound Data Structure

```A sound or music channel sequence is comprised of a 4 bytes header, followed by notes, until an end byte is reached.

The header's first byte accepts the following values:
01: Square 1 channel
02: Square 2 channel
03: Triangle Channel
04: Noise channel

The header's three other bytes are channel settings and effects.

A note is represented by two bytes:
Byte 1: Note letter and octave
Byte 2: Time until next note.

An end byte is recognized by being one of two possible values:
F0: Loop
FF: Stop
```
(Source: FCandChill, nesrocks)

### All the Sound Data

```20 AC FE the sub routine call to play the previously loaded ID (A9 ID) (sometimes 4C AC FE)

--	------------------	----	-----	----------------
00	0x19926 to 0x1992A	004
01	0x1992F to 0x19933	004
02	0x19938 to 0x1993C	004
03	0x19941 to 0x19955	014	SFX	Pause
04	0x1995A to 0x199D6	07C	Music	Balloon theme square
05	0x199D7 to 0x10A0D	036	Music	Main theme square
06	0x19A0E to 0x19A2B		Music	Cutscene theme square stops on 28
07	0x19A2D to 0x19A79		Music	Darkworld theme square
08	0x19A7A to 0x19A92		Music	Invincibilty square
09	0x19A93 to 0x19ABF		Music	Game over theme square
0A	0x19AC0 to 0x19AEA		Music	Game over theme square 2
0B	0x19AEB to 0x19B15		Music	Game over theme triangle
0C	0x19B1C to 0x19B26		SFX	Extra life
0D	0x19B27 to 0x19B31		SFX	Death
0E	0x19B32 to 0x19B42		SFX	Kill an enemy
0F	0x19B43 to 0x19B4F		SFX	Take a warp
10	0x19B50 to 0x19B5A		SFX	Get an item
11	0x19B50 to 0x19B5A		SFX	Get an item (duplicate pointer)
12	0x19B5B to 0x19B61		SFX	Get an item higher pitch (gold I think)
13	0x19B62 to 0x19B6A		SFX	Enemy shoots
14	0x19B6B to 0x19B73		SFX	Damage an enemy (without killing it)
15	0x19B74 to 0x19B7E		SFX	Firing a bullet
16	0x19B7F to 0x19B87		SFX	Object hitting the ground
17	0x19B88 to 0x19B92		SFX	Falling ceiling
18	0x19B93 to 0x19B9B		SFX	Jump low pitch
19	0x19B9C to 0x19BA6		SFX	Jump (maybe it's this address. check)
1A	0x19BA7 to 0x19BB5		SFX	Imp / big cavemen shooting
1B	0x19BB6 to 0x19BC0		SFX	Moving spikes
1C	0x19BC1 to 0x19BCD		SFX	??????
1D	0x19BCE to 0x19BD8		SFX	Waterfall
1E	0x19BD9 to 0x19BDF		SFX	Harry landing on the ground
1F	0x19BE0 to 0x19BEC		SFX	??????
20	0x19BE0 to 0x19BEC		SFX	?????? (duplicate pointer)
21	0x19BED to 0x19BF3		SFX	Sounds like harry landing on the ground
22	0x19BF4 to 0x19C98		Music	Ballon theme triangle
23	0x19CA4 to 0x19CBC		Music	Ballon theme noise (I think, needs testing)
24	0x19CBD to 0x19D3B		Music	Main theme triangle
25	0x19D3C to 0x19D8A		Music	Main theme noise (I think, needs testing)
26	0x19D8B to 0x19DA8		Music	Cutscene theme triangle (stops on 28)
27	0x19DAA to 0x19DB0		Music	Cutscene theme noise (it's empty)
28	0x19DB1 to 0x19DC3		Music	Darkworld theme triangle
29	0x19DC4 to 0x19DE8		Music	Darkworld theme noise
2A	0x19DE9 to 0x19E7D		Music	Invincibilty theme square 2
2B	0x19E7E to 0x19EB8		Music	Invincibility theme noise
2C	0x19EB9 to 0x19F1D		Music	Ending theme square
2D	0x19F1E to 0x19F7C		Music	Ending theme square 2
2E	0x19F7D to 0x19FCF		Music	Ending theme triangle

0x19C99 to 0x19CA3	unused data
```
(Source: nesrocks)

#### Size of Music

```  total
byte size
(base 15)	Description
---------	------------
045		Cutscene
084		Game over
086		Darkworld
0EB		Invincibility / Overworld 2
105		Main theme
116		Ending
11F		Balloon
```
(Source: nesrocks)

Internal Data for Super Pitfall