Immersive16 min read

Writing for Virtual Reality (VR): Formatting 360-Degree Action

The viewer puts on the headset. They can look anywhere. There's no frame, no cuts, no control. How to script action that happens in every direction at once.

ScreenWeaver Logo
ScreenWeaver Editorial Team
March 20, 2026

VR script page showing spatial action directions; dark mode technical sketch, black background, thin white lines

Prompt: Dark Mode Technical Sketch, a VR script page with spatial direction indicators showing 360-degree action around the viewer position, compass-like markers, gaze cues annotated, thin white hand-drawn lines, solid black background, high contrast, minimalist, no 3D renders, no neon colors --ar 16:9

The viewer puts on the headset. They're standing in a forest clearing. Behind them, footsteps. They turn—a figure disappears into the trees. In front of them, a cabin. To their left, smoke rises. They look up: a bird circles overhead.

This is VR storytelling. The screen is everywhere. The viewer can look in any direction at any moment. There's no frame to compose, no edit to control attention—just space, and someone inside it.

Writing for VR requires abandoning almost everything you know about traditional screenwriting. The camera doesn't exist. Cuts are jarring. The viewer is both audience and participant. Your script must describe not a sequence of shots but a navigable environment where story happens spatially.

This is a different craft, and it demands a different format.


The Fundamental Shift: No Frame

Traditional screenwriting is built on the frame. You decide what the audience sees; they see exactly that. Close-up, wide shot, pan left—these are your tools of emphasis and control.

VR eliminates the frame. The viewer's head is the camera. They choose where to look. You can invite attention; you cannot force it.

This changes everything:

You can't cut. A cut in VR is disorienting—a teleportation. Used sparingly, it can work. Used constantly, it causes nausea.

You can't hide things. In film, you control what's off-screen. In VR, there is no off-screen. Everything within the environment is visible if the viewer turns around.

You can't guarantee they see the key moment. The climactic action might happen while the viewer is looking the wrong way.

These limitations are also opportunities. VR offers immersion no flat screen can match. The viewer isn't watching a story—they're inside it.

VR isn't a better movie. It's a different medium entirely.


Formatting Conventions for VR Scripts

There's no industry-standard VR script format, but working practices have emerged. Most VR scripts borrow from both screenwriting and video game design, creating a hybrid document.

Common elements:

Environment description (not scene heading). Instead of "INT. LIVING ROOM – DAY," describe the full 360-degree environment: "You stand in a living room. Ahead, a fireplace with dying embers. To your left, a window showing rain. Behind you, a hallway receding into shadow. Above, a chandelier with one bulb flickering."

Viewer position. Specify where the viewer "is" in the space. Are they standing? Seated? Moving? This affects what they can see and how they'll experience events.

Spatial action. Describe actions with directional cues relative to the viewer: "AHEAD – A figure enters through the door. LEFT – A clock chimes. BEHIND – Floorboards creak."

Gaze cues. Indicate what you want the viewer to look at and how you'll draw attention: "A bird calls sharply to the RIGHT. The viewer turns; they see the cabin."

Time-locked events. Some actions happen regardless of where the viewer looks. Others are triggered by viewer gaze. Distinguish these.


A Table: Spatial Direction Conventions

DirectionMeaning
AHEAD / FORWARDIn front of the viewer's default facing
BEHINDDirectly behind the viewer
LEFT / RIGHTTo the viewer's sides
ABOVEOverhead
BELOWAt feet level or beneath
PERIPHERALIn the edges of vision; not the focus
AMBIENTEverywhere; environmental

These conventions help directors, sound designers, and VR developers understand spatial intent.


Sample VR Script Excerpt


PROJECT: "The Clearing" RUNTIME: 8 minutes FORMAT: VR narrative, seated viewer


ENVIRONMENT 1: FOREST CLEARING – DUSK

You stand at the center of a forest clearing. The light is fading—gold and amber filtering through trees that ring the clearing in all directions. The ground is carpeted with fallen leaves. Ambient birdsong, distant. Air feels cool.

VIEWER POSITION: Seated, eye level approximately 5 feet. Subtle rotation allowed (seated swivel).


0:00–0:15 – ESTABLISHMENT

The viewer is allowed to look around freely. No directed action. Environmental immersion.

AMBIENT: Wind through leaves. Occasional bird call.


0:15–0:30 – GAZE CUE: BEHIND

A twig SNAPS sharply BEHIND the viewer.

GAZE CUE: Sound draws attention BEHIND. When viewer looks:

A FIGURE in a dark coat stands at the tree line—thirty feet away, motionless, watching. Face obscured by shadow.

If viewer does NOT turn, FIGURE remains until 0:45, then disappears.


0:30–0:45 – ESCALATION

AHEAD: The CABIN is now visible—a structure you didn't notice before, somehow. Small, wooden, a single lit window.

LEFT: Smoke rises from somewhere beyond the trees—too much smoke for a campfire.

AMBIENT: Birdsong has stopped. Silence now. Unsettling.


This format communicates spatial storytelling clearly. Each team member knows what happens where and when.


Drawing Attention Without Cuts

If you can't cut, how do you direct attention? VR writers use several techniques:

Audio cues. Sound is the most powerful tool. A sharp sound to the left makes viewers turn left. Spatial audio is essential—if you write it, the sound designer must implement it correctly.

Movement. Motion attracts the eye. A bird taking flight, a door swinging open, a character walking across the space. Place movement where you want attention.

Light. A sudden illumination—a lamp turning on, lightning, a flashlight beam—draws the gaze.

Character address. If a character looks at the viewer or speaks to them, attention follows. "Hey! Over here!" is a valid gaze cue.

Environmental change. Something appearing or disappearing in a particular direction.

You cannot guarantee attention, but you can design for probability. If a loud crash happens to the left, most viewers will look left.


A 360-degree action map for a VR scene; dark mode technical sketch, thin white lines on black background

Prompt: Dark Mode Technical Sketch, an overhead view of a VR scene showing viewer position at center with action events marked around the 360-degree space with timing annotations, thin white lines, black background, minimalist, no 3D renders --ar 16:9

Interactive vs. Passive VR

VR storytelling exists on a spectrum:

Fully passive. The viewer observes. They can look around but cannot affect the story. Like an immersive 360 film.

Semi-interactive. Gaze triggers events. Looking at an object might activate it. Limited agency.

Fully interactive. The viewer can move, pick up objects, make choices. Closer to a video game.

Your script must specify where on this spectrum the experience falls. A passive script focuses on environmental storytelling. An interactive script includes branching paths, object interaction logic, and multiple outcomes.

For this article, we focus on passive and semi-interactive VR—where the viewer is audience, not player.


The "Trench Warfare" Section: What Goes Wrong

Failure Mode #1: Writing Flat Screen Shots

The script reads like a traditional screenplay: "Close-up on hand picking up the letter." There are no close-ups in VR. The viewer controls their attention.

How to Fix It: Describe actions spatially. "The hand picks up the letter (AHEAD, at arm's length from viewer). The viewer can lean closer to read."

Failure Mode #2: Critical Action in One Direction

The story's climax happens AHEAD, but the script gives no cue. Half the viewers miss it because they were looking BEHIND.

How to Fix It: Use audio or movement to cue attention. Before the climax, draw all viewers AHEAD with a sound or event.

Failure Mode #3: Too Many Simultaneous Events

Actions happen LEFT, RIGHT, BEHIND, and ABOVE all at once. The viewer feels overwhelmed and misses everything.

How to Fix It: Layer spatially and temporally. Space out events. One direction at a time. Give viewers time to reorient.

Failure Mode #4: Overusing Cuts

The script transitions constantly: new environment, cut, new environment, cut. Viewers feel dizzy.

How to Fix It: Use fewer environments and longer sequences. When cuts are necessary, use fades or narrative transitions ("Three hours later...").

Failure Mode #5: Ignoring the Body

The viewer's position isn't specified. Are they standing? Seated? Can they walk? Ambiguity causes production confusion.

How to Fix It: Specify viewer position and mobility constraints in every environment description.


Case Study: Designing a VR Horror Sequence

Let's design a horror beat step by step:

Goal: Build dread, deliver a jump scare, and make the viewer feel unsafe in every direction.

Environment: A dark attic. Viewer standing. Boxes and covered furniture in all directions. Single light source (a candle AHEAD).

Phase 1: Establishment (0:00–0:30)

Viewer looks around. Nothing threatening. Environmental sounds: creaking, wind, distant traffic. Candle flickers.

Phase 2: Subtle Cues (0:30–1:00)

BEHIND: A soft scraping sound. Viewer turns—nothing visible. Just shadows.

LEFT: A shape moves in peripheral vision—was that a rat?

Candle dims slightly.

Phase 3: Misdirection (1:00–1:20)

AHEAD: A door rattles. Viewer focuses on the door. Tension builds. The door... stops rattling. Nothing happens.

Viewer relaxes.

Phase 4: Delivery (1:20–1:30)

BEHIND: A breath sound—close, intimate, as if someone is standing right behind the viewer.

Viewer turns BEHIND. A FACE is inches away—then DARKNESS.


The sequence uses spatial storytelling to build fear: sounds from multiple directions create paranoia, misdirection relaxes the viewer, and the payoff comes from the direction they just looked away from.


A storyboard frame showing viewer POV with spatial annotations; dark mode technical sketch, thin white lines on black background

Prompt: Dark Mode Technical Sketch, a VR storyboard frame showing a first-person view with directional annotations marking where action occurs around the viewer, thin white lines, black background, minimalist, no 3D renders --ar 16:9

Writing Dialogue in VR

Dialogue in VR requires spatial awareness:

Character position. Where is the speaking character relative to the viewer? Are they AHEAD? Moving from LEFT to RIGHT? Circling behind?

Direct address. Does the character speak to the viewer? Make eye contact? In VR, this is powerful—and potentially uncomfortable. Use intentionally.

Spatial audio. Dialogue must be spatialized. If the character is to the LEFT, their voice comes from the LEFT. Write this expectation into the script.

Viewer as character. Is the viewer a character in the story? Are they addressed by name? Can they "respond"? Even in passive VR, the viewer's role needs definition.


The Perspective: Presence Over Control

Traditional filmmaking is about control—shaping exactly what the audience experiences. VR is about presence—creating a space the audience inhabits.

This requires letting go. You can't control where they look. You can't guarantee they see the key moment. You can only build an environment so rich and so intentionally designed that wherever they look, the story is there.

In some ways, this is closer to theater than film. The stage is everywhere. Multiple actors might perform simultaneously. The audience member's attention wanders. The playwright creates a world; the audience experiences a version of it.

VR writing is world-building with invitation. You invite the viewer to look left. You hope they do. If they don't, the story still works—just differently.

That's not a limitation. That's the medium's unique power: no two viewers have the same experience. The story becomes personal because it depends on presence, attention, choice. Even in passive VR, the viewer's gaze is a form of agency.

Write for that agency. Respect it. Design around it.

[YOUTUBE VIDEO: A VR director explaining how they developed a narrative script for a 360-degree film, showing the difference between flat-screen thinking and spatial storytelling.]


Further reading:

Continue reading

ScreenWeaver Logo

About the Author

The ScreenWeaver Editorial Team is composed of veteran filmmakers, screenwriters, and technologists working to bridge the gap between imagination and production.