Guide on how to run Rayman 2 on a Mac

2024-11-18T21:20:02Z

Raymanroy: Link was dead, replaced link with new one

What follows is a '''guide on how to run ''[[Rayman 2]]'' on a Mac'''.

[[File:Ray2PortingKit gamewindow.png|320px|thumb|right|''[[Rayman 2]]'' running natively in Mac OSX.]]

== Introduction ==
''NOTE: This article was created after a single test-case, for future reference. If, after following the instructions relayed herein, the user finds the solution doesn't work, please send the user Shrooblord a PM via the forums.''

These instructions detail how to get ''[[Rayman 2]]'' up and running in a Mac OSX environment. So far, test results show evidence of full, no-lag support with a similar input latency (none) and appearance as the original game back on 1990s machines, except rendered with modern-day graphics abilities (note that though the drawn lines may appear less pixellated, there is no way to update the textures unless someone went and repainted every single one by hand at a higher resolution).

They will get the game running, but your Mac menu bar at the top of the screen will still be visible. Additionally, the game will be displayed in its native 4:3 resolution, so you will have big black pillar borders on the sides of the screen surrounding the game if you have a widescreen monitor.
These are features of the process still being looked into. Perhaps [http://raymanpc.com/forum/viewtopic.php?f=13&t=21665 the widescreen patch] as described on the forums can be applied. This has not been tested.

===Requirements===
* The [http://www.gog.com/game/rayman_2_the_great_escape GOG.com version of the game] (requires installer executable file - download it off the site from your Library when logged in and with a purchased copy registered to your account)
* [http://portingkit.com Porting Kit] by Paul the Tall

== Installation ==
# Download and install the Porting Kit. Its installation is straightforward and all necessary instructions are relayed to you through its own installation procedure.
# Download the ''[[Rayman 2]]'' GOG.com version's installer executable and keep it in your Downloads folder.
# Launch the Porting Kit.
# In the Porting Kit, near the top of the window, click the tab '''Library'''.
# To the left, click the tab '''Server''' and search for Rayman 2.
# Install the Porting Kit's ''[[Rayman 2]]'' wrapper and follow all on-screen instructions. The process should walk you through all necessary steps on its own.
# By now you should be able to test Rayman 2. However, you will notice that its graphics remind you of 1990s computers. Follow the next step in the process to remedy that.

== Configuring the Game ==
These steps will cause the game to be drawn using your computer monitor's native resolution, increasing the quality of the graphics displayed significantly. The list of instructions is accompanied by a screenshot picture gallery below.

<ol>
<li> Go to your Local tab in Library and right click the ''[[Rayman 2]]'' app. Select Launch Wineskin [previously, this option was called "Properties"]. </li>
<li> Click Advanced and Browse on the first tab in Advanced. </li>
<li> Browse to the nglide_config.exe inside the created ''[[Rayman 2]]'' app: right click the Rayman2.app, click Show Package Contents and navigate its directory tree as shown below. </li>
<li> Test Run the nglide_config.exe.</li>
<li> Select the following options:
<pre>Screen Resoltion - By Desktop
Aspect Ratio - 4:3</pre>
</li>
<li> Next, set the WineSkin options to emulate a Windows XP computer ( Tools tab > Config Utility (winecfg) ). Apply and close.</li>
<li> On the Configuration tab, Browse back to your Rayman2.exe executable inside the ''[[Rayman 2]]'' app's directory.</li>
<li> Click Test Run to see if it works.</li>
<li> [OPTIONAL] - It may be you need to change some options depending on your computer and operating system. On Mavericks, the steps described above were enough. On El Capitan, one additional step was required to get the game to run: In the Wineskin Advanced window, in the Configuration tab, click "Set Screen Options" and make sure the checkbox 'Use Mac Driver instead of X11' '''is checked''' (it is ''unchecked'' by default).
<li> And finally, close this Advanced Wineskin window and from hereon forwards, whenever you click Play in the Porting Kit, you'll have ''[[Rayman 2]]'' running on your Mac desktop like it were a Windows XP computer, with correct aspect ratio and using your screen's resolution. </li>
</ol>

<gallery>
Ray2PortingKit properties.png|1. Select properties in the context menu for the ''[[Rayman 2]]'' installation inside your Porting Kit's local Library.
Ray2PortingKit winecfg.png|2. Click Advanced on the Wineskin window that opens and then on Browse on the Configuration tab of the Advanced dialog window.
Ray2PortingKit nglide config exe.png|3. Browse to the nglide_config.exe inside your ''[[Rayman 2]]'' installation directory (the created Rayman2.app).
Ray2PortingKit nglide config testrun.png|4. This shows the nglide_config.exe being the executed .exe file when the Rayman2.app is run. Click Test Run to launch the application.
Ray2PortingKit nglide config options.png|5. Displays the options that should be chosen in the nglide_config.exe for the ''[[Rayman 2]]'' Porting Kit executable.
Ray2PortingKit Ray2WinXP.png|6. Select Rayman2.exe to run emulating a Windows XP environment in the Wine Configuration (winecfg) option under the Tools tab of the Advanced option of the Properties window of the ''[[Rayman 2]]'' Porting Kit executable.
Ray2PortingKit Ray2 exe.png|7. Select the Rayman2.exe to be the executable that is run when launching the ''[[Rayman 2]]'' app under the Configuration tab of the ''[[Rayman 2]]'' Porting Kit executable.
</gallery>

== Trivia ==
*The benefit of this ''[[Rayman 2]]'' version over normal Windows machines running the game is that the user can minimize the window and the game will turn into "Rayman II - paused" like on Windows, but instead, it won't crash when trying to reopen it like it usually would on newer Windows systems.

[[Category:Technical Information]]

RayWiki, the Rayman wiki - User contributions [en]

Guide on how to run Rayman 2 on a Mac