cuebox. GitHub

An adventure framework for Godot

Big adventures.
Giant pixels.

For strange little worlds.
And the people who make them.

You bring the characters, the puzzles and the questionable uses for a rubber chicken. Cuebox brings the moving parts.

Make your first scene Try the sample

Open source. MIT licensed. Entirely yours.

somewhere_interesting.gd
A pixel-art workshop at night: a moonlit window, glowing radio, wooden drawers and a very persistent plant.
YOU

“There’s definitely a story in here.”

POCKETS·Click around. It’s an adventure.

✳ An interactive illustration. Your world could be next.

GODOT 4.7.2 verifiedGDSCRIPT All the way downMIT Build it your wayMade for the point & click of it.

01 / The moving parts

Less reinventing the inventory.
More putting weird things in it.

Your story has enough
loose ends already.

Cuebox handles the machinery of a pixel-art adventure, so you can spend your time on the things a player will remember.

01

A place to get lost.

Walkable rooms, hotspots and transitions. Give your world a floor plan, then fill it with things worth clicking.

ROOMS / WALK BOXES / OBJECTS
02

People with baggage.

Multiple playable characters, each with their own inventory. Conversations, item interactions and cutscenes included.

CAST / DIALOGUE / INVENTORY
03

The details that stay.

Save slots, autosave, music, sound and reading preferences. Plus hooks for translation and your own game systems.

SAVES / AUDIO / PRESENTATION

Built in a real adventure. Extracted for the next one.

Look under the hood

02 / A very small adventure

Play in your browser

The Last
Signal.

A quiet radio shack. A dark rooftop beacon. A valley waiting to hear from you.

Meet Rae in Cuebox’s original two-room sample. Find what’s broken. See what’s in the drawer. Make a little connection.

01 Click to walk or use.
02 Select an item, then its target.
03 A little curiosity does the rest.

Every bit of it is in the repo
THE LAST SIGNALOpen in a new tab
The Last Signal’s rooftop beacon against a starry mountain sky.

Free to play · No account · Loads on click

A tiny working example, ready to take apart.
Sample saves stay in this browser. Desktop or landscape works best.

03 / Your next rabbit hole

NO SUBSCRIPTION. NO ROYALTIES.

A room. A script.
A possibility.

Ordinary GDScript. Your own assets. A small framework you can actually read.

Clone the project, open it in Godot 4.7.2 and press F5. The sample is your starting point: swap in your cast, draw your rooms and write what happens next.

Read the getting-started guide

Verified with Godot 4.7.2. Other versions haven’t been verified yet.

START HERE
# One repo. One little adventure.
git clone https://github.com/ajokela/cuebox.git
cd cuebox
godot --editor --path .
rooms / radio_shack.gdGDSCRIPT
extends "res://engine/room_script.gd"

func use_radio(who: String, item: String) -> void:
    if item == "fuse":
        take(who, item)
        set_flag("radio_ready")
        await say(who, "WE’RE BACK ON THE AIR.")
    else:
        await say(who, "IT NEEDS A NEW FUSE.")

You write the interesting part.

Small framework. Clear boundaries.

Made to be understood.
And made your own.

Cuebox is a code-first framework on top of Godot. You author the content; it runs the adventure. It isn’t a visual puzzle editor or an art generator.

The runtime gives you local saves and extension points. Your game owns its content pipeline, save migrations and platform integrations.

Engine overview ↗Authoring guide ↗Contributing ↗

The next scene is yours.

Go make something
worth clicking.

Get Cuebox on GitHub

Free to use, change and ship. Keep the MIT notice.