# Roots Beneath Neon — Game Design Document

Sep 30, 2026 · @Emily  Sakurada

Roots Beneath Neon is a 2D top-down narrative vertical slice in Godot 4.7: an immortal cultivator walks a rain-soaked Neo-Shanghai and recovers the memories of the forest that stood there three hundred years ago. The slice has a title screen, a painted prologue and two playable missions, and ends on "The forest is still here."

## 1. Overview

&#91;image: Title key art\]

| Item | Detail |
| --- | --- |
| Title | Roots Beneath Neon |
| Genre | Narrative exploration, environmental storytelling |
| View | 2D top-down (three-quarter), single character |
| Engine | Godot 4.7, GDScript, Forward+ |
| Platform | Desktop (built and tested on macOS) |
| Session length | Not yet timed with players |
| Purpose | Portfolio vertical slice: narrative design, systems design and layered 2D environments |
| Slice scope | Title screen, painted prologue, Mission 01 and Mission 02, end card |

**Pitch.** Three hundred years ago this street was a forest. The Cultivator, who cannot die, comes home to find it buried under Neo-Shanghai. Using Qi Sight, he reads the memories still held in pipes, trees, stones and roots, and learns the forest is not gone. It is waiting.

**Design pillars**

1. **Double exposure.** The modern city and the ancient landscape occupy the same space; Qi Sight and memories let the player see both at once.
2. **The environment is the guide.** No waypoint arrows in Mission 02. Spiritual roots under the pavement are the navigation language.
3. **Growth without numbers.** Progress is a jade leaf that grows. No XP, counters or bars.
4. **Quiet choices.** A choice changes how the Cultivator understands loss, not whether the player "wins".

## 2. Story & world

The story is told through places, not exposition: each object the Cultivator examines holds a memory of what stood there before the city.

&#91;image: Prologue slide 1 — "This was a forest"\]

**Setting.** Neo-Future Shanghai at night, in constant rain. Neon, cables and stacked shopfronts sit on top of a landscape that was once forest, a river called the Jade Thread and small roadside shrines.

**Protagonist.** The Cultivator (修士), an immortal who spent centuries in this forest cultivating qi. He does not change; the world around him does. His voice is spare and observant.

**Key story threads**

| Thread | What it is | Where it appears |
| --- | --- | --- |
| The Jade Thread | The river the Cultivator drank from, now running through a pipe | Prologue, Mission 01 (rusted pipe), Mission 02 forest memory |
| The living root | A spiritual root still carrying qi under the city | Mission 01 handoff, all of Mission 02 |
| The shrine and the old woman | "Someone should remember they're here." | Mission 02 shrine echo |
| Something calling the roots home | The open question the slice ends on | Mission 02 ending |

**Prologue.** Six painted slides: *This was a forest* → *The Jade Thread* → *Return in spring* → *Three hundred years later* → *I came home* → *Qi*.

**Tone.** Melancholy but not hopeless. The city is not the villain; forgetting is. Both endings of the river choice are valid ways of grieving.

## 3. Visual direction

The look is high-detail pixel art of a wet neon night: warm lanterns, magenta and cyan signage, cherry blossoms and jade qi, all seen from a three-quarter top-down camera.

### Original concept map (Mission 01)

The first concept for the street, before it was split into separate layers. It set the palette, the camera angle and the three story anchors: the Eternal Youth billboard (top right), the Jade Thread pipe (bottom left) and the cybernetic arm (bottom right).

&#91;image: Original Mission 01 concept map\]

&#91;image: Approved concept rebuilt from separate object layers\]

### Double exposure: city and memory

The same street in the present and during a memory. The ancient overlay is a separate layer faded in over a darkened city.

&#91;image: Neo-Shanghai, present day\]

&#91;image: The same street remembered\]

### UI mockup directions

Three directions were explored for the dialogue box and key hints. The final UI combines A's calligraphic warmth (the red 修士 seal, serif text, 观 examine icon) with C's dark jade panel so it reads over bright neon.

| Direction | Idea | Kept in the final UI |
| --- | --- | --- |
| A — Ink & paper | Parchment box, red seal, green hills | Seal, serif type, 观 icon |
| B — Cyber terminal | Mono type, neon frames, "ID: UNREGISTERED" | Pink/cyan accent for choice B |
| C — Hybrid | Dark jade panel over split city/forest | Panel colour, jade choice A, key-cap hints |

&#91;image: Direction A — ink and paper\]

&#91;image: Direction B — cyber terminal\]

&#91;image: Direction C — hybrid\]

## 4. Core gameplay

The loop is walk → sense → examine → remember → grow: the player explores a street, uses Qi Sight to find what the city has buried, examines it, lives a short memory and feeds the leaf.

### Controls

| Input | Action |
| --- | --- |
| W A S D | Walk (arrow keys stay free for choices) |
| E / Enter / Space | Examine, advance dialogue |
| ← → or 1 / 2 | Pick choice A / B |
| Q (hold) | Qi Sight |

### Mechanics

| Mechanic | How it works | Feedback |
| --- | --- | --- |
| Examine | Walk into an object's zone; an "E Examine" prompt appears | Typed monologue with portrait expressions |
| Memory | While a memory plays, the city darkens and the ancient landscape fades in over the same spot | Ghost overlay, mist, forest ambience |
| Qi Sight | Hold Q; the street cross-fades to its qi layer. Mission 01 floats A/B/C hints; Mission 02 reveals roots, shrines and trees instead | 观 QI SIGHT indicator, neon dims |
| Hidden objects | Some encounters (the shrine echo) only answer once seen through Qi Sight up close | "Remember" prompt appears |
| Choice | Mission 01's rusted pipe offers two readings of the river | Changes the street and later dialogue |
| Leaf progression | Every recovered memory feeds a jade leaf in the corner; 6 growth stages | Motes fly to the leaf, it grows; no numbers |

### Leaf growth by route

One memory = 1.0 qi = one growth stage. Turning away from the river still recovers that memory, but only half.

| Point in the slice | Hopeful route (listen) | Mournful route (turn away) |
| --- | --- | --- |
| After Mission 01 | 3.0 — side branch | 2.5 |
| Dead tree (pulse only) | 3.0 | 2.5 |
| Shrine echo | 4.0 — glowing sprig | 3.5 |
| Living root | 5.0 — living spiritual root | 4.5 |

## 5. Mission 01 — A River Still Runs

Objective: *Trace the source of the qi.* The player finds three memories in any order on one open street (1867 × 842 px); the third triggers the closing line and hands off to Mission 02.

&#91;image: Mission 01 street as built (scenes/main\_final.tscn)\]

### Encounters

| Anchor | object\_id | Memory | Result |
| --- | --- | --- | --- |
| Eternal Youth billboard (top right) | holo\_screen | A clearing where he meditated ten winters under the moon | +1.0 qi |
| Rusted pipe / Jade Thread (bottom left) | rusted\_pipe | Kneeling to drink from the river; now she runs through a pipe | Choice; +1.0 or +0.5 qi |
| Cybernetic arm (bottom right) | cyber\_arm | An old woodcutter who shared his fire | +1.0 qi |

### The river choice

| Choice | Line | Street changes | Ending line | Flag |
| --- | --- | --- | --- | --- |
| A — "Press a palm to the pipe. Listen." | "They buried you. They did not kill you." | A jade sprout pushes up through the pavement | "The forest is still here. It is only waiting." | river\_alive = true |
| B — "Turn away. Rivers end." | "Why should you be the exception?" | The ad blazes and flickers; the city gets louder | "I remember. That will have to be enough." | river\_alive = false |

### Ending and handoff

After the third memory: closing line → *MISSION 01 · COMPLETE* card → *MISSION 02 · THE ROOT REMEMBERS* card on the same street. A spiritual root wakes under the pavement, Qi Sight opens once by itself to show it running east, and the east edge leads into Mission 02. The east edge is also open from the start, so players may walk into Mission 02 early.

The street keeps Mission 01's three delivery robots and robot kiosk.

&#91;image: Mission 01 robots on the approved map\]

## 6. Mission 02 — The Root Remembers

Objective: *Follow the awakened qi.* The player follows a spiritual root, visible only through Qi Sight, from Mission 01's street through a denser, darker, taller district to a single living plant under an elevated train line. There are no waypoint markers.

&#91;image: Mission 02 district, west to east (scenes/mission\_02.tscn, 4800 × 1300 px playable)\]

### Layout

| Zone (west → east) | Feel | Encounter |
| --- | --- | --- |
| Seam | An exact copy of Mission 01's east edge, then the paving hands over | — |
| Commercial corridor | Tall shopfronts both sides, lamps, vending machines | Dead tree |
| Service alley | Narrow, darker, steam and bins | Shrine echo |
| Populated street | Food stall, lanterns, lit restaurants | Night-shift worker |
| Under the transit line | Concrete pillars, a train overhead, very little nature | Living root |

### Beat flow

&#91;embedded content: Mission 02 beat flow · 7 beats\]

Each encounter is locked until the one before it is done, so the root always leads forward; the leaf grows only at the shrine and the living root.

### Entry

The first frame of Mission 02 matches the last frame of Mission 01 (same street, same camera); the camera then eases forward. Arriving early (before finishing Mission 01) plays the Mission 02 title card on arrival.

&#91;image: The seam: Mission 01's paving handing over to Mission 02\]

### Encounter 1 — Dead tree

A municipal planter holds a young dead tree. *"This tree is young. Younger than the road. Younger than the buildings. But its roots know mine."* On that line a 2–3 second memory raises the ancient tree over the same spot. The leaf only pulses: not every discovery feeds it.

&#91;image: Dead tree memory\]

### Encounter 2 — Shrine echo

The alley looks mundane until Qi Sight reveals a small spectral shrine. It only answers once seen up close. *"She came every winter. She never asked the gods for anything… 'Someone should remember they're here.'"* Remembering her dissolves the echo (one stone lantern stays), sends qi along the root into the Cultivator, and the leaf grows.

&#91;image: Shrine echo through Qi Sight\]

### Encounter 3 — Night-shift worker

The strengthened qi passes under a commuter (camera shake, city audio dips). *"…Did you feel that?" "Feel what?" "Like… the ground moved. Probably the train."* He leaves; the Cultivator: *"No. Not the train."* This confirms the phenomenon is physically real, not only in his head.

&#91;image: Night-shift worker\]

### Final area — The living root

Under the transit line the root seems to vanish. Holding Q reveals a network of dark, dormant roots, and one faint jade root alive. It leads to a crack at a pillar's foot where three real leaves grow. Touching it plays the strongest memory of the slice: the forest, the shrine and the Jade Thread over the modern city. Then only the living root remains.

&#91;image: Root network revealed by Qi Sight\]

&#91;image: Forest memory\]

### Ending

*"The river remembers. The roots remember. … Something is calling them home."* Then the Mission 01 callback, the leaf grows, NEW OBJECTIVE: *Find the source of the living root*, a slow camera pull-back showing the Cultivator small against the city, and the end card.

| river\_alive | Callback lines |
| --- | --- |
| true | "I knew I heard you." / "Show me where you're going." |
| false | "I thought remembering would be enough." / "Apparently, you disagree." |
| not set (skipped Mission 01) | No callback |

&#91;image: End card\]

## 7. Systems & technical architecture

Everything is driven by one reusable component, NarrativeInteractable: each encounter emits signals, and every other system listens instead of being called directly. A mission is a scene plus a director script; nothing is hard-wired between missions except one handoff setting.

&#91;embedded content: Runtime architecture · signal flow\]

A new encounter needs only a NarrativeInteractable with its lines; the director decides what it unlocks and how much qi it feeds.

### Scenes

| Scene | Role |
| --- | --- |
| scenes/ui/title\_screen.tscn | Main scene: title, key art, start / skip prologue |
| scenes/prologue.tscn | Six-slide painted prologue |
| scenes/main\_final.tscn | Mission 01 street |
| scenes/mission\_02.tscn | Mission 02 district (generated by a build script from the layout) |
| scenes/ui/\*.tscn | Leaf, objective toast, mission card |

### Autoloads

| Autoload | Holds |
| --- | --- |
| GameState | Recovered memories (qi, 0–5), story flags such as river\_alive, mission\_01\_complete |
| SceneRouter | Scene changes with fade, mist, ink or crossfade transitions |

### Reusable components

| Script | What it does | Used in |
| --- | --- | --- |
| narrative\_interactable.gd | Zone, prompt, paged monologue, per-line speakers and portraits, A/B choice, flag-dependent lines, locked / auto-trigger | Every encounter |
| dialogue\_ui.gd | Typed text, portraits, choice rows, 修士 seal for the Cultivator only | Both missions |
| qi\_sight\_topdown.gd + atmosphere\_2d.gd | Hold-Q dial; neon dims; "qi\_only" group fades in | Both missions |
| leaf\_progress.gd | Six-stage jade leaf; grows from GameState, pulse() without growth | Both missions |
| player\_final.gd + mask\_nav.gd | WASD walking, 4-direction walk frames, walkability from a mask image | Both missions |
| slice\_director\_2d.gd | Mission 01 choice consequences, ending, handoff, early exit | Mission 01 |
| mission2\_director.gd | Mission 02 beats, locks, leaf feeding, callback, ending camera | Mission 02 |
| root\_trail.gd | Glowing spiritual root along a path: pulses, alive/dormant, grow-in | Handoff root, all Mission 02 roots |
| memory\_overlay.gd | Place-based memory: veil + ghost set fade in, hold, fade out | Mission 02 memories |
| occluder\_fade.gd | Fades the train deck when the player walks under it | Mission 02 |
| RobotWander.gd | Delivery robots patrolling an area | Both missions |

**Collision.** Walkable ground is a black-and-white mask image per mission (assets/map2/walkable\_mask.png, assets/mission2/world/walkable\_mask.png). Props block by footprint ellipses painted into the mask; people and robots never block the player.

## 8. Art & asset pipeline

All art is by Sai and arrives as zipped packages of separate transparent PNGs; each is unpacked into its own folder and placed in scenes at its native size or smaller, never stretched.

### Production art sets in use

| Package | Folder | Contents | Used for |
| --- | --- | --- | --- |
| Approved Map Object Layers / All Concept Map Pieces | assets/map2 | Mission 01 paving, walk mask, 49 object sprites | Mission 01 street; its spare props re-used in Mission 02 |
| NeoShanghai Memory Update | assets/final | Walk frames, dialogue bust, memory ghost, glows, mist | Player, Mission 01 memory |
| Quiet Memory Effect | memory\_fx | Pipe stream, willow, mist overlays | Mission 01 memories |
| Roaming Robots | robots | Three robot sprites + wander script | Both missions |
| Mission2 Production Assets | assets/mission2/production | 6 three-quarter buildings, street ground, transit overpass, 7 props | Mission 02 environment |
| Qi Overlays | assets/qi\_overlays | 8 high-resolution qi sprites (trees, root tangle, gates, shrine, leaves) | Mission 02 Qi Sight and memories |
| NPC Sprites | assets/npc/NightShiftWorker | Night-shift worker walk cycle | Mission 02 encounter |

&#91;image: Mission 02 production buildings and props\]

&#91;image: Production qi overlays\]

### Rules that keep the two missions cohesive

1. **Native size or smaller.** Sheets that required enlarging (the first two Mission 02 sheet sets, the first overlay sheet) were rejected: they rendered 5–7× coarser than Mission 01.
2. **Whole objects, one projection.** Buildings are complete three-quarter structures; facade/rooftop layering was dropped because it mixed two camera angles.
3. **Mission 01 props at Mission 01 scale.** Lamps, benches, bins, bollards and robots in Mission 02 are Mission 01's own sprites at identical scale.
4. **Light only where there is a source.** Street reflections are baked under each lamp, sign and lit shopfront; the base paving is unlit.
5. **Effects stay separate layers.** Rain, steam, memory ghosts and qi overlays are their own nodes so opacity is controlled independently.
6. **Gameplay geometry is locked.** Art swaps never move walk masks, encounter zones or root paths.

### Folder layout (after clean-up)

| Folder | What lives there |
| --- | --- |
| scenes/ | Title, prologue, Mission 01, Mission 02, UI scenes |
| scripts/ | core (autoloads), ui, narrative, mission, mission2, world, topdown, 2d, final, fx |
| assets/map2, assets/final, memory\_fx, robots | Mission 01 art |
| assets/mission2/production, assets/mission2/world | Mission 02 art and its baked street + walk mask |
| assets/qi\_overlays | Qi and memory overlays |
| assets/intro, assets/ui, assets/portraits, assets/audio | Prologue, UI and portraits |
| source\_packages/ | The original zips of the art in use (ignored by Godot) |
| docs/images/ | Concept art and previews used in this document (ignored by Godot) |

## 9. UI/UX and audio

The interface stays out of the way: hints fade after a few seconds, the objective appears once then lets go, and the only permanent element is the leaf.

| Element | Behaviour |
| --- | --- |
| Key hints (top left) | WASD walk · E examine / next · Q hold: qi sight; fade to a whisper while moving, return when idle |
| Qi Sight indicator | 观 QI SIGHT glows top right while Q is held |
| Jade leaf (top right) | Round moon window, 6 growth stages, motes fly to it when a memory is recovered |
| Examine prompt | Floats over an encounter when in range ("Examine", "Remember", "Touch") |
| Dialogue box | Blossom-framed dark jade panel, typed text, portrait expression per line, 修士 seal for the Cultivator only |
| Choices | Two rows: jade A (listen) and neon B (turn away); arrows, 1/2 or mouse |
| Mission card | Kicker, drawn rule, title, optional objective line; used for start, complete, new objective and end |
| Objective toast | Appears once; no permanent quest tracker |

**Audio.** EraAudio layers three generated beds: city hum, forest, and water. The forest rises during memories, water rises with Qi Sight and the Jade Thread memory, and the city dips for the night-shift worker's tremor. Choice B raises the city bed permanently.

## 10. Production log

Mission 02 was designed, built and art-passed on 30 September 2026; Mission 01's content was not changed except where noted.

| Step (newest first) | Change | Mission 01 affected? |
| --- | --- | --- |
| 13 | Removed a planter that blocked the alley-to-street passage; verified the whole district is one walkable area | No |
| 12 | Replaced all qi and memory art with the 8 high-resolution Qi Overlays, native size or smaller | No |
| 11 | Rejected the low-resolution overlay sheet (labels baked in, would need 4–5× enlarging) | No |
| 10 | Removed ambient pedestrians from both missions; kept robots and the night-shift worker | Added then removed 4 pedestrians |
| 9 | Added NPC sprite sets; night-shift worker replaces the stand-in commuter | No |
| 8 | Street re-lit from sources only; Mission 01 props and six robots added to Mission 02 | No |
| 7 | East edge of Mission 01 always open: early entry into Mission 02 | Yes: one setting on the director |
| 6 | Swapped to Sai's production buildings, street and overpass; gameplay geometry locked | No |
| 5 | Diagnosed the style gap: sheet art 5–7× coarser, mixed projections | No |
| 4 | Rebuilt Mission 02 art from the second (Neon) sheet set | No |
| 3 | Built Mission 02 end to end: district, four encounters, roots, memories, ending | No |
| 2 | Mission 01 → 02 handoff: waking root, Mission 02 card, seamless crossfade | Yes: ending continues instead of returning to title |
| 1 | Extended shared systems (interactable speakers, flag lines, locks; leaf pulse; Qi-only layer) without changing Mission 01 behaviour | Scripts only |

## 11. Known limitations and open questions

The slice plays start to finish on both river routes; what remains is art coverage and a few design calls.

| Area | Limitation | Possible fix |
| --- | --- | --- |
| Night-shift worker | No dialogue portrait; his lines show without one | A portrait from Sai |
| Progress | Not saved to disk; state lasts one play session | A save slot in GameState |
| Return path | No way back from Mission 02 into Mission 01 | West edge exit, if wanted |
| Early entry | Skipping Mission 01 leaves no river callback and a smaller leaf | Intended; confirm |
| Mission 02 texture | Mission 02 street tiles from one painted strip; some repetition at wide zoom | A full painted ground like Mission 01's |

**Open questions**

- [ ] Should the ambient crowd return in a lighter form, or stay robots only?
- [ ] Is early entry into Mission 02 part of the portfolio build, or a debug convenience?
- [ ] Does the slice need a save / continue option for reviewers?
