Graphics System
Graphics Sheets
The ROM contains 223 graphics sheets, each 128x32 pixels (16 tiles × 4 tiles, 8×8 tile size):
Sheet Categories:
- Sheets 0-112: Overworld/Dungeon graphics (compressed 3BPP)
- Sheets 113-114: Uncompressed 2BPP graphics
- Sheets 115-126: Uncompressed 3BPP graphics
- Sheets 127-217: Additional dungeon/sprite graphics
- Sheets 218-222: Menu/HUD graphics (2BPP)
Graphics Format:
- 3BPP (3 bits per pixel): 8 colors per tile, commonly used for backgrounds
- 2BPP (2 bits per pixel): 4 colors per tile, used for fonts and simple graphics
Palette System
Color Format
SNES uses 15-bit BGR555 color format:
- 2 bytes per color
- Format:
0BBB BBGG GGGR RRRR
- Each channel: 0-31 (5 bits)
- Total possible colors: 32,768
Palette Groups
Dungeon Palettes (0xDD734):
- 20 palettes × 90 colors each
- Distributed as: BG1 colors, BG2 colors, sprite colors
- Applied per-room via palette ID
Overworld Palettes:
- Main: 35 colors per palette (0xDE6C8)
- Auxiliary: 21 colors per palette (0xDE86C)
- Animated: 7 colors per palette (0xDE604)
Sprite Palettes:
- Global sprites: 60 colors (0xDD308)
- Auxiliary 1: 7 colors per palette (0xDD39E)
- Auxiliary 2: 7 colors per palette (0xDD446)
- Auxiliary 3: 7 colors per palette (0xDD4E0)
Other Palettes:
- HUD: 32 colors per palette (0xDD218)
- Armors: 15 colors per palette (0xDD630)
- Swords: 3 colors per palette
- Shields: 4 colors per palette
Dungeon System
Room Data Structure
Room Objects (3 bytes each):
Byte 1: YYYXXXXX
YYY = Y coordinate (0-31)
XXXXX = X coordinate (0-31) + layer flag (bit 5)
Byte 2: SSSSSSSS
Size byte (interpretation varies by object type)
Byte 3: IIIIIIII
Object ID or ID component (0-255)
Object Patterns:
- 0x34: 1x1 solid block
- 0x00-0x08: Rightward 2x2 expansion
- 0x60-0x68: Downward 2x2 expansion
- 0x09-0x14: Diagonal acute (/)
- 0x15-0x20: Diagonal grave ()
- 0x33, 0x70-0x71: 4x4 blocks
Tile16 Format
Each Tile16 is composed of four 8x8 tiles:
[Top-Left] [Top-Right]
[Bot-Left] [Bot-Right]
Stored as 8 bytes (2 bytes per 8x8 tile):
Blocksets
Each dungeon room uses a blockset defining which graphics sheets are loaded:
- 16 sheets per blockset
- First 8: Background graphics
- Last 8: Sprite graphics
Blockset Pointer: 0x0FFC40
Message System
Text Data Locations
- Text Block 1: 0xE0000 - 0xE7FFF (32KB)
- Text Block 2: 0x75F40 - 0x773FF (5.3KB)
- Dictionary Pointers: 0x74703
Character Encoding
- 0x00-0x66: Standard characters (A-Z, a-z, 0-9, punctuation)
- 0x67-0x80: Text commands (line breaks, colors, window controls)
- 0x88-0xE8: Dictionary references (compressed common words)
- 0x7F: Message terminator
Text Commands
- 0x6A: Player name insertion
- 0x6B: Window border (+ 1 argument byte)
- 0x73: Scroll text vertically
- 0x74-0x76: Line 1, 2, 3 markers
- 0x77: Text color (+ 1 argument byte)
- 0x7E: Wait for key press
Font Graphics
- Location: 0x70000
- Format: 2BPP
- Size: 8KB (0x2000 bytes)
- Organized as 8x8 tiles for characters
Overworld System
Map Structure
- 3 worlds: Light, Dark, Special
- Each world: 8×8 grid of 512×512 pixel maps
- Total maps: 192 (64 per world)
Area Sizes (ZSCustomOverworld v3+)
- Small: 512×512 (1 map)
- Wide: 1024×512 (2 maps horizontal)
- Tall: 512×1024 (2 maps vertical)
- Large: 1024×1024 (4 maps in 2×2 grid)
Tile Format
- Map uses Tile16 (16×16 pixel tiles)
- Each Tile16 composed of four 8x8 tiles
- 32×32 Tile16s per 512×512 map
Compression
LC-LZ2 Algorithm
Both graphics and map data use a variant of LZ compression:
Commands:
- 0x00-0x1F: Direct copy (copy N bytes verbatim)
- 0x20-0x3F: Byte fill (repeat 1 byte N times)
- 0x40-0x5F: Word fill (repeat 2 bytes N times)
- 0x60-0x7F: Incremental fill (0x05, 0x06, 0x07...)
- 0x80-0xFF: LZ copy (copy from earlier in buffer)
Extended Headers (for lengths > 31):
- 0xE0-0xFF: Extended command headers
- Allows compression of up to 1024 bytes
Modes:
- Mode 1 (Nintendo): Graphics decompression (byte order variation)
- Mode 2 (Nintendo): Overworld decompression (byte order variation)
Memory Map
ROM Banks (LoROM)
- Bank 0x00-0x7F: ROM data
- Bank 0x80-0xFF: Mirror of 0x00-0x7F
Important ROM Locations
Graphics:
0x080000+ Link graphics (uncompressed)
0x0F8000+ Dungeon object subtype tables
0x0FB373 Object subtype 1 table
0x0FFC40 Blockset pointers
Palettes:
0x0DD218 HUD palettes
0x0DD308 Global sprite palettes
0x0DD734 Dungeon main palettes
0x0DE6C8 Overworld main palettes
0x0DE604 Animated palettes
Text:
0x070000 Font graphics
0x0E0000 Main text data
0x075F40 Extended text data
Tile Data:
0x0F8000 Tile16 data (4032 tiles)
Last Updated: October 9, 2025