Visual Novel Framework

Visual Novel Framework

A Visual Novel framework. Supports custom scripts and features a python based DSL for scripting.

by
3.7K Downloads
forgeneoforgegame-mechanicslibraryutility
Rent Server with this Mod

About this Mod

Visual Novel Framework

This is a Framework to give Mod Maker and others to add VN-like cutscenes/scenes inside the game.

Description

This mod requires a Script to Play.

The mod leverages Vanilla Resource Pack system, so installing a script is identical to installing a Resource Pack. Drag and drop into the Resource Pack folder. Inside the script, usually, there should be a 'trigger word'

Name a mob this 'trigger word' and right click it with the item to talk with it.

Have fun!!!

Features

  • Dialogue System, VN Style
  • Custom Scripting / Pseudo DSL and a Framework and an SDK for Script Development
  • Branching Dialogue
  • Variable Tracking System (inside the game)
  • 2D Sprite, like Visual Novel
  • Multiple Sprite System!
  • Align Character Position and Such~

CUSTOM SCRIPTS!?!?

  • YES!
  • I made a scripting language just for this in Python!
  • Use the Hikarin SDK to create and compile scripts!
  • More info can be found in the SDK Read Me

Compatibility?

Okay this is an interesting topic.

Since this mod relies on two things, the Mod Itself and the SDK/Framework there are some notes about compatibility:

  • Script written using the newest SDK will always be compatible with the Older Version of the mod.
  • If the script contains a missing feature (Say, you made a script using the latest SDK and run it in the Mod Beta version that doesn't support background), well, the script will run, just the background won't change.
  • Script written using the older SDK will always be compatible with the Newer Version of the mod. (Though, this may vary, but backwards compatibility should always be possible. Report a bug for problems with Compatibility.).

What about Cross Mod Compatibility? Modpacks?

  • The Visual Novel Engine running inside Minecraft is written in Pure Java it is independent of Minecraft itself.
  • The 'modded' / 'minecraft' part of thing is the UI. A mod that messes with how Minecraft handle UI (overrides the Guigraphics for example), will not be compatible.
  • On that note, feel free to use this on your mod, modpacks, whatever~

Coming Soon

  • DBMS for permanent variable and state tracking (Might be out of scope, but ironically available in Alpha version)
  • Animation Feature (Not out of scope and is being worked on, but ironically is the one getting put on hold)

Mod Github Page: Minecraft Visual Novel Framework

SDK Github Page (to make scripts): Hikarin Visual Novel SDK

Can I Use This In My Modpack???

Yes, Go Ahead, This Thing Is Made For That!!!

But… Consider letting me know / discuss it with me so I can help you with getting it set up.

Since script development is somewhat separate from Modding, it can be a bit confusing if you're not used to Python.

Discussion + Query: My Discord Server

In case you missed it:

Multiplayer Incompatible

Available Versions

Visual Novel Framework 1.0.6release
MC 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10neoforge
October 19, 2025
Mob Talker Framework 1.1.0release
MC 1.20.1forge
November 23, 2024
Mob Talker Framework 1.0.5release
MC 1.20.1forge
November 14, 2024
Mob Talker Framework - 1.19.2 - 1.0.2 release
MC 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4forge
November 5, 2024
Mob Talker Framework 1.0.2release
MC 1.20.1forge
November 4, 2024

How to Install Visual Novel Framework on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set forge Loader

In the panel under "Egg", select the forge loader and matching Minecraft version (1.21.10).

3

Install Mod

Open the mod browser in the dashboard and search for "Visual Novel Framework". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

forgeneoforge

Minecraft Versions

1.21.10, 1.21.9, 1.21.8 (+13 more)

Server-side

Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Visual Novel Framework server crashes on startup – what to do?

Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.10). You can switch loaders with one click in the panel.

Is Visual Novel Framework compatible with forge and neoforge?

Visual Novel Framework officially supports forge, neoforge for Minecraft 1.21.10, 1.21.9, 1.21.8. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Visual Novel Framework – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Visual Novel Framework consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install Visual Novel Framework with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
GNU Lesser General Public License v3.0 only
Server-side
Required

Supported Versions

1.21.101.21.91.21.81.21.71.21.61.21.51.21.41.21.31.21.21.21.1+6 more