Playing in Linux: Difference between revisions

From OniGalore
Jump to navigation Jump to search
m (Iritscen moved page Linux Oni to Playing in Linux without leaving a redirect: clearer name)
(general copy-edit and wiki touchup; +cat)
Line 1: Line 1:
There is no official support for Oni on a Linux family of OSes.<br/>
There is no official support for Oni in the Linux family of OSes. Nevertheless, it is still possible to run the game on Linux. The [[Anniversary Edition]] Installer can be made to run as well.
Nevertheless, it is still possible to run the game on Linux.<br>
[[Anniversary Edition/Installer/Updater]] can be made to run as well.


==Requirements==
==Requirements==
; [https://www.winehq.org Wine]
; [https://www.winehq.org Wine]
: An application used as a compatiblity layer in order to run Windows applications on a Linux machine.
: An application used as a compatibility layer in order to run 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.
: For maximum convenience, it is recommended to install the 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 tested to be be capable of flawlessly running Oni and AEInstaller.


; [https://wiki.winehq.org/Winetricks Winetricks]
; [https://wiki.winehq.org/Winetricks Winetricks]
: Helper script for configuring various parts of Wine-created compatibility environments.
: Helper script 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.
: In some distros, Winetricks is installed alongside the Wine itself.
: In other distors, it needs to be installed as a separate package.


; A legacy JAVA Runtime Environment offline installer for 32bit (aka x86) version of Windows XP.
; A legacy Java Runtime Environment offline installer for the 32-bit (AKA x86) version of Windows XP.
: Max compatible version is '''7u65'''.
: The maximum compatible version is '''7u65'''. Unfortunately, the [https://www.oracle.com/java/technologies/javase/javase7-archive-downloads.html official Oracle download page] requires a subscription in order to download legacy versions of JRE. An obscure link through the legacy website of Sun Microsystems (former developer of the Java platform) was found. The link ([https://javadl.sun.com/webapps/download/AutoDL?BundleId=78825 click here]) can be used to download a JRE 7u25 offline installer.
: Unfortunately, the [https://www.oracle.com/java/technologies/javase/javase7-archive-downloads.html official Oracle download page] requires a subscription in order to download legacy versions of JRE.
: An obscure link through legacy Sun Microsystems website (former developer of the JAVA platform) was found. The link ( [https://javadl.sun.com/webapps/download/AutoDL?BundleId=78825 click here] ) can be used to download a JRE 7u25 offline installer.


==How to prepare "Oni" WINEPREFIX==
==How to prepare the Wine prefix==
# Open a Linux terminal and create a new WINEPREFIX (a new instance of the Wine compatibility environment) by executing the following sequence of commands:
# Open a Linux terminal and create a new Wine prefix (an instance of the Wine compatibility environment) by executing the following sequence of commands:
#: <code> export WINEARCH=win32 </code>
#: <code> export WINEARCH=win32 </code>
#: <code> export WINEPREFIX=/full_path_to_the_folder_where_this_WINEPREFIX_will_be_located </code>
#: <code> export WINEPREFIX=/full_path_to_the_folder_where_this_Wine_prefix_will_be_located </code>
#: <code> winecfg </code>
#: <code> winecfg </code>
# The sequence of commands from the step 1 creates a new 32bit WINEPREFIX in the requested folder and opens a "Wine configuration" GUI tool.
# The sequence of commands from step 1 creates a new 32-bit Wine prefix in the requested folder and opens a "Wine configuration" GUI tool. In the GUI tool, under the "Applications" tab, change the target Windows version to "Windows XP". Then click on the OK button.
#: In the GUI tool, on the "Applications" tab, change the target Windows version to the "Windows XP". Then click on the OK button.
# Still in the same terminal (with all the export symbols defined), run Winetricks script to execute the necessary configuration changes:
# Still in the same terminal (with all the export symbols defined) run Winetricks script to execute necessary configuration changes:
#: <code> winetricks corefonts msacm32 </code>
#: <code> winetricks corefonts msacm32 </code>
# Still in the same terminal (with all the export symbols defined) use '''cd''' command and navigate to the folder with the Java Runtime offline installer (let's assume the installer is named "jre-7u25-windows-i586.exe").<br/>Install the JRE into the given WINEPREFIX.
# Still in the same terminal (with all the export symbols defined), use the '''cd''' command to navigate to the folder with the Java Runtime offline installer (let's assume the installer is named "jre-7u25-windows-i586.exe"). Install the JRE into the given Wine prefix:
#: <code> cd /full_path_to_the_JRE_offline_installer </code>
#: <code> cd /full_path_to_the_JRE_offline_installer </code>
#: <code> wine jre-7u25-windows-i586.exe </code>
#: <code> wine jre-7u25-windows-i586.exe </code>
# The "Oni" WINEPREFIX is now ready.<br/>Remember, that in order to run either Oni or AEInstaller, path to this WINEPREFIX must be specified (exported).<br/>If it is not specified, then the WINE application will use a default WINEPREFIX, and that one is probably set to represent 64bit Windows 7 or 64bit Windows 10 (which is quite sensible for most applications, but unfortunately not good enough for Oni).
# The "Oni" Wine prefix is now ready. Remember, that in order to run either Oni or the AE Installer, the path to this prefix file must be specified (exported). If it is not specified, then the Wine session will use a default prefix file, one which is probably set to represent 64-bit Windows 7 or 64-bit Windows 10 (which is quite sensible for most applications, but unfortunately not good enough for Oni).


==How to install Oni==
==How to install Oni==
# Insert Oni installation medium into the CD/DVD drive (if installed from the CD, 00's style ^_^).
# Insert your Oni CD-ROM into the disc drive (if installing from the CD, 2001-style ^_^).
# Open a Linux terminal, export "Oni" WINEPREFIX, navigate to the folder with contents of the mounted CD drive 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_WINEPREFIX_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 WINEPREFIX compatibility environment folder (do '''not''' place it anywhere on the faux "C:\" drive).
# 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:\").
#: Instead, choose an appropriate place somewhere in the Linux machine directory tree. Linux machine directory tree should be by default mapped as a different faux drive (usually it is mapped as drive "z:\")
# The game should install without problems. Ignore the warning regarding DirectX 7, it is harmless.
# The game should install without problems. Ignore the warning regarding DirectX 7, it is harmless.
# DO NOT RUN THE GAME YET!!!<br/>An attempt to run the raw Oni on a modern system is almost guaranteed to fail as Oni will most probably unceremoniously crash.<br/>The game needs to be patched via AEInstaller.
# 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.


==How to install AEInstaller==
==How to install AE Installer==
This is a rather straightforward process.
This is a rather straightforward process.
# Download the latest Windows version of the AEInstaller 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 "Oni" WINEPREFIX, navigate to the folder with the AEInstaller 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_WINEPREFIX_is_located </code>
#: <code> export WINEPREFIX=/full_path_to_the_folder_where_Oni_prefix_is_located </code>
#: <code> cd /full_path_to_the_AEInstaller </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 AEInstaller installation, there will be a prompt to provide Oni installation directory.
# 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 "/".
#: Navigate to the appropriate directory. Linux machine directory tree should be mapped as a drive "/".
# 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 AEInstaller will be automatically executed and will attempt to fetch updates.
#: During the fetching process, it may appear that the AEInstaller has hanged. That is not true, it just does not signalize that there is some work being done in the background. Be patient.


==How to launch AEInstaller==
==How to launch AE Installer==
# AEInstaller will be automatically launched once - during the installation process of the AEInstaller. Nice.
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:
# However, to normally launch the AEInstaller as a user, open a Linux terminal, export "Oni" WINEPREFIX, 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_WINEPREFIX_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>


==Patch Oni via AEInstaller==
==How to patch Oni via AE Installer==
# Let the AEInstaller do its magic. ^_^
Simply let the AE Installer do its magic. ^_^


==How to launch patched Oni==
==How to launch patched Oni==
There are two possible ways to launch Oni.
There are two possible ways to launch Oni:<br>
# Launch the game through the AEInstaller application.
A. Launch the game through the AE Installer application.<br>
# Open a Linux terminal, export "Oni" WINEPREFIX, 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>


==????==
[[Category:Oni Support]]
# PROFIT! ^_^

Revision as of 14:04, 28 May 2020

There is no official support for Oni in the Linux family of OSes. Nevertheless, it is still possible to run the game on Linux. The Anniversary Edition Installer can be made to run as well.

Requirements

Wine
An application used as a compatibility layer in order to run 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.
Winetricks
Helper script 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 legacy Java Runtime Environment offline installer for the 32-bit (AKA x86) version of Windows XP.
The maximum compatible version is 7u65. Unfortunately, the official Oracle download page requires a subscription in order to download legacy versions of JRE. An obscure link through the legacy website of Sun Microsystems (former developer of the Java platform) was found. The link (click here) can be used to download a JRE 7u25 offline installer.

How to prepare the Wine prefix

  1. Open a Linux terminal and create a new Wine prefix (an instance of the Wine compatibility environment) by executing the following sequence of commands:
    export WINEARCH=win32
    export WINEPREFIX=/full_path_to_the_folder_where_this_Wine_prefix_will_be_located
    winecfg
  2. The sequence of commands from step 1 creates a new 32-bit Wine prefix in the requested folder and opens a "Wine configuration" GUI tool. In the GUI tool, under the "Applications" tab, change the target Windows version to "Windows XP". Then click on the OK button.
  3. Still in the same terminal (with all the export symbols defined), run Winetricks script to execute the necessary configuration changes:
    winetricks corefonts msacm32
  4. Still in the same terminal (with all the export symbols defined), use the cd command to navigate to the folder with the Java Runtime offline installer (let's assume the installer is named "jre-7u25-windows-i586.exe"). Install the JRE into the given Wine prefix:
    cd /full_path_to_the_JRE_offline_installer
    wine jre-7u25-windows-i586.exe
  5. The "Oni" Wine prefix is now ready. Remember, that in order to run either Oni or the AE Installer, the path to this prefix file must be specified (exported). If it is not specified, then the Wine session will use a default prefix file, one which is probably set to represent 64-bit Windows 7 or 64-bit Windows 10 (which is quite sensible for most applications, but unfortunately not good enough for Oni).

How to install Oni

  1. Insert your Oni CD-ROM into the disc drive (if installing from the CD, 2001-style ^_^).
  2. 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.
    export WINEPREFIX=/full_path_to_the_folder_where_Oni_prefix_is_located
    cd /full_path_to_the_contents_of_the_Oni_installation_medium
    wine OniSetup.exe
  3. 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:\").
  4. The game should install without problems. Ignore the warning regarding DirectX 7, it is harmless.
  5. 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.

How to install AE Installer

This is a rather straightforward process.

  1. Download the latest Windows version of the AE Installer from the Oni Mod Depot (click here).
  2. Open a Linux terminal, export the "Oni" prefix, navigate to the folder with the AE Installer, and initiate the installation process.
    export WINEPREFIX=/full_path_to_the_folder_where_Oni_prefix_is_located
    cd /full_path_to_the_AE_Installer
    wine Anniversary-Edition-Setup-vXX.YY_ZZ.exe
  3. 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 "/".
  4. 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.

How to launch 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:

export WINEPREFIX=/full_path_to_the_folder_where_Oni_prefix_is_located
cd /full_path_to_the_AEInstaller2Updater.jar
wine start /ProgIDOpen jarfile AEInstaller2Updater.jar

How to patch Oni via AE Installer

Simply let the AE Installer do its magic. ^_^

How to launch patched Oni

There are two possible ways to launch Oni:
A. Launch the game through the AE Installer application.
B. Open a Linux terminal, export the "Oni" prefix, navigate to the folder with the patched Oni.exe file, and launch it via Wine.

export WINEPREFIX=/full_path_to_the_folder_where_Oni_WINEPREFIX_is_located
cd /full_path_to_the_patched_Oni.exe
wine Oni.exe