DVN Basics

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
- Characters
- Character Expressions
- Showing a Character
- Dialogue
- Labels / jumps
- Backgrounds & images
- Variables, Flags & Conditions
- Choice Menus
- Actions
- Macros
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:

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 narrationbg=— set or change the backgroundc=— show a charactern=— show a specific character namecp=— change character positioncf— fade a character ini=— display an imageo=— create a choice optionm=— play background musicstopMusic— stops the background musics=— 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.