Playing in Linux: Difference between revisions

m
added info on the need to install 32-bit Wine; removed links to Wine and Winetricks websites as there is nothing there the user should be downloading; added back OniX template
m (some wording tweaks, no change to instructions)
m (added info on the need to install 32-bit Wine; removed links to Wine and Winetricks websites as there is nothing there the user should be downloading; added back OniX template)
Line 1: Line 1:
{{UpdatedForOniX|1.0.0}}
There is no official support for Oni in the Linux OS family. Nevertheless, it is still possible to run the game on Linux. The [[Anniversary Edition]] Installer can be made to run as well. If you are looking for help running Oni on the Steam Deck, see [[Playing on the Steam Deck]] for much simpler instructions.
There is no official support for Oni in the Linux OS family. Nevertheless, it is still possible to run the game on Linux. The [[Anniversary Edition]] Installer can be made to run as well. If you are looking for help running Oni on the Steam Deck, see [[Playing on the Steam Deck]] for much simpler instructions.


==Requirements==
==Requirements==
; [https://www.winehq.org Wine]
; Wine
: A compatibility layer for running Windows applications on a Linux machine. For maximum convenience, it is recommended to install Wine directly from an official repository of the given Linux distribution (it is natively supported by a wide array of distros). Wine 5.5 was found to be capable of flawlessly running Oni and the AE Installer.
: A compatibility layer for running Windows applications on a Linux machine. For maximum convenience, it is recommended to install Wine directly from an official repository of the given Linux distribution (it is natively supported by a wide array of distros). Wine 5.5 was found to be capable of flawlessly running Oni and the AE Installer.
# Open a Linux terminal and search for Wine packages. You need to know what your package manager is: apk, apt-get, dnf, emerge, pacman, yum, zypp…. Tell the package manager to search for "wine" and look for a 32-bit Wine package in the results. The package might be called "wine32" or "wine.i686". Install it; the package manager may also need to install a ton of dependencies if this a fairly new Linux install.


; [https://wiki.winehq.org/Winetricks Winetricks]
; Winetricks
: A helper app for configuring various parts of Wine-created compatibility environments. In some distros, Winetricks is installed alongside Wine itself. In other distros, it needs to be installed as a separate package.
: A helper app for configuring various parts of Wine-created compatibility environments. In some distros, Winetricks is installed alongside Wine itself. In other distros, it needs to be installed as a separate package.


Line 29: Line 31:
# Insert your Oni CD-ROM into the disc drive (if installing from the CD, 2001-style ^_^).
# Insert your Oni CD-ROM into the disc drive (if installing from the CD, 2001-style ^_^).
# Open a Linux terminal, export the "Oni" prefix file, navigate to the folder with the contents of the mounted CD, and initiate the installation process.
# Open a Linux terminal, export the "Oni" prefix file, navigate to the folder with the contents of the mounted CD, and initiate the installation process.
#: <code> export WINEPREFIX=/full_path_to_the_folder_where_Oni_prefix_is_located </code>
#: <code>export WINEPREFIX=/full_path_to_the_folder_where_Oni_prefix_is_located</code>
#: <code> cd /full_path_to_the_contents_of_the_Oni_installation_medium </code>
#: <code>cd /full_path_to_the_contents_of_the_Oni_installation_medium</code>
#: <code> wine OniSetup.exe </code>
#: <code>wine OniSetup.exe</code>
# During the installation process, it is recommended to '''NOT''' place the game inside the prefix file's compatibility environment folder (do '''not''' place it anywhere on the faux "C:\" drive). Instead, choose an appropriate place somewhere in your Linux machine's directory tree. The computer's native directory tree should be mapped by default as a different faux drive (usually "Z:\").
# During the installation process, it is recommended to '''NOT''' place the game inside the prefix file's compatibility environment folder (do '''not''' place it anywhere on the faux "C:\" drive). Instead, choose an appropriate place somewhere in your Linux machine's directory tree. The computer's native directory tree should be mapped by default as a different faux drive (usually "Z:\").
# The game should install without problems. Ignore the warning regarding DirectX 7, it is harmless.
# The game should install without problems. When GLSetup runs and offers to install OpenGL, make sure to say no.
# DO NOT RUN THE GAME YET!!! An attempt to run an unpatched copy of Oni on a modern system is almost guaranteed to fail. The game needs to be patched via the AE Installer.
# DO NOT RUN THE GAME YET!!! An attempt to run an unpatched copy of Oni on a modern system is almost guaranteed to fail. The game needs to be patched via the AE Installer.


Line 40: Line 42:
# Download the latest Windows version of the AE Installer from the Oni Mod Depot ([http://mods.oni2.net/node/79 click here]).
# Download the latest Windows version of the AE Installer from the Oni Mod Depot ([http://mods.oni2.net/node/79 click here]).
# Open a Linux terminal, export the "Oni" prefix, navigate to the folder with the AE Installer, and initiate the installation process.
# Open a Linux terminal, export the "Oni" prefix, navigate to the folder with the AE Installer, and initiate the installation process.
#: <code> export WINEPREFIX=/full_path_to_the_folder_where_Oni_prefix_is_located </code>
#: <code>export WINEPREFIX=/full_path_to_the_folder_where_Oni_prefix_is_located</code>
#: <code> cd /full_path_to_the_AE_Installer </code>
#: <code>cd /full_path_to_the_AE_Installer</code>
#: <code> wine Anniversary-Edition-Setup-vXX.YY_ZZ.exe </code>
#: <code>wine Anniversary-Edition-Setup-vXX.YY_ZZ.exe</code>
# During the AE Installer installation, there will be a prompt to provide Oni's installation directory. Navigate to the appropriate directory. Your Linux system's directory tree should be mapped to "/".
# During the AE Installer installation, there will be a prompt to provide Oni's installation directory. Navigate to the appropriate directory. Your Linux system's directory tree should be mapped to "/".
# At the end of the installation, the AE Installer will be automatically executed and will attempt to fetch updates. During the fetching process, it may appear that the AE Installer has hanged. That is not true, it just does not indicate that there is work being done in the background. Be patient.
# At the end of the installation, the AE Installer will be automatically executed and will attempt to fetch updates. During the fetching process, it may appear that the AE Installer has hanged. That is not true, it just does not indicate that there is work being done in the background. Be patient.
Line 48: Line 50:
==Launching AE Installer==
==Launching AE Installer==
The AE Installer will be automatically launched after it is installed. However, any other time you want to launch the AE Installer, open a Linux terminal, export the "Oni" prefix, navigate to the folder with the '''AEInstaller2Updater.jar''' file, and launch the .jar file through Wine Java Runtime Environment:
The AE Installer will be automatically launched after it is installed. However, any other time you want to launch the AE Installer, open a Linux terminal, export the "Oni" prefix, navigate to the folder with the '''AEInstaller2Updater.jar''' file, and launch the .jar file through Wine Java Runtime Environment:
: <code> export WINEPREFIX=/full_path_to_the_folder_where_Oni_prefix_is_located </code>
: <code>export WINEPREFIX=/full_path_to_the_folder_where_Oni_prefix_is_located</code>
: <code> cd /full_path_to_the_AEInstaller2Updater.jar </code>
: <code>cd /full_path_to_the_AEInstaller2Updater.jar</code>
: <code> wine start /ProgIDOpen jarfile AEInstaller2Updater.jar </code>
: <code>wine start /ProgIDOpen jarfile AEInstaller2Updater.jar</code>


==Patching/modding Oni via AE Installer==
==Patching/modding Oni via AE Installer==
Line 59: Line 61:
A. Launch the game through the AE Installer application.<br>
A. Launch the game through the AE Installer application.<br>
B. Open a Linux terminal, export the "Oni" prefix, navigate to the folder with the patched Oni.exe file, and launch it via Wine.
B. Open a Linux terminal, export the "Oni" prefix, navigate to the folder with the patched Oni.exe file, and launch it via Wine.
: <code> export WINEPREFIX=/full_path_to_the_folder_where_Oni_WINEPREFIX_is_located </code>
: <code>export WINEPREFIX=/full_path_to_the_folder_where_Oni_WINEPREFIX_is_located</code>
: <code> cd /full_path_to_the_patched_Oni.exe </code>
: <code>cd /full_path_to_the_patched_Oni.exe</code>
: <code> wine Oni.exe </code>
: <code>wine Oni.exe</code>


==Troubleshooting==
==Troubleshooting==