GBC Scene Forge

LOCAL PROJECT

Project folder

First scene guide

Close the guide to edit. Reopen it from the header to continue. Next only moves through instructions; it does not perform or verify an edit. Guide position is stored in this browser.

Close document?

Recover unsaved work

Drafts may belong to another open tab. Restoring opens unsaved edits; the saved scene stays unchanged until you save.

Keyboard & workspace help

P: Paint / Pencil · E: Erase · F: Fill · S: Select · H: Pan. These shortcuts act on the active scene or artwork canvas.

Artwork only: I: Eyedropper · L: Line · R: Rectangle · M: Move selection. Use arrow keys within tool radio groups. Scene movement preview uses its own keys while active.

⌘/Ctrl S: Save (artwork requires review then confirmation) · Z: Undo · Shift Z / Y: Redo · C/X/V: Copy/Cut/Paste · D: Duplicate. Text entry, dialogs and command popovers keep their own keyboard controls.

Use Hide Library and Hide Inspector at the pane edges for drawing room. Show them again with the same edge buttons. Frames & animation expands timing controls; the active frame and drawing scope remain above artwork.

GBC budgets

Checks the current canvas against 8 background/window slots and 8 sprite slots. Includes hidden layers and all frames of animations linked to placed artwork.

Reserve slots for UI/window content, effects and dynamic actors. Leave blank if unknown; enter zero only when no additional slots are needed. Unknown reservations cannot pass preflight.

Optional tile and sprite estimates

Static layout: BG bank 0, OBJ bank 1; 256 8×8 tiles each. All layers and animation frames resident; no pixel deduplication or camera culling. Blank reservations mean unknown.

GBC palette checks are off.

Assumes static residency without palette streaming. Preview playback does not affect counts. A pass covers this palette budget; the game build must verify its remaining requirements. Generic Tiled export stays available.

Portable Tiled export

Download a ZIP containing maps, tilesets and images with portable relative paths.

Export creates a snapshot. Project files and editor undo history stay unchanged.

Convert selected sprites to static scenery

Save a tile representation with identical pixels first. Only the selected saved sprite objects change. Source artwork, animation sequences and other placements remain. Origins must map exactly to the scene grid. Gameplay metadata requires an explicit change before conversion.

Agent draft

Draft details

    

  
  
  
  
    

      
Tile terrain & collision

      
Shared tileset metadata affects every instance of this tile. Atlas artwork stays unchanged. Save or undo changes before choosing another cell.

      

      

        
        
Terrain transition
          
          
Check the edges that connect to the same terrain. Unchecked edges face empty space or another terrain. All 16 combinations form a complete set.

          

            
            
            
            
          

          

        

        
Solid without custom shapes uses the full tile. Custom shapes define their own footprint.

        

        
        

        

        
        
Shape coordinates use whole pixels from the tile's top-left. Polygon points are x,y pairs separated by spaces. Keep shapes inside the tile, including its edges.

      

      
      

    

  
  
    
World view

    
Drag scenes to arrange your world, or select one and set its coordinates. Connections describe authoring intent; they do not run game transitions.

    
Endpoint checks include current unsaved scene edits and hidden layers. Save scene edits separately to retain new or changed endpoints.

    
    
Choose a scene

    
Connections

    
Endpoint findings

    
    
    

  
  
    

      
Object definitions

      
Define reusable objects with typed fields and shared defaults. Saving updates inherited values and preserves overrides. Definition changes are saved immediately, outside scene undo. Shape and artwork changes apply to new placements.

      
      
      
      
      

      
Typed fields

      
      

    

  
  
    

      
Edit object

      

      
      

      
      

      

      

      
Custom properties
Choose a type for each value. Property names must be unique. Changing a type resets its draft value.

      

      
      

    

  
  
    

      
Create a blockout scene

      
Plan with labeled geometry and markers. Artwork can be added later on its own layer.

      
      

      

      
Gameplay camera

      

      

      

      
Pixels must divide evenly by the grid. Scenes support at most 65,536 cells and 8,192 pixels per axis; the camera must fit inside the scene. These are configurable planning values, not a runtime camera controller.

      
      

    

  
  
    
Blockout camera & overview

    

    
A read-only snapshot of visible plan layers, including unsaved edits. Artwork is reviewed alongside the plan on the main canvas; these SVGs show planning geometry only. This is not a jump, climbing or physics simulation.

    
Full route
Full blockout route with geometry, labels and camera guides

    Download overview SVG
    
Player camera
Blockout from the selected gameplay camera frame

    Download camera SVG
    

  
  
    

      
Create scene

      
Choose the canvas dimensions. Imported sprites keep their own native size.

      
      
At most 65,536 cells and 8,192 pixels per axis (1,024 cells at grid 8; 512 at grid 16; 256 at grid 32).

      

      
Width and height are in cells. Sprites can be placed at any pixel.

      
      

    

  
  
    

      
Import artwork or map

      
      

      
Choose the folder containing your atlas manifest and PNG. Its artwork is copied into this project.

      
No folder selected

      
      
      
The selected manifest’s declared PNG is included automatically. Source files stay unchanged.

      
Enter a manifest path instead

      
      
Matches the atlas ID and preserves placements. Removed or resized regions stop the update.

      

      
      
      
      

    

  
  
    
Save before switching projects?

    
This scene has unsaved changes. Save them before switching projects.

    
    

      
      
      
    

  
  
    
Save before switching scenes?

    

    
    

      
      
      
    

  
  
    
Discard unsaved changes?
Save this scene before continuing to keep your current edits.

  
  
    

      
Rename scene

      
      
      

      
      

    

  
  
    

      
Resize / crop scene

      
At most 65,536 cells and 8,192 pixels per axis.

      

      

      
      
      
Green outline: new scene. Red: discarded area.

      

      
      
All layers, including hidden layers, move together. Rectangles crossing an edge are clipped; points and sprites outside by their anchor are removed. Sprite artwork retains its native size. Undo restores the entire edit. Save commits it to disk.

      
      
      

    

  
  
    
Load latest artwork?

    
This discards this document’s manual edits, Undo/Redo history and recovery checkpoint, then loads its latest saved version. Download work first to keep a copy.

    

  
  
    

      
Delete scene?

      

      
      
      
This removes the scene from this project. Shared atlases and other scenes stay available. This action cannot be undone in the editor.

      
      

    

  
  
    

      
Delete atlas?

      

      
Removes the atlas’s imported files from this project. Its original source files stay unchanged. Atlases used by saved scenes cannot be deleted.