View source for Installing SCORE with Wineskins

Under construction.  Do not follow since Wineskins is having problems running.  Use [[MacOS installation of SCORE]]

== Windows ==

Install [DosBox https://www.dosbox.com] which is an MS-DOS emulator for windows (needed for Windows version above Windows 2017).

Unzip the SCORE file on the base directory of the C: drive.

Run DosBox and connect the C: drive (command to be added here).

See: [[https://www.dosbox.com/wiki/DOSBox_and_Mac_OS_X]]

== MacOS ==

SCORE is a 16-bit program and requires running in an emulator that can handle this.  Wineskins is a good method for doing this, in a similar manner to [[Installing SharpEye | SharpEye]].  If you have already installed Wineskins for running SharpEye, then you do not need to install again.

=== Install Wineskins ===


On MacOS, first install Wineskins according to the instructions in this video:  https://www.youtube.com/watch?v=vkQj0lZFz6I

As explained in the video, the Wineskin software is on Github: https://github.com/Gcenx/WineskinServer

Note that the Github software installation recommends using [https://brew.sh Homebrew] for installation.  This is a linux-like package manager for MacOS that I would recommend (provided you do not already have a similar system installed such as MacPorts).

* Install Homebrew from https://brew.sh
* Run the command `brew install --cask --no-quarantine gcenx/wine/wineskin`
* This will install the app in `/Applications/Wineskin Winery.app`, open it up.
* The following window will appear:

[[File:wineskinwinery1.jpg|300px|thumb|center|Initial Wineskin Winery window.]]

* Click on the "Update" button to install a Wrapper, the following window appears (most recent version is Wineskin-2.9.1.9):

[[File:wineskinwinery2.jpg|300px|thumb|center|Update wrapper.]]

* After installing the updated wrapper, the original window will look like this:

[[File:wineskinwinery3.jpg|300px|thumb|center|Initial Wineskin Winery window with update.]]

* Then click on the "+" button to add a new Engine.  This window will appear:

[[File:wineskinwinery4.jpg|300px|thumb|center|Add engine window.]]

* Choose the most recent 64-bit version, which is probably the default.  In this case "WS11WineCX64Bit23.7.1_D3DMetal" from the top of the list.  Then click on the "Download and Install" button to install the engine.

* You are then returned to the original window, but there will now be an engine installed:

[[File:wineskinwinery5.jpg|300px|thumb|center|Engine installed.]]

=== Setting up a new Wineskin wrapper for SCORE ===

* If skipping installation of Wineskin, open the app "/Applications/Wineskin Winery.app":

[[File:wineskinwinery5a.jpg|300px|thumb|center|Wineskin Winery App icon.]]

You should see this window when the app opens:

[[File:wineskinwinery5b.jpg|300px|thumb|center|Wineskin Winery App after opening.]]

* Now click on the "Create New Blank Wrapper" button near the bottom of the initial window.

[[File:wineskinwinery6a.jpg|300px|thumb|center|Installing Wrapper.]]

* And give the name to the App: SCORE.  Press "OK" and wait a while (about a minute) for the installation to finish.  Click only once on the "OK" button (it will take a while).

* SCORE.app will be installed in "~/Applications/Wineskin/SCORE.app" ("~/" means your home directory).

* There will be a window that appears after creating the wrapper:

[[File:wineskinwinery7a.jpg|300px|thumb|center|View Wrapper in Folder.]]

* Click "View Wrapper in Folder" button to view the newly created app file:

[[File:wineskinwinery8a.jpg|500px|thumb|center|File browser with SCORE app.]]

* Right-click on the App and select "Show package contents" to view the files in the app:

[[File:wineskinwinery9a.jpg|300px|thumb|center|Show package contents.]]

* Then open the Drive C folder:

[[File:wineskinwinery10a.jpg|500px|thumb|center|Open Drive C.]]


* Then place the unziped SCOR4 directory inside the C drive of the Wineskin app.

[[File:wineskinwinery11a.jpg|500px|thumb|center|Copied SCORE directory in C drive of SCORE Wineskin app.]]

=== Initial running of the SCORE.app ===

* Open ~/Applications/Wineskin/SCORE.app.  You should see this window:

[[File:wineskinwinery20a.jpg|300px|thumb|center|Opening SCORE.app the first time.]]

* Click on Advanced to select the startup script:

[[File:wineskinwinery21a.jpg|500px|thumb|center|Advanced settings for SCORE.app.]]

In this case the startup script is "C:\scor4\scor4.bat". (You can type that in directly or use the "Browse" button to find it in the Wineskin app C: drive.)

* Close the Advanced options and restart SCORE.app.

* You will probably see this permissions option, which you should accept by clicking on "OK":

[[File:wineskinwinery22a.jpg|200px|thumb|center|First-time permissions.]]