Installation: Difference between revisions

666 bytes removed ,  16 January 2013
→‎Installation notes: clarifying and updating notes
(→‎Installation process (PC & Mac): update to Mac instructions)
(→‎Installation notes: clarifying and updating notes)
Line 31: Line 31:


==Installation notes==
==Installation notes==
All of Oni's files will be found in a folder called [[Oni (folder)|Oni]] (default is '''C:\Program Files\Oni''' on Windows, and '''/Applications/Oni''' on the Mac). The name of the folder does not have to be "Oni"; the game application can be renamed, too, but it is not recommended (some community tools expect the app to be called by its original name).
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.


===Windows notes===
===Windows notes===
#Oni does not create any registry entries, so an installation of Oni is essentially a copy of the Oni folder; this makes it easy to back up Oni before experimenting with it (hint, hint!).
#Oni does not create any important registry entries, so an installation of Oni is essentially a copy of the Oni folder; this makes it easy to back up Oni before experimenting with it (hint, hint!).
#Retail versions of Oni typically check for the installation CD. You can get rid of the CD check [[Customizing#CD_check|with a custom patch]] or, better, by using the [[Daodan DLL]]. Otherwise, you need to have an Oni CD in the drive to play (any CD will do as long as its volume name is "ONI").
#Retail versions of Oni typically check for the installation CD. You can get rid of the CD check [[Customizing#CD_check|with a custom patch]] or, better, by using the Daodan DLL (see "Patches", below). Otherwise, you need to have an Oni CD in the drive to play (any CD will do as long as its volume name is "ONI").
#The engine (Oni.exe) doesn't have to be present in the folder where it is launched from. The Edition takes advantage of this and runs the original engine remotely, without copying it around. This feature is a bit technical, but it can make life easier sometimes.
#If Oni.exe is opened by double-clicking it or its shortcut, it first looks for the GameDataFolder in the same directory as the EXE. If Oni.exe is launched from the command line, it first looks for the "GDF" in the directory of the command or .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 checks the parent directory, all the way up to C:\ if necessary, looking for the GDF (or an OniEngine folder with the GDF inside) at each level.
#If Oni.exe is opened by double-clicking it or its shortcut, it first looks for the GameDataFolder in the same directory as the EXE. If Oni.exe is launched from the command line, it first looks for the "GDF" in the directory of the command or .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 checks the parent directory, all the way up to C:\ if necessary, looking for the GDF (or an OniEngine folder with the GDF inside) at each level.


===Mac notes===
===Mac notes===
#Omni's port remembers the absolute location of the Oni folder between runs. This means you can move the Oni application to another location and, and as long as the rest of Oni's files are left in place, the game will still find the folder with that game data. If you move your Oni folder somewhere new without the application in it, the Oni application will ask for the folder's location on its next launch, and then remember the new location after that point.
#The Mac app never checks for the Oni disc in the CD-ROM drive.
#Omni's port (and the community-patched versions thereof) doesn't check for the Oni disc in the CD-ROM drive.




----
----
==Patches==
==Patches==
Oni may not run without downloading a patched engine. Please download the appropriate files for your platform below and if you still encounter problems, see the [[Troubleshooting]] page.
Oni may not run without downloading a patched engine. Please download the appropriate files for your platform below and if you still encounter problems, see the [[Troubleshooting]] page.