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 (Mac only, press and hold Shift while Oni starts)
• 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.

(Mac users can access those via a special prompt screen that pops up if you press SHIFT during Oni's startup.)

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

• -combos
• -debug
• -debugfiles : Additional debug files are dumped, e.g. low-level script debugging.
• -ehalt
• -findsoundbinaries
• -findsounds
• -glide
• -ignore_config
• -ignore_private_data
• -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

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). In the Mac version, -noswitch can be specified in a dialog displayed at startup. On PC as well as with the OS X port, that dialog is unavailable. The command-line parameters are easy to use on PC (see script above); with the OS X port (a Cocoa application), it's a bit more complicated; see HERE (troubleshooting thread on Oni Central Forum).