LVNAuth Tutorials - Sequences

Sequences

A sequence is a type of animation that is like flipping through a picture book quickly, from one picture to another, creating the illusion of movement. LVNAuth can use a sequence animation to show multiple images, one at a time in sequence. The speed of the image changing can be specified.

Creating a sequence

Example:

<sequence_create: flying bird, object, 0.5, flap 1, flap 2, flap 3>

The <sequence_create> command prepares a sequence, it doesn't play it.

In the command example above, the breakdown of each argument is the following:

sequence_create - flying bird is the name of the sequence. It can be any name you want, as long as the sequence name doesn't already exist.
- object is the sprite type. This tells LVNAuth where to find the image. Supported sprite types are: object, character, dialogue sprite
- 0.5 is the number of seconds to show each image. 0.5 means half a second.
- flap 1 is the name of my object sprite for the first image.
- flap 2 is the name of my object sprite for the second image.
- flap 3 is the name of my object sprite for the third image.

Playing a sequence

So now that the sequence has been created, we can play it like this:

<sequence_play: flying bird, 10>

We give it the name of the sequence to play, followed by the number of times to play the sequence.

10 means play through the images 10 times.

To repeat the sequence, use the keyword: repeat

<sequence_play: flying bird, repeat>

Stopping a sequence

To stop the sequence, use <sequence_stop>, like this:

<sequence_stop: flying bird>

Aliases and sequences

A sequence animation causes the same image to be replaced by the next image, if they share the same alias.

If the aliases of the images in the sequence are not the same, then a different sprite image might get replaced with the next image. This could be what you're trying to do if, for example, you're trying to animate a light show where light bulbs illuminate one bulb at a time. Typically however, the sprite images in a sequence will share the same alias.

First, let's see how aliases work without a sequence.

To show any sprite in your visual novel, you first need to load the sprite so LVNAuth knows that you want to use the sprite in your visual novel.

Example:

<load_character: theo_smile, theo>
<load_character: theo_normal, theo>
<load_character: theo_sad, theo>

In this case, we're telling LVNAuth that we want to load three character sprite images: - theo_smile - theo_normal - theo_sad

I've also specified that each of those character sprites should have the alias theo

Now, I'll show the first sprite.

<character_show: theo_normal>

Now the first sprite (theo_normal) will be replaced by theo_smile.

<character_show: theo_smile>

Now the third sprite (theo_sad) will be replaced by theo_smile.

<character_show: theo_sad>

But how did LVNAuth know that theo_normal needs to be replaced by theo_smile? It's because the alias for both sprites are the same.

The same principle applies to sequences. If the aliases of sprite images are the same in a sequence, the 'current' image will be replaced by the 'next' image because LVNAuth will know that the sprites are related due to having shared aliases.

And now the same 3 command lines above would look like this in a sequence:

<sequence_create: theo change, character, 0.5, theo_normal, theo_smile, theo_sad>
<sequence_play: theo change, repeat>

Last updated: Tue 07 July 2026