Customizing
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 when you return to the Main Menu by hitting Esc. So, Options is only accessible at startup (but the Daodan DLL makes the Options button accessible while the game is paused).
What settings are there?
- Amount of graphical detail (env-mapping, texture rendering, etc.)
- Resolution and color depth
- Gamma correction
- Overall volume (sound FX and music can't be adjusted separately)
- Subtitles
- Difficulty setting
- Inversion of the vertical mouse axis (this was implemented backwards!; 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 or OniLib - lets you alter saved game data (inventory, cheats)
- KeyConfig or Oni Key Editor - lets you configure the controls through a GUI
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".