Customizing: Difference between revisions

From OniGalore
Jump to navigation Jump to search
m ("Difficulty setting" should link to the new article that explains what the levels do)
 
(15 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==Options menu==
==Options menu==
 
When Oni launches, Options is the third button on the Main Menu. But after you load a game, this button is replaced with '''Resume''' when you return to the Main Menu by hitting Esc. However, the [[Daodan DLL]] and [[FERAL|Intel Mac build]] make the Options button accessible while the game is paused. This is where you change or toggle:
===Where is it?===
*Amount of graphical detail
*It's accessible ''via'' the third button of the Main Menu
*Resolution and color depth
*After you load a game, this button is replaced with '''Resume'''. So, '''Options''' is only accessible at startup<br>(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
*Gamma correction
*Overall volume (sound FX and music can't be adjusted separately)
*Overall volume (sound FX and music can't be adjusted separately)
*Subtitles
*Subtitles
*[[Difficulty|Difficulty setting]]
*[[Difficulty modes|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)
*Inversion of the vertical mouse axis
:Fun trivia: mouse inversion was implemented backwards. If the box is checked, moving the mouse up makes you look ''up''... that's ''non''-inverted aiming. This is fixed by the [[AE]].


==Controls==
==Controls==
Here's how controls can be changed
[[Image:Classic_Oni_startup_options.jpg|thumb|Wouldn't it be nice if Oni had something like this? Oh well...]]
*Edit the '''key_config.txt''' file manually
The Classic Mac build of Oni had a simple control-setting dialog which would appear if launching Oni with Shift held down. No other version of Oni has any kind of GUI for setting key bindings. Here's how you customize your controls:
*Use the built-in GUI (press and hold Shift while Oni starts -- currently broken for both Mac OS X and Windows)
*Edit the '''key_config.txt''' file manually; see [[/Binding|Binding syntax and instructions]]
*Use the [[KeyConfig]] GUI tool
*Use the [http://mods.oni2.net/node/129 Oni Key Editor] Java tool for a GUI experience
*Set custom keybindings at runtime using [[BSL:Scripts|scripts]]
*Set custom keybindings at runtime using a global BSL script that employs the "bind" command
[[Customizing/Binding | 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 [http://m0002.gamecopyworld.com/games/pc_oni.shtml GameCopyWorld] : you'll find a patched US version of Oni.exe and instructions for creating backup CDs. [[User:Geyser|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)
*[[OSGE|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===
==CD check==
You can e.g. unlock all of Konoko's combat moves from the very first level.  
Some versions of Oni for Windows have been known to require the game CD-ROM in the drive (or at least some CD with the same name, e.g. "ONI" or "001228_1801" ;-), but the app distributed with the standard U.S. release does not perform that CD check. That app is found [http://mods.oni2.net/node/231 here].


===Scripting===
==Save-game editing==
Well, just look at the [[BSL:Scripts|Scripts]] page to find out more about those.
*[[OSGE|OniSavegameEditor]] (Windows)
*[http://mods.oni2.net/node/155 OniLib] (Mac)


===Command-line arguments===
==Command-line arguments==
You can run Oni from your system's command prompt rather than clicking on the automatically generated shortcut.
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. Here is how you pass Oni a command-line argument (multiple arguments can be supplied, as long as they are separated by a space character):
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.)''
*In Windows, you can make a shortcut to Oni and then add the argument on the shortcut's Properties window, or create a .bat file with contents like "start oni -noswitch".
*With the Classic Mac OS PPC Mac build of Oni, you can manually enter arguments via a special dialog that pops up if you hold down Shift during Oni's startup.
*With the Mac OS X PPC build of Oni, you must use Terminal to directly invoke the actual binary by typing "Oni.app/Contents/MacOS/Oni -noswitch".
*With the macOS Intel build of Oni, you can supply arguments using a file called launch_args.txt. Simply list the arguments on one line. Additional arguments accepted by the Intel build are listed on its [[FERAL|documentation page]]. You can also visually choose many arguments in a GUI launch panel by holding down Command while opening Oni; the panel additionally allows you to manually type in any arguments that are not represented in the GUI.


Only the ones in bold seem to have an effect so far
Here are all the arguments Oni accepts, but only the ones in bold seem to be useful:
*-combos : unused
*-combos: unused
*-debug
*-debug
*'''-debugfiles''' : Additional debug files are dumped, e.g. low-level script debugging.
*'''-debugfiles''': Additional debug files are dumped, e.g. low-level script debugging.
*-ehalt : unused
*-ehalt: unused
*-findsoundbinaries : unused
*-findsoundbinaries: unused
*-findsounds
*-findsounds
*-glide : unused
*-glide: unused
*-ignore_config : unused
*-ignore_config: unused
*-ignore_private_data : Disables the loading of "private data" in level0.
*-ignore_private_data: Disables the loading of "private data" in level0.
*-nodialog
*-nodialog
*'''-nosound''' : Sounds and music are disabled. The "Overall volume" control in [[Customizing#Options menu|Options]] has no effect.
*'''-nosound''': Sounds and music are disabled. The "Overall volume" control in [[#Options menu|Options]] thus 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.
*'''-noswitch''': Windowed mode (see below).
*-opengl : unused
*-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#Installation folder|installation folder]]):
===noswitch===
rm saved_film*.dat
'''-noswitch''' is probably the most useful of the command-line arguments. When launched with this argument, Oni stays in a window matching the resolution specified in Oni's Options menu instead of changing your screen resolution and going full-screen. Thus, if Oni is set to run in a low resolution like 640x480, the game will take only a portion of your screen, leaving you access to other applications that you may be running alongside Oni (very useful when modding).
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).
==Modding==
====noswitch====
See [[Installation#Mods|Installation]] page.
'''-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".
[[Category:Oni Support]]
[[Category:Oni Support]]

Latest revision as of 20:19, 7 December 2023

Options menu

When Oni launches, Options is the third button on the Main Menu. But after you load a game, this button is replaced with Resume when you return to the Main Menu by hitting Esc. However, the Daodan DLL and Intel Mac build make the Options button accessible while the game is paused. This is where you change or toggle:

  • Amount of graphical detail
  • 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
Fun trivia: mouse inversion was implemented backwards. If the box is checked, moving the mouse up makes you look up... that's non-inverted aiming. This is fixed by the AE.

Controls

Wouldn't it be nice if Oni had something like this? Oh well...

The Classic Mac build of Oni had a simple control-setting dialog which would appear if launching Oni with Shift held down. No other version of Oni has any kind of GUI for setting key bindings. Here's how you customize your controls:

CD check

Some versions of Oni for Windows have been known to require the game CD-ROM in the drive (or at least some CD with the same name, e.g. "ONI" or "001228_1801" ;-), but the app distributed with the standard U.S. release does not perform that CD check. That app is found here.

Save-game editing

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. Here is how you pass Oni a command-line argument (multiple arguments can be supplied, as long as they are separated by a space character):

  • In Windows, you can make a shortcut to Oni and then add the argument on the shortcut's Properties window, or create a .bat file with contents like "start oni -noswitch".
  • With the Classic Mac OS PPC Mac build of Oni, you can manually enter arguments via a special dialog that pops up if you hold down Shift during Oni's startup.
  • With the Mac OS X PPC build of Oni, you must use Terminal to directly invoke the actual binary by typing "Oni.app/Contents/MacOS/Oni -noswitch".
  • With the macOS Intel build of Oni, you can supply arguments using a file called launch_args.txt. Simply list the arguments on one line. Additional arguments accepted by the Intel build are listed on its documentation page. You can also visually choose many arguments in a GUI launch panel by holding down Command while opening Oni; the panel additionally allows you to manually type in any arguments that are not represented in the GUI.

Here are all the arguments Oni accepts, but only the ones in bold seem to be useful:

  • -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 thus has no effect.
  • -noswitch: Windowed mode (see below).
  • -opengl: unused

noswitch

-noswitch is probably the most useful of the command-line arguments. When launched with this argument, Oni stays in a window matching the resolution specified in Oni's Options menu instead of changing your screen resolution and going full-screen. Thus, if Oni is set to run in a low resolution like 640x480, the game will take only a portion of your screen, leaving you access to other applications that you may be running alongside Oni (very useful when modding).

Modding

See Installation page.