Customizing

Options menu

Where is it?

• It's accessible via the third button of the Main Menu
• After you load a game, this button is replaced with Resume. So, Options is only accessible at startup
  (which is really silly : Resume is then redundant of the Escape key, and the ability to change settings at runtime is lost.)

What settings are there?

• Amount of graphical detail (env-mapping, texture rendering, etc)
• Resolution and color depth : from "640 x 480 x 16 bit" to "1600 x 1200 x 32 bit"
• Gamma correction
• Overall volume (sound FX and music can't be adjusted separately)
• Subtitles
• Difficulty setting
• Inversion of the vertical mouse axis (seems to be messed up : if the box is checked, moving the mouse up makes you look up, so you get non-inverted aiming)

Controls

Here's how controls can be changed

• Edit the key_config.txt file manually
• Use the built-in GUI (press and hold Shift while Oni starts -- currently broken for both Mac OS X and Windows)
• Use the KeyConfig GUI tool
• Set custom keybindings at runtime using scripts

Binding syntax and instructions.

Further customization

CD check

Some versions of Oni.exe have been known to require the game CD-ROM in the drive (or at least some CD named "ONI" ;-), but the app distributed with the standard U.S. release does not perform that CD check. The app is found here.

Tools

• ONI-Trainer - lets you set a few runtime variables (with bindable hotkeys)
• OniSavegameEditor - lets you alter saved game data (inventory, cheats)
• KeyConfig - lets you configure the controls through a neat GUI
• OniCheatEnabler - lets you use cheats in the off time that the No-CD patch disables cheats

Hacking

You can e.g. unlock all of Konoko's combat moves from the very first level.

Scripting

Well, just look at the scripts page to find out more about those.

Command-line arguments

You can run Oni from your system's command prompt rather than clicking on the automatically generated shortcut. This enables you to use a number of options that are otherwise unavailable. Only the ones in bold seem to be useful.

(Historical note: In Oni for Mac OS 9, users could access these options via a special dialog that popped up if you pressed SHIFT during Oni's startup, but the OS X apps lack this feature.)

• -combos : unused
• -debug
• -debugfiles : Additional debug files are dumped, e.g. low-level script debugging.
• -ehalt : unused
• -findsoundbinaries : unused
• -findsounds
• -glide : unused
• -ignore_config : unused
• -ignore_private_data : Disables the loading of "private data" in level0.
• -nodialog
• -nosound : Sounds and music are disabled. The "Overall volume" control in Options has no effect.
• -noswitch : Oni doesn't fill up the screen. Instead, it stays in a "window" in the top left corner. The resolution is that specified ingame.
• -opengl : unused

You can combine those options on a single command line so that they apply simultaneously.

For example, here's a batch file I've been using lately (Win32/DOS script called, say, oni.bat, and located in Oni's installation folder):

rm saved_film*.dat
start OniTrainer\oni_trainer.exe
start oni -noswitch -debugfiles

What does it do? It cleans up the saved movie files (if any). Then it starts Alloc's OniTrainer and Oni. Oni runs in a window.

The output generated by -debugfiles sometimes helps when debugging scripts (though not very often, not to say never).

noswitch

-noswitch is probably the most useful of the command-line arguments. If run in a low resolution like 640x480, Oni will take only a little portion of your screen, leaving the taskbar accessible, as well as other applications you may be running alongside Oni (useful for scripting, hex hacking, etc).

The parameter is easy to pass to the Windows executable from the command line (see script above); with the Mac OS X app, you have to pass the parameters to the actual binary, which confuses some users. In the Terminal, instead of "Oni.exe -noswitch", you would type "Oni.app/Contents/MacOS/Oni -noswitch".