icon Configuring ONScripter-EN

Many advanced options of ONScripter-EN can be controlled by creating a text file called ons.cfg according to the syntax described on this page. Examples of things that can be configured are custom window sizes, debugging options, save directories, and fonts.

Creating the ons.cfg File

The ons.cfg file must be a plain text file. To create this file on Mac OS X:

  1. Open TextEdit and create a new document.
  2. Select Make Plain Text from the Format menu.
  3. Enter the options you want into the file, referencing the documentation below.
  4. Select Save As... from the File menu.
  5. Navigate to the game folder, and enter ons.cfg for the file name.
  6. Click Save.

Your changes will take effect the next time you start the game. If you want to edit your ons.cfg file later, use the Open command in TextEdit's File menu, or drag the ons.cfg file to TextEdit's icon. If you double-click the ons.cfg file, it probably won't open in the right program.

Adding Options to ons.cfg

The ons.cfg file should have one option per line. If an option does not take any arguments, it should be on a line by itself, e.g.:

fullscreen

If an option takes an argument, then the argument should appear after the option, separated by an equals sign (with no spaces):

window-width=1024

Fonts

font=fontfile

Use fontfile as the game font, instead of default.ttf.

Languages

english

Force English text mode.

japanese

Force Japanese text mode.

Window Modes

fullscreen

Always start in full screen mode.

window

Always start in windowed mode.

window-width=width

Rescales the game to have a window width pixels wide.

Paths

root=path

Use path as the root path for game resources. The default is the bundle's Resources directory.

save=path

Use path as the game's save folder. The default is a folder in the user's Application Support folder.

Debugging

strict

Treat script warnings more like errors.

debug

Generate debugging output (goes to the Console log.) Use multiple times to increase verbosity.