Installation: Difference between revisions

From OniGalore
Jump to navigation Jump to search
(→‎Demo (Windows & Mac): added link to level 2 for the Mac demo)
(minor rewrite; replaced old patch section with comprehensive compatibility table)
Line 1: Line 1:
:''Please note that this page is devoted mainly to the PC versions (Windows, Mac) of Oni, as the PS2 doesn't really require any instructions.''
:''Please note that this page is devoted mainly to the PC versions (Windows, Mac) of Oni, as the PS2 doesn't really require any instructions.''
{{TOCfloat}}
{{TOCfloat}}
==Available versions==
==Obtaining==
===Demo (Windows & Mac)===
===Demo===
You can still get the Windows demo [http://download.cnet.com/Oni-demo/3000-2095_4-4201532.html HERE], and both the Windows and Mac demos [http://www.atomicgamer.com/games/417/oni/files HERE] (the demos will be backed up on oni2.net if other sources are discontinued). See [http://mods.oni2.net/node/315 HERE] for a supplement to the Mac demo that contains the second level, which was originally only released in the Windows demo.
You can still get the Windows demo [http://download.cnet.com/Oni-demo/3000-2095_4-4201532.html HERE], and both the Windows and Mac demos [http://www.atomicgamer.com/games/417/oni/files HERE] (the demos will be backed up on oni2.net if other sources are discontinued). See [http://mods.oni2.net/node/315 HERE] for a supplement to the Mac demo that contains the second level, which was originally only released in the Windows demo. There is no demo for the PS2 version.


===Retail (Windows, Mac & PS2)===
===Retail===
The Windows, Mac and PS2 versions are no longer available to purchase new, but are often for sale secondhand on eBay and Amazon.
The Windows, Mac and PS2 versions are no longer available to purchase new, but are often for sale secondhand on eBay and Amazon.
There are documented beta versions of Oni for the Mac that have not been released publicly. You can read about them [[Mac betas|HERE]].


==Installation process==
==Installation process==
If Oni does not run properly (or at all), be sure to see the section below, "Upgrades and patches", for a possible solution, then check out the [[Troubleshooting]] page if problems persist.
After installing Oni, you will almost certainly need to install a patch of some kind to run it. After following these instructions to install the game, see the [[#Patches|Patches]] section, then check out the [[Troubleshooting]] page if problems persist.


===Windows===
===Windows===
Line 21: Line 19:


===Windows demo===
===Windows demo===
The installation process does not start automatically, as there's no CD. The demo's installer extracts the engine and game content to a temporary folder and deletes everything when you exit the game. If you want a persistent demo, try [http://geyser.oni2.net/demoni/demoni.exe THIS].
Running the demo's installer extracts the game application and data to a temporary folder, runs the game, then deletes everything when you exit the game. If you want a persistent demo, try [http://geyser.oni2.net/demoni/demoni.exe THIS].


===Mac OS X===
===Mac OS X===
The installer requires OS 9 to run. Modern Macs do not have the Classic environment needed to run this Installer, 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 section "Patches" below for the current version of the Oni application that you need to run the game. If Oni still does not run properly, see [[Troubleshooting]].
The installer requires OS 9 to run. Modern Macs do not have the Classic environment needed to run this Installer, 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 version of the Oni application that you need to run the game. If Oni still does not run properly, see [[Troubleshooting]].


==Installation notes==
==Installation notes==
Line 39: Line 37:


==Patches==
==Patches==
Oni will not run on any modern computers without a patched game application. Please download the appropriate files for your platform below and if you still encounter problems, see the [[Troubleshooting]] page.
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.


===Windows===
{|class="wikitable" style="margin-left:auto; margin-right:auto;"
Oni for Windows has been patched by the community through the [[Daodan DLL]], which gets installed alongside the original Oni application and patches Oni at runtime.
|+Windows
!Version
!width=530|Notes
|-
|Windows 98, 2000, ME
|The original version of Oni should work out of the box.
|-
|Windows XP, Vista
|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.
|-
|Windows 8, 10
|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.
|}


===Mac===
{|class="wikitable" style="margin-left:auto; margin-right:auto;"
The version of the Oni application that runs on today's Intel-based Macs is the [[AE:FERAL|Feral Interactive build]].
|+Macintosh
!Version
!width=530|Notes
|-
|Mac OS 8, 9
|The original version of Oni should work out of the box.
|-
|Mac OS X 10.0-10.5
|Use the community-patched version of Omni Group's build of Oni for OS X found [[AE:OMNI|HERE]].
|-
|Mac OS X 10.6
|Use the archived Feral Interactive build of Oni for Intel Macs found [[AE:FERAL|HERE]].
|-
|Mac OS X 10.7-10.11,<br />macOS 10.12
|Use the latest Feral Interactive build of Oni for Intel Macs found [[AE:FERAL|HERE]].
|}


==Customization==
==Customization==
For information on setting the controls and making other changes to Oni, see [[Customizing]].
For information on customizing the controls and making other changes to Oni's settings, see [[Customizing]].


==Mods==
==Mods==
<onlyinclude>The community has produced a number of mods, which can be browsed on the [http://mods.oni2.net Mod Depot]. However, these mods are generally installed through the [[Anniversary Edition]], so you should really start there.
<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 central introduction to making your own mods is found [[Modding Oni|HERE]].</onlyinclude>
The central introduction to making your own mods is found [[Modding Oni|HERE]].</onlyinclude>


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

Revision as of 13:58, 23 June 2016

Please note that this page is devoted mainly to the PC versions (Windows, Mac) of Oni, as the PS2 doesn't really require any instructions.

Obtaining

Demo

You can still get the Windows demo HERE, and both the Windows and Mac demos HERE (the demos will be backed up on oni2.net if other sources are discontinued). See HERE for a supplement to the Mac demo that contains the second level, which was originally only released in the Windows demo. There is no demo for the PS2 version.

Retail

The Windows, Mac and PS2 versions are no longer available to purchase new, but are often for sale secondhand on eBay and Amazon.

Installation process

After installing Oni, you will almost certainly need to install a patch of some kind to run it. After following these instructions to install the game, see the Patches section, then check out the Troubleshooting page if problems persist.

Windows

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
  • Installation process itself: 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.

A shortcut is automatically generated and placed on your desktop.

Windows demo

Running the demo's installer extracts the game application and data to a temporary folder, runs the game, then deletes everything when you exit the game. If you want a persistent demo, try THIS.

Mac OS X

The installer requires OS 9 to run. Modern Macs do not have the Classic environment needed to run this Installer, 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 section below to get the version of the Oni application that you need to run the game. If Oni still does not run properly, see Troubleshooting.

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, 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!).
  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). 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").
  3. 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.

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 does not look for "OniEngine/".

Patches

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.

Windows
Version Notes
Windows 98, 2000, ME The original version of Oni should work out of the box.
Windows XP, Vista 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.
Windows 8, 10 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.
Macintosh
Version Notes
Mac OS 8, 9 The original version of Oni should work out of the box.
Mac OS X 10.0-10.5 Use the community-patched version of Omni Group's build of Oni for OS X found HERE.
Mac OS X 10.6 Use the archived Feral Interactive build of Oni for Intel Macs found HERE.
Mac OS X 10.7-10.11,
macOS 10.12
Use the latest Feral Interactive build of Oni for Intel Macs found HERE.

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.