Fade Street [GB Studio Plugin]

Fade Street is a plugin for GB Studio 4, which overhauls how palettes are managed, both for Game Boy Color games and original four-shades-of-green Game Boy games.

With over 20 new events and some engine tweaks, Fade Street adds a whole new spectrum of graphical possibilities to your GB Studio Games.

No Crunch

Create smooth fades on DMG and CGB, with fine control over length and timing. No hue distortion, and no programming marathons required.

Orange Is the New Black

Fade to black. Fade to white. Fade to emerald, tangerine, nighttime, or absolutely any colour palette that you like.

Be Like Water

Use colour cycling to add motion to your background images, without the performance cost of tile swapping.

Create beautiful rivers, waterfalls, lakes, and oceans. Master fire, lightning, rain, and snow, or build cities of blinking lights.

Forty Seven Shades of Green

Use optional colour flickering to create seven-level colour gradients in monochrome games.

Installation and Usage

Fade Street is compatible with version 4.0+ of GB Studio.

To add it to a project, first download and unzip Fade Street Bundle 12.1.zip. There are several things inside the zip file. FadeStreet12.1/ is the actual plugin folder. Copy that into the plugins/ subfolder of your GB Studio Project.

The new events should now be available to use in GB Studio, listed in the event group Fade Street.

Quick Start Guide

Also in the zip file is a guide, quick_start.html. It explains more about what the plugin does, and why. You should only read this guide if you want to use the plugin correctly.

Sample project

Finally, there is a sample GB Studio project, FadeStreetDemoProject. It includes the project file and assets for the demo cartridge embedded at the top of this page, and has a lot of explanatory comments.

To get practical examples of how the plugin events are used, or to learn how to recreate any of the effects from the demo cartridge, you should open this sample project in GB Studio and read the notes.

Can You Use This In Your Games?

Yes, you are free to use this plugin in your GB Studio projects, including commercial ones. You don't need to pay anything. Credit is appreciated, but not required.

Credits and Acknowledgements

Some of the source files included in Fade Street are derived from GB Studio by Chris Maltby and used under the terms of the MIT License.

Code for converting to and from the Oklab colour space is derived from public domain code by Björn Ottosson.

The Game Boy Color emulator embedded in this page is binjgb by Ben Smith, used under the terms of the MIT License.