Logo of altogether 2006

ONScripter: usage & troubleshooting

About this page

Most users will not need to read this page. You should just be able to install and run ONScripter games normally. However, if you experience any problems, this page should be your first port of call before you move on to request support from the al|together team.

Enhancements

The version of ONScripter used for these games includes some enhancements added as part of the work on Narcissu 2. These primarily affect packaging on OS X, but also improve compatibility on all other platforms.

The main change is the addition of customisable game save and game data paths, such that game data need no longer be in the same place as the executable, and saved games need no longer be created in that location.

On OS X, game data is sought by default in the Contents/Resources directory of the game application bundle, and saved games are stored in a directory ~/Library/Preferences/[name of game] Data (where the name of the game is set by a directive ";gameid [name]" at the top of the game script).

On Windows platforms, saved games are stored in a subfolder [name of game] of the all-users Application Data folder, meaning that the games should now be compliant with Vista standards.

On Linux and other POSIX-type platforms, saved games are stored in a hidden directory ~/.[name of game], and the game data can be stored in an FHS-compliant location such as /usr/local/share/games by passing '-r PATH' on the command-line.

Playing on unsupported platforms

The ‘Linux’ packages can be used to play ONScripter games on any platform. The onscripter file provided is a statically-linked x86 Linux binary; if it does not work for you, or if your platform does not support Linux binaries, you can simply replace it with a binary compiled for your specific platform and/or distribution to play the game.

Most precompiled ONScripter binaries are for Japanese games, so they will probably not have the English text support enabled. The safest approach is therefore to compile your own binary. Source code for this customised version of ONScripter is available here. You will also need a C++ compiler, GNU Make, and development versions of the libjpeg, bzip2, SDL, SDL_image, SDL_mixer, SDL_ttf, and SMPEG libraries installed; ready-to-use packages for these are available for most operating systems. Edit Makefile.linux.insani to select settings appropriate for your platform (you may want to remove the -static flag from the linker options) and execute make to build, then copy the resulting onscripter executable into the game directory and execute it.

— explicit pagina modus operandi onscriptris novis cum explicationes adversorum —