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

One of the first things you may want to do after installation is apply a No-CD patch...

My personal source was GameCopyWorld : you'll find a patched US version of Oni.exe and instructions for creating backup CDs. geyser

Feel free to add links to other patched executables or standalone patches here.

Tools

• OniTrainer - 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.

(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 build does not seem to have this feature.)

Only the ones in bold seem to have an effect so far

• -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 OS X port (a Cocoa application), you have to pass the parameters to the actual binary, which is confusing for some users. Use the Terminal to navigate to the Oni folder, so you are at the same level as the game application, then type "Oni.app/Contents/MacOS/Oni -noswitch".