Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

VNDS-LOVE Switch: Difference between revisions

From GameBrew
No edit summary
(:/)
Line 1: Line 1:
{{Infobox Switch Homebrews
{{Infobox Switch Homebrews
|title=VNDS-LOVE
|title=VNDS-LOVE
|image=vndsloveswitch.png
|image=vndslovenx.png
|description=A visual novel player for Windows, Mac, Linux, and the Nintendo Switch
|description=A visual novel player for Windows, Mac, Linux, and the Nintendo Switch
|author=ajusa
|author=ajusa
Line 8: Line 8:
|version=0.0.13
|version=0.0.13
|license=Mixed
|license=Mixed
|download=https://dlhb.gamebrew.org/switchhomebrews/vndsloveswitch.7z
|download=https://dlhb.gamebrew.org/switchhomebrews/vndslovenx.7z
|website=https://github.com/ajusa/VNDS-LOVE
|website=https://github.com/ajusa/VNDS-LOVE
|source=https://github.com/ajusa/VNDS-LOVE
|source=https://github.com/ajusa/VNDS-LOVE
|donation=  
|donation= https://ko-fi.com/ajusa
}}
}}
{{#seo:
VNDS-LOVE is a program that allows you to play [[VNDS|Visual Novel Dual Screen (VNDS)]] formatted novels on multiple platforms. Many famous visual novels have been ported to this format, which was designed for the Nintendo DS.
|title=Switch Homebrew Games (Other Games) - GameBrew
 
|title_mode=append
VNDS is a specification designed for visual novels in order to run them on the Nintendo DS. Many of the original sources for the project no longer exist, but you can find further information on it at [https://github.com/BASLQC/vnds/wiki this wiki page].
|image=vndsloveswitch.png
 
|image_alt=VNDS-LOVE
VNDS novels only have a few commands. As such, they don't have any support for animations, videos, or other fancier graphical capabilites of newer visual novels. They support basic audio and image based storytelling.
}}
 
VNDS-LOVE is a program that allows you to play [[VNDS|Visual Novel Dual Screen (VNDS)]] novels on multiple platforms. This format, originally designed for the Nintendo DS, has been used to port many famous visual novels.
==Installation==
The following instructions are from VNDS-LOVE [https://docs.google.com/document/d/e/2PACX-1vRoZeD_wTko3X7FnARS2HtUerTUABwqnfnEJQpuEG9GQ0UvbnWFdbhvg7eEYsFNnMxTUJ7F9dupMCjQ/pub#h.bhmoknllvpee Install Guide].
 
First, make sure that your Nintendo Switch has CFW on it. This program is only tested on [[Atmosphere Switch|Atmosphere]], [https://nh-server.github.io/switch-guide/ here is a link] to a guide that will show you how to set it up.
 
Once you have CFW, go to the [https://github.com/ajusa/VNDS-LOVE/releases release page] and download the Nintendo Switch file. Unzip the file and place it into your SD card under /switch. So, the final path should look like <code>sdmc:/switch/VNDS-LOVE.nro</code>.
 
After that, open the homebrew menu by holding R down when launching a game. VNDS-LOVE cannot run in applet mode (where you just open the album). You should see a program titled VNDS-LOVE, click on it to start playing a visual novel.
 
==User guide==
VNDS-LOVE only supports playing through [https://github.com/BASLQC/vnds/wiki VNDS visual novels]. These are novels that were converted to this format to be played either on the original Nintendo DS or on Android. This means that the number of novels this project can play through is fairly limited.
 
What you can do, is learn how to port visual novels over to [[VNDS]], or write a program that does that.
 
===Novel structure===
After downloading and unzipping a VNDS novel, you should end up with a directory structure looking something like this:
 
├── background.zip
├── default.bcfnt
├── default.ttf
├── foreground.zip
├── GLOBAL.SAV
├── icon-high.png
├── icon.png
├── img.ini
├── info.txt
├── instructions.txt
├── prologue.xml
├── script.zip
├── sound.zip
├── thumbnail-high.jpg
├── thumbnail.png
└── title.mp3
 
There are a few important files to make sure to have here. You will need to have:
*background.zip
*foreground.zip
*script.zip
*sound.zip
 
If any of the zip files are unzipped and are folders, that is fine as well. VNDS-LOVE first checks the folder before trying to use a zip file.
 
===Save format===
VNDS-LOVE does support saving, although it is currently limited to one save slot.
 
The save file is located at <code>.../novels/NOVEL_NAME/save.json</code>
 
If you see a .SAV file or anything else, you can ignore that. Those save files are for a different VNDS player.
 
===How to install a novel===
VNDS-LOVE searches for one directory when trying to look for a novel.
 
It looks at <code>SAVE_DIR/novels/NOVEL_NAME</code>
 
So an example path would look something like <code>SAVE_DIR/novels/fsn</code> where fsn has img.ini, background.zip, etc...
 
===Where is SAVE_DIR===
The directory that VNDS-LOVE outputs when starting is where it looks for novels. Adapted from https://love2d.org/wiki/love.filesystem


In case you're wondering, VNDS is a specification specifically created for visual novels to enable them to run on the Nintendo DS. Although some of the original sources for this project are no longer available, you can find more information about it on this wiki page.
The path for Nintendo Switch is <code>DIRECTORY_WITH_NRO/save/VNDS-LOVE</code>


One of the notable characteristics of VNDS novels is their limited set of commands. Unlike newer visual novels, they lack support for animations, videos, and other sophisticated graphical features. However, they do support basic audio and image-based storytelling.
Again, a novel would go under <code>SAVE_DIR/novels/NOVEL_NAME</code>


The project is mostly functional, and no known VNDS-related bugs have been reported. Nevertheless, some features from other visual novel engines may be missing. If you come across any missing features, you can file an issue with a general description of the feature.
==Controls==
D-Pad - Select a choice


VNDS-LOVE supports multiple platforms, including Windows, Mac, Linux, [[VNDS-LOVE 3DS|3DS]] and the Nintendo Switch. Keep in mind that you need to have a Switch that can run homebrew to use VNDS-LOVE on that platform. For more information, you can refer to the guide below.
B - Close menu


For additional information about the VNDS specification and the catalog of adapted novels, please visit: https://github.com/BASLQC/vnds/wiki. Fate/stay night, Tsukihime, and Higurashi are among the most frequently played ones.
A - Go forward


==Installation==
Start - Open a menu
First, make sure that your Nintendo Switch has CFW on it. This program is only tested on [[Atmosphere Switch]], here is a link to a guide that will show you how to set it up.


Once you have CFW, go to https://github.com/ajusa/VNDS-LOVE/releases and download the Nintendo Switch file from the latest release (you will need to unzip it). This file should go on your SD card under /switch. So, the final path should look like “sdmc://switch/VNDS-LOVE.nro”
In older releases there wasn't a menu, so you would hit X to save.


After that, open the homebrew menu by holding R down when launching a game. VNDS-LOVE cannot run in applet mode (where you just open the album). You should see a program titled VNDS-LOVE, click on it to start playing a visual novel!
==Media==
[https://www.reddit.com/r/SwitchHacks/comments/g9zu0x/wip_running_vnds_fatestay_night_on_a_switch/ Demo video.]


==Known issues==
==Known issues==
Only partially supported on Switch. See [https://github.com/ajusa/VNDS-LOVE/issues/16 this issues].
Please see [https://github.com/ajusa/VNDS-LOVE/issues/16 this issues].


==Changelog==
==Changelog==
'''v0.0.13'''
'''v0.0.13'''
*Fixes a bug ([https://github.com/ajusa/VNDS-LOVE/issues/37 #37]) related to font resizing when drawing the option menu (thank you @snuk182 for reporting and fixing the issue!)
*Fixes a bug ([https://github.com/ajusa/VNDS-LOVE/issues/37 #37]) related to font resizing when drawing the option menu (thank you @snuk182 for reporting and fixing the issue).


'''v0.0.12'''
'''v0.0.12'''
Line 78: Line 136:


== External links ==
== External links ==
* Github - https://github.com/ajusa/VNDS-LOVE
* GitHub - https://github.com/ajusa/VNDS-LOVE
* Reddit - https://www.reddit.com/r/visualnovels/comments/kpvf7d/vndslove_v006_a_visual_novel_player_for_windows/
* Reddit - https://www.reddit.com/r/SwitchHacks/comments/g9zu0x/wip_running_vnds_fatestay_night_on_a_switch/

Revision as of 11:44, 12 Mayıs 2023

VNDS-LOVE
Vndslovenx.png
General
Authorajusa
TypeOther Games
Version0.0.13
LicenseMixed
Last Updated2023/02/12
Links
Download
Website
Source
Support Author

VNDS-LOVE is a program that allows you to play Visual Novel Dual Screen (VNDS) formatted novels on multiple platforms. Many famous visual novels have been ported to this format, which was designed for the Nintendo DS.

VNDS is a specification designed for visual novels in order to run them on the Nintendo DS. Many of the original sources for the project no longer exist, but you can find further information on it at this wiki page.

VNDS novels only have a few commands. As such, they don't have any support for animations, videos, or other fancier graphical capabilites of newer visual novels. They support basic audio and image based storytelling.

Installation

The following instructions are from VNDS-LOVE Install Guide.

First, make sure that your Nintendo Switch has CFW on it. This program is only tested on Atmosphere, here is a link to a guide that will show you how to set it up.

Once you have CFW, go to the release page and download the Nintendo Switch file. Unzip the file and place it into your SD card under /switch. So, the final path should look like sdmc:/switch/VNDS-LOVE.nro.

After that, open the homebrew menu by holding R down when launching a game. VNDS-LOVE cannot run in applet mode (where you just open the album). You should see a program titled VNDS-LOVE, click on it to start playing a visual novel.

User guide

VNDS-LOVE only supports playing through VNDS visual novels. These are novels that were converted to this format to be played either on the original Nintendo DS or on Android. This means that the number of novels this project can play through is fairly limited.

What you can do, is learn how to port visual novels over to VNDS, or write a program that does that.

Novel structure

After downloading and unzipping a VNDS novel, you should end up with a directory structure looking something like this:

├── background.zip
├── default.bcfnt
├── default.ttf
├── foreground.zip
├── GLOBAL.SAV
├── icon-high.png
├── icon.png
├── img.ini
├── info.txt
├── instructions.txt
├── prologue.xml
├── script.zip
├── sound.zip
├── thumbnail-high.jpg
├── thumbnail.png
└── title.mp3

There are a few important files to make sure to have here. You will need to have:

  • background.zip
  • foreground.zip
  • script.zip
  • sound.zip

If any of the zip files are unzipped and are folders, that is fine as well. VNDS-LOVE first checks the folder before trying to use a zip file.

Save format

VNDS-LOVE does support saving, although it is currently limited to one save slot.

The save file is located at .../novels/NOVEL_NAME/save.json

If you see a .SAV file or anything else, you can ignore that. Those save files are for a different VNDS player.

How to install a novel

VNDS-LOVE searches for one directory when trying to look for a novel.

It looks at SAVE_DIR/novels/NOVEL_NAME

So an example path would look something like SAVE_DIR/novels/fsn where fsn has img.ini, background.zip, etc...

Where is SAVE_DIR

The directory that VNDS-LOVE outputs when starting is where it looks for novels. Adapted from https://love2d.org/wiki/love.filesystem

The path for Nintendo Switch is DIRECTORY_WITH_NRO/save/VNDS-LOVE

Again, a novel would go under SAVE_DIR/novels/NOVEL_NAME

Controls

D-Pad - Select a choice

B - Close menu

A - Go forward

Start - Open a menu

In older releases there wasn't a menu, so you would hit X to save.

Media

Demo video.

Known issues

Please see this issues.

Changelog

v0.0.13

  • Fixes a bug (#37) related to font resizing when drawing the option menu (thank you @snuk182 for reporting and fixing the issue).

v0.0.12

  • Fixes a bug (#35) related to text interpolation that was used in certain novels.
  • Fixed an issue with loading zipped folders on the 3DS platform, thanks @TurtleP for helping me debug that.

v0.0.11

  • Fixed an issue reported by Mishima on Discord that was causing listbox to fail.
  • Better error handling for when a file isn't found.
  • Might fix #33 (comment), haven't testing on Switch personally yet.

v0.0.10

  • Tried to fix audio crashing bug in #31.
  • Changed default rescaling to use linear as suggested in #32.
  • Trying to make sure that the font can't be nil at runtime to fix #33.

v0.0.9

  • Added a settings menu
    • You can change values by using the left/right buttons, such as the audio/music percent.
  • Can change the audio settings for both music and sounds, closing #22.
  • Tries to use the default.ttf if it is provided in a novel, closing #25.
    • This can be overidden in the settings.
  • Fixed an issue with being able to close the save menu.

v0.0.8

  • Added a menu. Access it by hitting the start button on a gamepad, or m(enu) with a keyboard. Close by hitting b (also b on keyboard).
  • Save slot support. You can now save and load from up to 10 slots per novel. This number is subject to increase in the future.
  • Ability to quit from within VNDS-LOVE! Open menu and then select quit.

v0.0.7

  • Use the mime type of a file to decide how to open it (fixes Kanon).

Release notes.

External links

Advertising: