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:
- Open TextEdit and create a new document.
- Select Make Plain Text from the Format menu.
- Enter the options you want into the file, referencing the documentation below.
- Select Save As... from the File menu.
- Navigate to the game folder, and enter ons.cfg for the file name.
- 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.