Ponscripter was created as an NScripter-style visual novel game interpreter with an emphasis on supporting games in Western languages.
This fork is intended to provide additional features to Ponscripter that make it more suitable for releasing games on Steam. It, however, does not have qualms with breaking compatibility in minor ways. See the CHANGES file.
Other engines focussed on Western-language games include:
- Ponscripter — The project this is based on
- Ren'Py — A modern visual novel engine with python scripting support.
Warning
On versions v3.0.2 and below, the "Umineko Steam release scaling mode" was the default, which could cause problems if you didn't specify a scaling mode (See #17 where Umineko Saku 2019 had graphical issues on v3.0.2 and below). This has been fixed on v4.0.0 and above.
The default scaling option for our fork (as of v4.0.0) expects an input game resolution of 640x480 (eg. older nscripter games), and applies 2x mode (doubles everything). This is equivalent to explicitly setting the scaling mode with ;value2500,mode640@2x.
This fork includes 2x mode, which can be used to support older Nscripter games at 2x resolution.
This feature has been added as an extra argument to ;mode (e.g. ;mode960@2x).
Widescreen support is also included, and can be enabled with ;modew720 or ;modew1080.
For example, our modded Umineko scripts have ;value2500,modew540@2x@umineko as the first line of the script to give a 1920x1080 output resolution (as the input height of 540 is doubled). As for the @umineko option, see below.
Please note that you MUST specify mode before specifying any other options like @2x, otherwise those commands will be ignored or cause problems.
We've added an additional option for scaling to suit the Umineko Steam release. This changes the behavior of font scaling, and also the getspsize command - See d2b5d19 and e9c7e03.
In most cases you will never need to use this scaling mode, but if you wish to enable it, add @umineko after the mode command, for example the very first commented line of your script could be something like ;value2500,modew540@2x@umineko
The below links contain general information about POnscripter (not specific to this fork of POnscripter):
- Ponscripter Tutorial - Most likely you should start here
- Ponscripter API Reference - Mirror of Uncle Mion's Ponscripter API reference
This incarnation of the engine has primarily been tested with the Umineko script.
We strive to keep the engine able to compile and run correctly without the Steam runtime/api, but the Steam platforms are our primary targets.
The following platforms are supported:
- Any modern Linux
- Windows 7/8/10
- OSX 10.9+
Any issues on these platforms should be reported.
Please report all bugs with this project on the issues page. Include your platform and, if possible, clear reproduction instructions.
The original Ponscripter engine was maintained and, in great part, created by Mion.
Ponscripter is built primarily on Ogapee's work, without which there would be nothing here.
The version of ONScripter taken as a base also includes notable contributions from Chendo (original English support), insani (further enhancements) and The Witch Hunt.
The following people (in alphabetical order) have contributed noteworthy patches and bug reports that have enhanced Ponscripter:
- Agilis
- chronotrig
- Daniel Oaks
- Euank
- Klashikari
- Mion of Sonozaki Futago-tachi
- Roine Gustafsson
- Roto
- Starchanchan
Apologies to anyone not mentioned — please let me know so I can set the record straight!
The 07th-Mod fork of this repo is brought to you with huge thanks to everyone mentioned above, but the latest changes are being maintained by the 07th-Mod team. If you have any issues with this fork, please feel free to report them on the issues page or bother us on Discord about it.
ONScripter is copyright © 2001-2007 Ogapee. The Ponscripter fork is copyright © 2006-2009 Haeleth.
Ponscripter is licensed under the GNU General Public License, version 2 or (at your option) any later version. See COPYING for details.