Backgrounds
Each of your scenes requires a background image that defines how that scene should look. You can add backgrounds to your game by including PNG files in your project's assets/backgrounds
folder.
Color Requirements
Background PNGs must only contain the following four colors:
Download the GB Studio Palette Swatches for:
Adobe Photoshop
Aseprite
Piskel
Colors that are not one of the above hex codes will be matched to the nearest color. Unlike sprites, the color #65ff00
can not be used in backgrounds.
Size Requirements
- Backgrounds are divided into
8px
x8px
tilesets so the total image size must be a multiple of8px
in both width and height. - A background has a minimum size of
160px
x144px
(the GB screen size) - Both the width and height of a background must be less than or equal to
2040px
. - The width of the image multiplied by the height must be less than or equal to
1,048,320
. For example an image with the width2016px
will have a max height of520px
(because2016 * 520 = 1048320
)
Tile Requirements
In most scene types a background image can contain no more than 192 unique 8px
x 8px
tiles at once due to memory limits. This means that even using the smallest background size possible you must repeat about half of your tiles. Where possible repeat tiles between images as they will be grouped together saving on total game size. It is recommended to use a tile map editor such as Tiled to ensure your backgrounds conform to the pixel grid.
The exception to this is scenes with their Scene Type set as Logo, these scenes can use a 160px
x 144px
sized image with no limits on unique tiles but note that in Logo scenes you are unable to use Actors or display a Player.