Line 28: |
Line 28: |
| For complex mods, you may need to test your mod on all platforms. The game is mostly the same on Linux/Mac, so you only need to test your mod twice: once on Windows, and again on Linux or Mac. You can do that by testing one version on your computer, and the other in a virtual machine. | | For complex mods, you may need to test your mod on all platforms. The game is mostly the same on Linux/Mac, so you only need to test your mod twice: once on Windows, and again on Linux or Mac. You can do that by testing one version on your computer, and the other in a virtual machine. |
| | | |
− | * '''If your main computer is Windows:'''
| + | <dl> |
− | *# Install [https://www.virtualbox.org/ VirtualBox].
| + | <dt>If your main computer is Windows 11:</dt> |
− | *# Create a [https://zorinos.com/ ZorinOS Core] VM in VirtualBox.
| + | <dd> |
− | *#* ''See [https://extr3metech.wordpress.com/2013/09/05/installing-zorin-os-7-in-virtual-box-screenshots this setup guide] for more details. The ZorinOS installer might be a bit different than shown, but should be pretty intuitive.''
| + | <ol> |
− | *#* ''If you don't see any options for 64-bit OSes in VirtualBox, see [https://superuser.com/a/866963 how to enable them].''
| + | <li>[https://docs.microsoft.com/en-us/windows/wsl/install Install Windows Subsystem for Linux (WSL)].</li> |
− | *#* ''When creating the virtual disk, at least 20GB is recommended.''
| + | <li>Install the required software in WSL:</li> |
− | *# [https://store.steampowered.com/about Download the Steam installer] in the VM and run it.
| + | <ol> |
− | *# Launch Steam to finish installation. If nothing happens, see [https://askubuntu.com/questions/771032/steam-not-opening-in-ubuntu-16-04-lts these extra steps] to fix it.
| + | <li>[https://linuxconfig.org/how-to-install-steam-on-ubuntu-20-04-focal-fossa-linux Install Steam].</li> |
− | *# Install Stardew Valley through Steam.
| + | <li>Launch <code>export TERM=xterm && steam</code> and install Stardew Valley through its UI.</li> |
− | *# [[Modding:Player Guide/Getting Started#Install SMAPI|Install SMAPI]].
| + | <li>''(optional)'' Download and install your preferred IDE, if you plan to compile the code on Linux. For the [https://www.jetbrains.com/help/rider/Installation_guide.html#prerequisites latest standalone Rider version] (not free): |
− | *# ''(optional)'' Install [https://www.mono-project.com/ <tt>mono-complete</tt>] and [http://www.monodevelop.com/download/ MonoDevelop] in your VM. This is only needed if you want to compile separately for Linux/Mac. When installing <tt>.deb</tt> files, use the instructions for [https://zorinos.com/help/install-apps/#deb-files the Ubuntu version shown here]. If you run into errors, may Linux have mercy on your soul.
| + | <syntaxhighlight lang="sh"> |
− | *# ''(optional)'' For unlocking Mac OS only: [https://www.insanelymac.com/forum/files/file/838-unlocker/ Virtual Machine Unlocker 2.1.1] for VmWare Workstation 11/12/14, VmWare Player 7/12/14, or Fusion 7/8/10. '''This is needed to boot Mac OS on a virtual Machine'''
| + | wget "<download url here>" -O rider-install.tar.gz |
| + | sudo tar -xzvf rider-install.tar.gz -C /opt |
| + | ln -s "/opt/JetBrains Rider-<version>/bin/rider.sh" |
| + | ./rider.sh |
| + | </syntaxhighlight></li> |
| + | <li>[[Modding:Installing SMAPI on Linux|Install SMAPI]].</li> |
| + | </ol></li> |
| + | <li>To launch the game, launch <code>steam</code> and run the game through its UI. This will also install its dependencies.</li> |
| + | </ol></li> |
| + | </ul> |
| + | </dd> |
| + | </dl> |
| | | |
| + | ; If your main computer is Windows 10 or earlier: |
| + | :# Install [https://www.virtualbox.org/ VirtualBox]. |
| + | :# Create a [https://zorinos.com/ ZorinOS Core] VM in VirtualBox. |
| + | :#* ''See [https://extr3metech.wordpress.com/2013/09/05/installing-zorin-os-7-in-virtual-box-screenshots this setup guide] for more details. The ZorinOS installer might be a bit different than shown, but should be pretty intuitive.'' |
| + | :#* ''If you don't see any options for 64-bit OSes in VirtualBox, see [https://superuser.com/a/866963 how to enable them].'' |
| + | :#* ''When creating the virtual disk, at least 20GB is recommended.'' |
| + | :# [https://store.steampowered.com/about Download the Steam installer] in the VM and run it. |
| + | :# Launch Steam to finish installation. If nothing happens, see [https://askubuntu.com/questions/771032/steam-not-opening-in-ubuntu-16-04-lts these extra steps] to fix it. |
| + | :# Install Stardew Valley through Steam. |
| + | :# [[Modding:Player Guide/Getting Started#Install SMAPI|Install SMAPI]]. |
| + | :# ''(optional)'' Install [https://www.mono-project.com/ <tt>mono-complete</tt>] and [http://www.monodevelop.com/download/ MonoDevelop] in your VM. This is only needed if you want to compile separately for Linux/Mac. When installing <tt>.deb</tt> files, use the instructions for [https://zorinos.com/help/install-apps/#deb-files the Ubuntu version shown here]. If you run into errors, may Linux have mercy on your soul. |
| + | :# ''(optional)'' For unlocking Mac OS only: [https://www.insanelymac.com/forum/files/file/838-unlocker/ Virtual Machine Unlocker 2.1.1] for VmWare Workstation 11/12/14, VmWare Player 7/12/14, or Fusion 7/8/10. '''This is needed to boot Mac OS on a virtual Machine''' |
| | | |
− | | + | ; If your main computer is Linux or macOS: |
− | * '''If your main computer is Linux or Mac:'''
| + | :# Install [https://www.virtualbox.org/ VirtualBox]. |
− | *# Install [https://www.virtualbox.org/ VirtualBox].
| + | :# [http://www.macworld.co.uk/how-to/mac-software/run-windows-10-on-your-mac-using-virtualbox-3621650/ Create a VM with Windows]. |
− | *# [http://www.macworld.co.uk/how-to/mac-software/run-windows-10-on-your-mac-using-virtualbox-3621650/ Create a VM with Windows].
| + | :# Install Stardew Valley in your VM. |
− | *# Install Stardew Valley in your VM.
| + | :# [[Modding:Player Guide/Getting Started#Install SMAPI|Install SMAPI]]. |
− | *# [[Modding:Player Guide/Getting Started#Install SMAPI|Install SMAPI]].
| + | :# ''(optional)'' Install [https://visualstudio.microsoft.com/vs/community/ Visual Studio Community] in your VM. This is only needed if you want to compile separately for Windows. |
− | *# ''(optional)'' Install [https://visualstudio.microsoft.com/vs/community/ Visual Studio Community] in your VM. This is only needed if you want to compile separately for Windows.
| |
| | | |
| ==Fix common build warnings== | | ==Fix common build warnings== |