Maze Generator — Help

Quick Start

1. File: import/export, save, and load settings.
2. Maze: Maze Size & Shape, Endpoints & reserved space, and Color & style (background, walls, cells).
3. Image: upload, filters, placement, and background removal.
4. Text: add and style text layers.
5. Reset: use master reset actions.
6. Help: open the full Help guide in a new tab; the Help menu also includes Flash Start / End, Patch Notes, and site links (Features, Privacy, Terms, Disclaimer).
7. Play: enter play mode.
8. Zoom controls: zoom 10%–500%, reset to 100%, or use the fit button to frame the whole maze.
9. Maze output: the generated maze preview.

Easy Mode

Start from the landing screen

The landing screen gives you three clear paths: Browse Samples, Use Image, and No Image.

Use a sample maze as a starting point

Choose Browse Samples to open the built-in sample gallery. Each sample loads a full configuration, so it is a good way to learn the app's styles and image workflows.

Upload your own image

1. Select Use Image.
2. Click Upload Image and choose a file from your device.
3. Adjust Background, Detail, Cell size, and Wall thickness.
4. Use smaller cell sizes for more image detail and larger values for faster, chunkier mazes.

Pick a basic style preset

Switch to the Style tab to apply a quick visual preset. Classic B&W is the clean default, while Dark Mode, Subtle Gray, and Blueprint give you ready-made looks without opening the full Color & style modal.

Create a colorized maze in Easy Mode

For photo-forward mazes, keep your uploaded image loaded and change Background to Colorized. Pair that with a smaller cell size or High Detail when you want more of the image to show through the paths.

Generate the maze and keep iterating

Click Generate Maze to close Easy Mode and render the current setup into the main workspace. From there you can use the regular menus for export, advanced image tuning, text, or endpoint adjustments.

If your goal is specifically a photo-style maze, see the dedicated colorized mazes guide for the Easy Mode and full-menu workflows side by side.

Maze Settings

Maze Size & Shape

One modal with tabs: Canvas, Cell size, Shape. Switching tabs does not trigger regeneration.

1. Preset: grid/canvas presets (e.g. Fine detail, 15×15, Auto fit viewport, Print ready); save/load icons export or import this section as JSON.
2. Canvas tab: Auto (fit viewport) or manual Width (px) and Height (px) (32–4096).
3. Cell size tab: Define grid by Cell size (cell size in px, wall thickness) or Rows & columns (rows, cols).
4. Cell size (px): 4–200 when defining by cell size.
5. Rows & columns: set the grid dimensions when defining by rows/columns.
6. Wall thickness: 1 up to one less than the current cell size; in Cell size tab.
7. Shape tab: enable custom shape cutout; mask type (shape or pattern image), radius, fit mode, invert; area outside the shape uses the color set in Color & style → Outside mask.

Endpoints & reserved space

1. Reserved space size: padding (px) around start/finish.
2. Min path length: factor to encourage longer routes.
3. Start/finish: automated or select on canvas, then Confirm in the floating panel. Flash via Help → Flash Start / End.

Color & style

Wall and background presets; colors for walls, cells/path, and outside mask; reserved area colors; background mode (Solid, Mirrored, Custom Image).

1. Wall color & opacity: maze line color and transparency.
2. Background preset: e.g. Outline No Color, Colorized Faint, Colorized Light, Colorized; save/load icons for JSON.
3. Cell / Path color & opacity: base fill behind the maze.
4. Outside mask: color for area outside the maze shape (Black, White, Transparent, or Custom).
5. Background mode: Solid (color only), Mirrored (pattern image), or Custom Image (separate upload, scale/pan).
6. Treat white as transparent: white pixels in pattern (and mirrored background) become transparent.

Image

Image menu opens: Blend Settings, Filters, Placement, and Background removal (and upload/image gallery from the toolbar).

Blend Settings (pattern)

1. Preset: combination or strength presets (e.g. Balanced, High detail).
2. Preview: active pattern thumbnail and blended result; gear icon opens Edges/Dots/Lines settings.
3. Blend mode: Probability Union, Any, Any 2, or All.
4. Edges, Dots, Lines: toggle each source and set weight (0–100).
5. Pattern intensity: 0–100 overall strength.
6. Max cluster area: limit size of blocked regions (pattern blend).

Filters

1. Preset: start from a filter preset.
2. Before/After: filter preview comparison.
3. Basic adjustments: brightness, contrast, saturation.
4. Color channels: RGB channel balance.
5. Blur: apply a Gaussian blur to the image.
6. Invert: toggle color inversion.

Placement

1. Preview: placement preview.
2. Maintain aspect ratio: preserve proportions.
3. Scale & pan: size and alignment controls.

Background Removal

1. Original: original image preview.
2. Result: masked preview.
3. View masks: inspect generated masks.
4. Auto mode: AI-driven background removal.
5. Manual mode: manual mask edits.
6. Custom mask editor: open the editor.

Text

Layer-based text editor: workspace preview (left) and sidebar with layers and settings (right). Double-click text on the canvas to edit inline. Text layers take priority over the image pattern in the maze. Google Fonts (Font tab → Source: Google Fonts) render correctly in the generated maze.

Layers & workspace

1. Add layer: toolbar + button creates a new text layer.
2. Layer list: click a layer to select it; use duplicate, delete, show/hide, and up/down arrows on each row.
3. Workspace: drag to move, corner handles to scale, top handle to rotate; double-click to edit text inline.
4. Snap to grid and Live preview: checkboxes below the layer list; live preview regenerates the maze as you edit.

Settings (tabs: Font, Layout, Color)

1. Layer text: textarea for the active layer (or edit on canvas).
2. Font tab: font source (Curated / Google Fonts), font, style, size (8–600 px). Google Fonts render in the maze when you generate.
3. Layout tab: position X/Y, scale, letter spacing (tracking), line height, rotation, Max Cluster (hollow text).
4. Color tab: Fill and Stroke color (with dropper to pick from maze), stroke width, Mask Tol (white = path mask).

Play Mode

• ▶ Play: enter play mode.
• D-pad: move through the maze (draggable).
• Start/Finish: blue square is start, target is finish.

Multiplayer (Experimental)

Create or join rooms to collaborate and play mazes with others in real time. All communication is peer-to-peer — no data passes through a central server.

Getting Started

• Create Room: Experimental menu > Create Room. A shareable link is generated.
• Join Room: Experimental menu > Join Room, or open a shared room link.
• Open Room: Re-opens the Room modal when already in a room.

Room Features

• Chat: Send messages to all peers. Desktop also has a floating chat widget.
• Send / Request Maze: Share your maze config or request a peer's.
• Play (Match Lobby): Invite peers to a match. Vote on whose maze to race through, ready up, and start together.
• Live Cursors: See peers' cursors on the canvas in real time.
• Draw Mode: Edit walls collaboratively (draw/erase thin or thick walls, freehand or line mode).
• Username: Edit your display name in the Room modal header. Name persists across refreshes for the same room.

Solve

• Solve: finds and shows solution paths.

Tips & Troubleshooting

• Performance: increase Cell Size, reduce blur, or avoid very large images.
• Mask issues: try Auto Mode again or refine with Manual Mode / custom mask editor.
• Alignment: use Placement scale/pan to align the pattern.

Shortcuts

• Mask editor pan: hold Space or Alt and drag (desktop).
• Straight strokes: hold Shift while painting.
• Close dialogs: Esc.