Brick Documentation

This document describes all brick types, their indices, and the actions triggered when hit.

Overview

The map file contains a 20x20 grid of bricks, each identified by a unique index. They are grouped into the following ranges:

• Brick Index Range: 10-57, 90-97

• Destructible Bricks: 10-57 (must be cleared to complete a level)

• Solid/Indestructible Bricks: 90-97 (cannot be destroyed, don’t count toward level completion)

Brick Types

The following tables detail the various brick types. The Index column refers to the brick’s identifier in the map file, the ✅️ indicates if it is already implemented.

Simple Bricks

Index	Image	Name	Score	Description
20 ✅️		Simple Stone	25	Basic brick, destroyed on first hit

Multi-Hit Bricks

Index	Image	Name	Score	Description
10 ✅️		Hit 1	50	Needs 1 more hit to become simple stone
11 ✅️		Hit 2	50	Needs 2 more hits
12 ✅️		Hit 3	50	Needs 3 more hits
13 ✅️		Hit 4	50	Needs 4 more hits

Gravity Bricks

Index	Image	Name	Score	Description
21 ✅️		Zero Gravity	125	Turns off gravity
22 ✅️		2G	75	Light gravity (like Mars)
23 ✅️		10G	125	Normal gravity (Earth)
24 ✅️		20G	150	High gravity
25 ✅️		Queer Gravity	250	Random changing gravity in intensity and direction

Score Multiplier Bricks

Index	Image	Name	Score	Description
26		Times 1	25	Reset to single score
27		Times 2	25	Double all points
28		Times 3	25	Triple all points
29		Times 4	25	Quadruple all points

Paddle Effect Bricks

Index	Image	Name	Score	Description
30 ✅️		Apple	300	Shrinks paddle (temporary)
32 ✅️		Yin Yang	225	Enlarges paddle

Ball Size Bricks

Index	Image	Name	Score	Description
33		Small Ball	25	Changes ball to small size
34		Medium Ball	25	Changes ball to medium size
35		Big Ball	25	Changes ball to large size

Enemy Spawn Bricks

Index	Image	Name	Score	Description
36 ✅️		Donut/Rotor	75	Spawns a bouncing rotor enemy
31		Sun	200	Spawns a deadly skull enemy

Ball Spawn Bricks

Index	Image	Name	Score	Description
37 ✅️		Red 1	100	Reduces to 1 ball in play, all other balls are despawned
38 ✅️		Red 2	100	Spawns one additional ball with the same velocity and the inverse direction of the current ball
39 ✅️		Red 3	100	Spawns two more balls, same velocity, different directions (Y shaped)

Hazard Bricks

Index	Image	Name	Score	Description
40		Bomb	100	Explodes, spawns fragments, if the paddle is in the ‘blast radius’ the player “dies”
42 ✅️		Killer	90	Deadly - Paddle contact triggers immediate life loss (regardless of balls in play)
91 ✅️		Killer (variant)	90	Deadly - Paddle contact triggers immediate life loss (same behavior as type 42)

Hazard Brick Behavior:

• When the paddle touches a hazard brick (types 42 or 91), it immediately triggers a life loss

• This occurs regardless of how many balls are currently in play

• Unlike normal ball losses (LowerGoal), hazard bricks always cause life loss

• Only one life loss per frame even if multiple hazard bricks are contacted simultaneously

Direction Bricks

Index	Image	Name	Score	Description
43 ✅️		Down	125	Accelerates ball downward
44 ✅️		Left	125	Accelerates ball leftward
45 ✅️		Right	125	Accelerates ball rightward
46 ✅️		Up	125	Accelerates ball upward
47 ✅️		Up-Right	125	Accelerates ball up and right
48 ✅️		Up-Left	125	Accelerates ball up and left
52 ✅️		Phone	40	Randomizes ball velocity and direction

Special Bricks

Index	Image	Name	Score	Description
49		Teleport	150	Teleports ball to another random teleport brick
51		Hourglass/Slow	30	Slows down ball and mouse
53		Question	Random	Transforms into a random brick type
55		Magnet (Enabled)	-	Active magnet - attracts ball
56		Magnet (Disabled)	-	Inactive magnet - becomes active when enabled one is destroyed

Level Bricks

Index	Image	Name	Score	Description
50 ✅️		Smiley/Level Up	0	Advances to next level
54 ✅️		Level Down	0	Returns to previous level
41 ✅️		Extra Ball	0	Grants +1 life (clamped to max 5), plays unique destruction sound

Paddle-Destroyable Brick

Index	Image	Name	Score	Description
57 ✅️		Bat	250 (paddle)	Cannot be destroyed by ball, only by paddle

Solid/Indestructible Bricks (Index 90-97)

These bricks cannot be destroyed and don’t count toward level completion.

Index	Image	Name	Description
90 ✅️		Solid	Indestructible, ball bounces off
91 ✅️		Solid Die	Deadly - Kills paddle on contact
92		Solid Down	Solid + accelerates ball downward on bottom hit
93		Solid Left	Solid + accelerates ball leftward
94		Solid Right	Solid + accelerates ball rightward
95		Solid Up	Solid + accelerates ball upward on top hit
96		Solid Up-Left	Solid + accelerates ball up and left
97		Solid Up-Right	Solid + accelerates ball up and right

Magnet System

• Only one magnet can be active at a time

• When an enabled magnet (51) is destroyed, a random disabled magnet (52) becomes enabled

• The magnet creates a force field that attracts the ball

LIFE Levels

Some levels use Conway’s Game of Life algorithm (2-3-3 variant):

• Bricks in rows/columns 0 and 19 don’t die at generation change

• Generation stones in columns 3, 4, 5 of row 0 determine respawning brick types

• Ball/paddle starting position determines if LIFE mode is active

Future Additions

Image	Description
	Invisible brick (proposed)
	Rubber brick (proposed)

Sound Effects

Each brick type triggers a specific sound when hit