Installation: Difference between revisions

After following the instructions below to install a retail copy of the game, see {{SectionLink||Patches}}, then check out the [[Troubleshooting]] page if you still encounter problems.

:''Note that the installer on the CD may no longer work as of Windows 10; see {{SectionLink|Troubleshooting|Installer}} for how to install Oni manually.''

The installer requires Mac OS 9 to run, but you can simply open the CD and drag the "Oni ƒ" folder to the desired place on your hard drive. It's recommended that you then rename the folder to simply "Oni". See the {{SectionLink||Patches}} to get the right version of the Oni game application for your system. If Oni still does not run properly, see [[Troubleshooting]].

All of Oni's files will be found in '''C:\Program Files\Oni''' on Windows, and '''wherever you dragged the folder to''' on the Mac. The name of the folder does not have to be "Oni" and the Oni application can be renamed, too, but it is not recommended (some community tools expect the app to be called by its original name). Look at [[Oni (folder)|this page]] for a listing of the files you should have and a description of what they do.

#Oni does not create any important registry entries (just [[Talk:Installation#Registry redux|this one]] for uninstallation purposes). An installation of Oni consists entirely of the "Oni" folder; this makes it easy to back up Oni before experimenting with it.

#The save-game file persist.dat, as well as key_config.txt and Oni's log files, will <u>not</u> be saved next to Oni.exe if you are not running the game as an administrator. See {{SectionLink|Oni (folder)|Warning for non-admins}} to learn more.

#Retail versions of Oni sometimes check for the installation CD, but the original U.S. distribution did not. If you run into a CD check, you can get rid of it by using the Oni.exe that is installed automatically by the [[AE]] (directly downloadable [[Customizing#CD check|here]]) or by using [[OniX]]. Otherwise you need to have either the Oni CD-ROM in the drive or any mounted volume with the same as the CD-ROM.

#If Oni.exe is opened by double-clicking it or its shortcut, it first looks for GameDataFolder (which we call "the GDF") in the same directory as itself. If Oni.exe is launched from the command line, it first looks for the GDF in the current command line directory, and if it's called by a .bat it looks in the location of the .bat that called it. Wherever it starts looking, Oni will also look for a folder in that directory called "OniEngine" and look inside there too for a GameDataFolder. If neither location contains the GDF, Oni progressively checks the parent directories, all the way up to C:\ if necessary, looking for the GDF (or an OniEngine folder with the GDF inside) at each level. OniX behaves the same except that it never looks for OniEngine.

#When opened, the app first looks for the GameDataFolder in the same directory as itself. If the GDF is not found there, it continues to look in each parent directory up to the root of the hard drive. Unlike in Windows, the app never looks for an OniEngine folder.

Retail Oni will not usually run on modern computers without a patched game application. For the sake of historical completeness, below is a table of Oni's compatibility with every version of Windows and the Mac OS going back to the minimum required OS that was listed for Oni when it launched in 2001. If you still encounter problems after following these directions, see the [[Troubleshooting]] page.

{|class="wikitable" style="margin-left:auto; margin-right:auto;"

!width=300px|Oni.exe

|Windows 95, 98, 2000, ME

|The {{Hover|vanilla|text=The original unmodded game}} version of Oni.exe should work out of the box.

|The ''legacy'' build of [[OniX|OniX.exe]] will also work (however the game data conversion script requires Win98+).

|As above, install the Daodan DLL or the AE. Starting with Win8, however, you may experience mouse-pointing issues, which requires turning off display scaling for Oni (instructions [[Mouse control issues#Camera|HERE]]).

The central introduction to making your own mods is found [[Introduction to modding|HERE]].