DVN Basics

Project DVN

The following content describes the basic features of DVN, but not in-depth, just surface level. each individual section is described in-depth elsewhere in the documentation.

Contents


Scenes

In DVN, every scene becomes a scene node in the engine's scene graph.

This means scripts can freely jump between scenes, regardless of where they appear in your project or which script file they are defined in. Scenes in DVN are global, addressable nodes, not tied to file order.

A scene can contain a wide range of content, including:

  • backgrounds
  • characters and expressions
  • character names
  • dialogue and narration
  • images and overlays
  • animations
  • labels and markers
  • options / choices
  • effect chains & transitions
  • and other interactive objects

Below is an example scene from The Classroom Where Tomorrow Never Comes:

1

Characters

Characters in DVN are defined as named images inside:

data/game/characters.json

A default entry looks like this:

{
  "Stickman": {
    "default": "Normal",
    "Normal": "data/game/characters/Stickman.png"
  }
}

Character Expressions

If you want multiple expressions or variants, simply create additional entries under your specified character:

{
  "Stickman": {
    "default": "Smiling",
    "Smiling": "data/game/characters/Stickman_Smiling.png",
    "Sad": "data/game/characters/Stickman_Sad.png"
  }
}

Each entry acts as its own image and can be used like any character variant.

Showing a Character

To display a character in a scene using default behavior:

c=Stickman

If you want to show them with a specific pose or expression simply do:

c=Stickman,Sad

Dialogue

To write a dialogue in DVN you simply use the text command.

text=Hello World!

It can also be shortened like below.

t=Hello World!

Both will create the same text scene.

You can also place the text on the screen somewhere like a narrator or inner-monologue by using the narrator command.

narrator=150,150
t=What have I done?

The above will render the text "What have I done?" at the pixel coordination 150,150.

A scene can contain multiple text nodes.

t=First text
t=Second text
t=Third text

You can also ommit t= which will automatically create narration text.

Hello World!

The above will render the text "Hello World!"

Labels / jumps

To jump to another scene you simply use the :scene postfix for commands.

This can be placed on text nodes and option nodes.

There is no way to jump into the middle of a scene, all jumps must be to a specific scene.

[main]
First text
t:continue=Second text

[continue]
Third text

Backgrounds & images

First you need to specify your backgrounds in the file:

data/game/backgrounds.json

The format is the exact same as characters.json

{
    "Background": {
      "path": "data/game/backgrounds/bg.png"
    }
  }

Backgrounds can be set using the background or bg command.

bg=Background

**Note: Backgrounds carry over to the next scene unless a new background is specified.

[main]
bg=Background
t:next=We have a background.

[next]
We still have a background.

Variables, Flags & Conditions

DVN does not allow you to define or modify variables directly inside the narration script.
If you need variables, logic, counters, flags, or gameplay state, these must be handled in D code using DVN's event system.

This design is intentional: DVN keeps the scripting format as close as possible to a real screenplay or narrative script.
Narration and code should stay separate.

For details on how to work with variables, events, and logic, see the Scripting Language documentation.

Choice Menus

Choice menus in DVN are extremely simple.
You create them using the option command (or o for short).

Example:

[main]
Do you like DVN?
yes -> Yes
no -> No

[yes]
Yay!

[no]
Aw :(

This will display the question “Do you like DVN?” along with two options: “Yes” and “No.”
Each option jumps to the scene label specified after the colon (yes or no in this example).

Actions

Actions are the commands you use inside a scene to make things happen - such as showing characters, changing backgrounds, playing sounds, or displaying dialogue.

Some common actions include:

  • t= — show dialogue or narration
  • bg= — set or change the background
  • c= — show a character
  • n= — show a specific character name
  • cp= — change character position
  • cf — fade a character in
  • i= — display an image
  • o= — create a choice option
  • m= — play background music
  • stopMusic — stops the background music
  • s= — play a sound effect

These will be used frequently throughout your DVN scripts.
For full syntax and advanced usage, see the Scripting Language documentation.

Macros

Macros in DVN are basically syntactic sugar for including another scene's structure within the given context.

You use macros with the @ symbol followed by the scene to include.

Example:

[school-afternoon]
bg=school_afternoon
m=school_afternoon_music

[school-afternoon-scene]
@school-afternoon
It is afternoon!

Note: macros will include ALL scene contexts, so be cautious about when you use it.