Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

What VN-Mikro is

VN-Mikro is a player for visual novels. You give it a folder — your script, your pictures, your music — and it plays that folder as a finished game.

my-game/
  game.json          your game's name and settings
  story/script.txt   the story, written like a play
  characters/        character pictures
  backgrounds/       scene pictures
  audio/             music and sound effects

There is no editor to learn and no project file to keep in sync. You write in any text editor, press one key, and the player shows the change.

What you write

Most of your time goes into script.txt. It reads like a script for the stage or screen:

[bg street fade 0.5]
[hana left]
HANA:
You came back.

> Of course I did. -> stay
> I'm just passing through. -> leave

Who speaks, what they say, where the scene goes next. The bracket lines are stage directions: show this place, bring in this character.

When a scene needs more — a precise camera move, a custom menu, a character with blinking eyes — you add a small settings file next to the script. The script stays readable.

What the player does

Everything a player expects from a visual novel is already there: text that types out, a name plate, choices, save and load, stepping back through lines, a history log, title and pause menus, a settings screen, and builds for desktop, web and phones.

You do not build these. You decide how they look and when they appear. The next page lists them: What VN-Mikro handles for you.

Who it is for

VN-Mikro is made for story-first games: kinetic novels, dialogue-heavy stories, branching romances, mysteries. If your plan is “write the scenes, then dress them”, you are in the right place.

It is not a general game engine. If your game is mostly a custom minigame with some dialogue around it, a full engine suits you better.

The spirit is closer to classic Japanese script engines (think KiriKiri / KAG) than to a full game IDE: plain script, data beside it, player runs the folder. Those tools went quiet; the habit of writing VNs as text didn’t.

Built on a proven engine

The player is built with the Godot engine, so it runs smoothly on Windows, macOS, Linux, the web and Android. You never open Godot yourself — you only work with your project folder.

Next

What VN-Mikro handles for you