Installation: Difference between revisions

From OniGalore
Jump to navigation Jump to search
(linking to tip on dealing with broken Oni installer in Win10)
m (converted use of H template to Hover template)
 
(18 intermediate revisions by 2 users not shown)
Line 1: Line 1:
:''Please note that this page is devoted mainly to the PC versions (Windows, Mac) of Oni, as the PS2 version doesn't really require any instructions.''
{{UpdatedForOniX|1.0.0}}
This page will guide you in obtaining, installing and running Oni on practically any computer.
{{TOCfloat}}
{{TOCfloat}}
==Obtaining==
==Obtaining==
===Demo===
===Demo===
You can get the Windows demo [http://mods.oni2.net/node/335 HERE], and the Mac demo [http://mods.oni2.net/node/334 HERE], repackaged for modern computers. There is no demo for the PS2 version.
You can get the Windows demo [http://mods.oni2.net/node/335 HERE] and the Mac demo [http://mods.oni2.net/node/334 HERE]. They have been repackaged for modern computers, and include all three demo levels.


===Retail===
===Retail===
The Windows and Mac versions are no longer available to purchase new, but are often for sale secondhand on eBay and Amazon. The PS2 version is still sold by Rockstar [http://www.rockstarwarehouse.com/store/tk2rstar/en_US/pd/productID.304297400 here].
The game is no longer available to purchase new, but is often for sale secondhand on sites like eBay and Amazon. Make sure you know which platform you're purchasing the game for, as sometimes the game is not carefully labeled by the seller. Unless you're specifically looking for the PlayStation 2 port for some reason, make sure you're buying Oni for Windows or Oni for Mac OS, as those are considered the best versions of the game, and only Windows/Mac Oni is supported by the community and can be modded (note: Mac Oni does not run in macOS 10.15 Catalina or newer due to the loss of 32-bit support, though a 64-bit port is expected eventually).


==Installation process==
==Installing==
After installing retail Oni on a modern OS, you will need to install a patch of some kind to run it. The original demos also require patches to run. However, the repackaged demos (linked to above) come with the needed patches, so the "Patches" section below does not apply.
After installing retail Oni on a modern OS, you will need to install a patch of some kind to run it. The repackaged demos (linked above) come with the needed patches (but note again that Oni currently will not run on Macs in macOS 10.15+).


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


===Windows===
===Windows===
:''Note that the installer on the CD may no longer work as of Windows 10; see [[Troubleshooting#Installer|HERE]] for how to install Oni manually.''
:''Note that the installer on the CD may no longer work as of Windows 10; see [[Troubleshooting#Installer|HERE]] for how to install Oni manually.''
When the Oni CD is inserted, the installation will automatically start with the following steps:
When the Oni CD is inserted, the installation will automatically start with the following steps:
*Language selection: for example, if you happen to have the European TakeAdvantage edition of Oni, you can choose between English/German/French
*Language selection (maybe): If you have a multilingual version of Oni, you'll be asked to choose the language first.
*Installation process itself: usual stuff (software license agreement, installation folder selection...)
*Installation process itself: The usual stuff (software license agreement, installation folder selection...).
*Installation of DirectX/OpenGL: skip this, as the versions of DirectX or OpenGL provided with Oni are ''very'' old.
*Prompt to install DirectX/OpenGL: '''Skip this''', as the version of DirectX or OpenGL provided with Oni is ''very'' old.
A shortcut is automatically generated and placed on your desktop.
 
A shortcut to Oni is automatically generated and placed on your desktop.


===Mac===
===Mac===
The installer requires Mac OS 9 to run, so 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 [[#Patches|Patches]] section below to get the right version of the Oni game application for your system. If Oni still does not run properly, see [[Troubleshooting]].
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 "[[#Patches|Patches]]" section below to get the right version of the Oni game application for your system. If Oni still does not run properly, see [[Troubleshooting]].


==Installation notes==
===Linux===
Oni was not developed for Linux, but for unofficial support with installing and patching Oni, see [[Playing in Linux]].
 
==Post-installation notes==
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.
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===
===Windows===
#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!).
#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.
#Retail versions of Oni sometimes check for the installation CD. You can get rid of the CD check using the Oni.exe that gets installed automatically by the [[AE]] (found [[Customizing#CD_check|here]]). Otherwise, you need to have an Oni CD in the drive in order to play (any CD will do as long as its volume name is "ONI").
#Retail versions of Oni sometimes check for the installation CD. You can get rid of the CD check using the Oni.exe that gets installed automatically by the [[AE]] (found [[Customizing#CD_check|here]]) or by using [[OniX]]. Otherwise you need to have an Oni CD in the drive in order to play (any mounted volume will do as long as its name is the same as Oni's CD).
#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 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.
#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.exe does not look for an OniEngine folder.


===Mac===
===Mac===
#The Mac app never checks for the Oni disc in the CD-ROM drive.
#The Mac app never checks for the Oni disc in the CD-ROM drive.
#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 does not look 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.


==Patches==
==Patches==
Retail Oni will not run on any 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.
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:700px"
{|class="wikitable" style="margin-left:auto; margin-right:auto;"
|+Windows
|+Windows
!Version
!Version
!width=530|Notes
!width=300px|Oni.exe
!width=300px|OniX.exe
|-
|-
|Windows 98, 2000, ME
|Windows 95, 98, 2000, ME
|The original version of Oni should work out of the box.
|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+).
|-
|-
|Windows XP, Vista, 7
|Windows XP, Vista, 7
|A crashing bug began to manifest in Oni around the time of XP. It is fixed by installing the [[Daodan DLL]] by itself or by installing the [[AE]] modding framework, which includes the DLL.
|A crashing bug began to manifest in Oni.exe around the time of XP. It is fixed by installing the [[Daodan DLL]] or by installing the [[Anniversary Edition]] modding framework, which includes the DLL.
|The ''legacy'' build of OniX.exe will work without issue.
|-
|Windows 8
|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 ''legacy'' build of OniX.exe will work without issue.
|-
|-
|Windows 8, 10
|Windows 10, 11
|As above, install the Daodan DLL. Starting with Win8, however, you may experience mouse-pointing issues, which requires turning off display scaling for Oni. See the Troubleshooting page if you don't know how to do that.
|As above, install the Daodan DLL or the AE, and turn off display scaling if you have mouse issues.
|The ''modern'' build of OniX.exe is designed to work on Windows 10 and 11.
|}
|}


Line 57: Line 71:
|+Macintosh
|+Macintosh
!Version
!Version
!width=530|Notes
!width=530px|Notes
|-
|-
|Mac OS 8.6-9.x
|Mac OS 8.6–9.x
|The original version of Oni should work out of the box.
|The original version of Oni should work out of the box.
|-
|-
|macOS 10.0-10.5
|Mac OS X 10.0–10.6
|Use the community-patched version of Omni Group's "Mac OS X port" found [[AE:OMNI|HERE]].
|Use the community-patched version of The Omni Group's Mac OS X port found [[OMNI|HERE]].
|-
|-
|macOS 10.6
|Mac OS X 10.7–macOS 10.14
|Use the archived Feral Interactive build of Oni for Intel Macs found [[AE:FERAL|HERE]].
|Use Feral Interactive's Intel Mac port found [[FERAL|HERE]].
|-
|-
|macOS 10.7-10.14
|macOS 10.15+
|Use the latest Feral Interactive build of Oni for Intel Macs found [[AE:FERAL|HERE]].
|32-bit apps are no longer supported, so you must boot in macOS 10.14 or below to play Oni.
|}
|}


Line 76: Line 90:


==Mods==
==Mods==
<onlyinclude>The community has produced a number of mods. You can browse the mods on the [http://mods.oni2.net Mod Depot], but you might just want to start at the [[Anniversary Edition]] page since mods are generally installed through the Anniversary Edition's Installer.
The community has produced a number of mods. You can browse the mods on the [http://mods.oni2.net Mod Depot], but you might just want to start at the [[Anniversary Edition]] page since mods are generally installed through the Anniversary Edition's Installer.


The central introduction to making your own mods is found [[Modding Oni|HERE]].</onlyinclude>
The central introduction to making your own mods is found [[Introduction to modding|HERE]].


[[Category:Oni Support]]
[[Category:Oni Support]]

Latest revision as of 23:58, 2 December 2023

This page will guide you in obtaining, installing and running Oni on practically any computer.

Obtaining

Demo

You can get the Windows demo HERE and the Mac demo HERE. They have been repackaged for modern computers, and include all three demo levels.

Retail

The game is no longer available to purchase new, but is often for sale secondhand on sites like eBay and Amazon. Make sure you know which platform you're purchasing the game for, as sometimes the game is not carefully labeled by the seller. Unless you're specifically looking for the PlayStation 2 port for some reason, make sure you're buying Oni for Windows or Oni for Mac OS, as those are considered the best versions of the game, and only Windows/Mac Oni is supported by the community and can be modded (note: Mac Oni does not run in macOS 10.15 Catalina or newer due to the loss of 32-bit support, though a 64-bit port is expected eventually).

Installing

After installing retail Oni on a modern OS, you will need to install a patch of some kind to run it. The repackaged demos (linked above) come with the needed patches (but note again that Oni currently will not run on Macs in macOS 10.15+).

After following the instructions below to install a retail copy of the game, see the "Patches" section, then check out the Troubleshooting page if you still encounter problems.

Windows

Note that the installer on the CD may no longer work as of Windows 10; see HERE for how to install Oni manually.

When the Oni CD is inserted, the installation will automatically start with the following steps:

  • Language selection (maybe): If you have a multilingual version of Oni, you'll be asked to choose the language first.
  • Installation process itself: The usual stuff (software license agreement, installation folder selection...).
  • Prompt to install DirectX/OpenGL: Skip this, as the version of DirectX or OpenGL provided with Oni is very old.

A shortcut to Oni is automatically generated and placed on your desktop.

Mac

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 "Patches" section below to get the right version of the Oni game application for your system. If Oni still does not run properly, see Troubleshooting.

Linux

Oni was not developed for Linux, but for unofficial support with installing and patching Oni, see Playing in Linux.

Post-installation notes

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 this page for a listing of the files you should have and a description of what they do.

Windows

  1. Oni does not create any important registry entries (just 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.
  2. Retail versions of Oni sometimes check for the installation CD. You can get rid of the CD check using the Oni.exe that gets installed automatically by the AE (found here) or by using OniX. Otherwise you need to have an Oni CD in the drive in order to play (any mounted volume will do as long as its name is the same as Oni's CD).
  3. 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.
  4. OniX.exe does not look for an OniEngine folder.

Mac

  1. The Mac app never checks for the Oni disc in the CD-ROM drive.
  2. 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.

Patches

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.

Windows
Version Oni.exe OniX.exe
Windows 95, 98, 2000, ME The vanillaThe original unmodded game version of Oni.exe should work out of the box. The legacy build of OniX.exe will also work (however the game data conversion script requires Win98+).
Windows XP, Vista, 7 A crashing bug began to manifest in Oni.exe around the time of XP. It is fixed by installing the Daodan DLL or by installing the Anniversary Edition modding framework, which includes the DLL. The legacy build of OniX.exe will work without issue.
Windows 8 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 HERE). The legacy build of OniX.exe will work without issue.
Windows 10, 11 As above, install the Daodan DLL or the AE, and turn off display scaling if you have mouse issues. The modern build of OniX.exe is designed to work on Windows 10 and 11.
Macintosh
Version Notes
Mac OS 8.6–9.x The original version of Oni should work out of the box.
Mac OS X 10.0–10.6 Use the community-patched version of The Omni Group's Mac OS X port found HERE.
Mac OS X 10.7–macOS 10.14 Use Feral Interactive's Intel Mac port found HERE.
macOS 10.15+ 32-bit apps are no longer supported, so you must boot in macOS 10.14 or below to play Oni.

Customization

For information on customizing the controls and making other changes to Oni's settings, see Customizing.

Mods

The community has produced a number of mods. You can browse the mods on the Mod Depot, but you might just want to start at the Anniversary Edition page since mods are generally installed through the Anniversary Edition's Installer.

The central introduction to making your own mods is found HERE.