Differences

This shows you the differences between two versions of the page.

--- install [2019/06/27 20:21] – [Command Line Install] umfdev
+++ install [2021/08/06 22:46] (current) – [Installing UMF for MacOS] umfdev
@@ Line 1: / Line 1: @@
 ~~NOTOC~~
 ~~Title: Install Guide ~~
+{{tag>Help}}
 <WRAP center round info 100%>
 **This guide will aid you in the installation of UMF and it's Mods.**
@@ Line 20: / Line 21: @@
 **2.** Extract the zip file anywhere and start the **UMF.Installer.exe** by double clicking it.
   * If the installer gives you an error, then you are missing .NET 4.7.2. [[https://dotnet.microsoft.com/download/dotnet-framework/net472|Download .NET 4.7.2]]
-\\
+  * {{:installguide_extract.gif?nolink|}}
-{{:installguide_extract.gif?nolink|}}
+  * {{:installguide_uac.png?nolink|}}
-{{:installguide_uac.png?nolink|}}
 **3.** Click Next and Select the drive your game is installed on, then click "Scan for Game Folders".
+  * {{:installguide_started.png?nolink|}}
+  * {{:installguide_selectdrive.png?nolink|}}
   * Note: If you know where your game is installed you can click "Select a Game Folder Manually" instead of using scan to find it.
-\\
-{{:installguide_started.png?nolink|}}
-{{:installguide_selectdrive.png?nolink|}}
 **4.** Select your game from the drop down list and click "Install".
-\\
+  * {{:installguide_selectgame.png?nolink|}}
-{{:installguide_selectgame.png?nolink|}}
 **5.** Click "Next" and then click "Exit".
   * You have now installed UMF can can start **[[#Installing Mods for Windows|Installing Mods]]**.
-\\
+  * {{:installguide_installed.png?nolink|}}
-{{:installguide_installed.png?nolink|}}
+  * {{:installguide_exit.png?nolink|}}
-{{:installguide_exit.png?nolink|}}
 **6.** **(OPTIONAL)** Install the latest Mono for Windows: **[[https://www.mono-project.com/download/stable/#download-win|Mono for Windows]]**
@@ Line 55: / Line 51: @@
 **1.** Find a mod that you want.
-\\
+  * [[https://umodframework.com/mods|Official Mod List]]
-[[https://umodframework.com/mods|Official Mod List]]
 **<color #22b14c>Automatic Install:</color>**
@@ Line 63: / Line 58: @@
   * The first time you will need to set your browser to always open those Install links with UMF.
   * If there is no Install link then follow the Manual Install steps.
-\\
+  * {{:installguide_uribrowsers.gif?nolink|}}
-{{:installguide_uribrowsers.gif?nolink|}}
+  * {{:installguide_modinstall.png?nolink|}}
-{{:installguide_modinstall.png?nolink|}}
@@ Line 74: / Line 68: @@
 **3.** Drag and drop the mod into the Mods folder of UMF. (You can find a shortcut to the Mods folder on your desktop.)
   * If the mod is in a zip file you **should __not__ extract** it, UMF will do this for you.
+\\
 ----
@@ Line 107: / Line 101: @@
 **2.** Extract the zip file anywhere and start the **UMF.Installer(.desktop)** by double clicking it.
   * If you do not have mono you will be taken to a download page for mono.
-  * You can alternatively install the ''mono-complete'' package through a repository.
+  * You can alternatively install the ''mono-complete'' package through a repository, but note that most distros use a very outdated package of mono which may not work.
-\\
+/*  * {{:installguide_linux_extract.gif?nolink|}}
-{{:installguide_linux_extract.gif?nolink|}}
+  * {{:installguide_linux_chmod.png?nolink|}}*/
-{{:installguide_linux_chmod.png?nolink|}}
 **3.** Click Next and Select the drive your game is installed on, then click "Scan for Game Folders".
   * Note: If you know where your game is installed you can click "Select a Game Folder Manually" instead of using scan to find it.
-\\
+/*  * {{:installguide_linux_started.png?nolink|}}
-{{:installguide_linux_started.png?nolink|}}
+  * {{:installguide_linux_selectdrive.png?nolink|}}*/
-{{:installguide_linux_selectdrive.png?nolink|}}
 **4.** Select your game from the drop down list and click "Install".
-\\
+/*  * {{:installguide_linux_selectgame.png?nolink|}}*/
-{{:installguide_linux_selectgame.png?nolink|}}
 **5.** Click "Next" and then click "Exit".
   * You have now installed UMF can can start **[[#Installing Mods for Linux|Installing Mods]]**.
-\\
+/*  * {{:installguide_linux_installed.png?nolink|}}
-{{:installguide_linux_installed.png?nolink|}}
+  * {{:installguide_linux_exit.png?nolink|}}*/
-{{:installguide_linux_exit.png?nolink|}}
 ----
+\\
+\\
+===== Command line Linux =====
+If you have issues with the GUI Installer you can also install UMF using a Terminal.
+  - Download the latest version of [[https://www.mono-project.com/download/stable/#download-lin|Mono]] and install it.
+  - [[https://umodframework.com/download|Download UMF]]
+  - Extract the zip file and place the UMF.Installer folder on your desktop.
+  - Open a **Terminal**.
+  - Use the ''**-install "/PATH/TO/GAME/FOLDER/"**'' parameter to install.
+    * **<color #00a2e8>Path Example:</color>**\\ ''cd ~ && cd "/Desktop/UMF.Installer/" && mono UMF.Installer.exe -install **"/PATH/TO/GAME/FOLDER/"**''
+  - Some users may need to also use ''chmod -R +rwx **"/PATH/TO/GAME/FOLDER/"**'' in order to give full permissions.
+\\
+----
 \\
 \\
@@ Line 138: / Line 143: @@
 **1.** Find a mod that you want.
-\\
+  * [[https://umodframework.com/mods|Official Mod List]]
-[[https://umodframework.com/mods|Official Mod List]]
 <del>**<color #22b14c>Automatic Install:</color>**</del> **<color #ed1c24>(Not yet available for Linux)</color>**
@@ Line 146: / Line 150: @@
   * <del>The first time you will need to set your browser to always open those Install links with UMF.</del>
   * <del>If there is no Install link then follow the Manual Install steps.</del>
-\\
+/*  * {{:installguide_linux_uribrowsers.gif?nolink|}}
-{{:installguide_linux_uribrowsers.gif?nolink|}}
+  * {{:installguide_linux_modinstall.png?nolink|}}*/
-{{:installguide_linux_modinstall.png?nolink|}}
@@ Line 177: / Line 180: @@
 ====== Installing UMF for MacOS ======
+**<color #ed1c24>Warning: The graphical installer is currently not working for MacOS.\\
+Please install using the [[#command_line_macos|Command Line]] instead.</color>**
-**1.** **[[https://umodframework.com/download|Download UMF]]**
+**1.** **[[https://umodframework.com/beta?os=macos|Download UMF]]**
 **2.** Extract the zip file to your ''Desktop'' and start the **UMF.Installer(.app)** by double clicking it.
   * In your Security & Privacy panel you may need to choose ''Open Anyway'' for the UMF.Installer.
+  * If you do not get ''Open Anyway'' you will need to change the options in your Security & Privacy panel.
   * If you do not have mono you will be taken to a download page for mono.
   * You may need to restart your computer for the changes to take effect.
@@ Line 190: / Line 196: @@
   * If mouse input is not working for you, you can use Tab, Arrow Keys, and Enter to select. (Don't buy a Mac next time.)
   * If you know where your game is installed you can click "Select a Game Folder Manually" instead of using scan to find it.
-  * {{:installguide_macos_started.png?nolink|}}
+/*  * {{:installguide_macos_started.png?nolink|}}
-  * {{:installguide_macos_selectdrive.png?nolink|}}
+  * {{:installguide_macos_selectdrive.png?nolink|}}*/
 **4.** Select your game from the drop down list and click "Install".
-  * {{:installguide_macos_selectgame.png?nolink|}}
+/*  * {{:installguide_macos_selectgame.png?nolink|}}*/
 **5.** Click "Next" and then click "Exit".
   * You have now installed UMF can can start **[[#Installing Mods for MacOS|Installing Mods]]**.
-  * {{:installguide_macos_installed.png?nolink|}}
+/*  * {{:installguide_macos_installed.png?nolink|}}
-  * {{:installguide_macos_exit.png?nolink|}}
+  * {{:installguide_macos_exit.png?nolink|}}*/
 \\
-**<color #ffc90e>Command Line Install:</color>**\\
+===== Command line MacOS =====
 If you have issues with the GUI Installer you can also install UMF using a Terminal.
-  - Place the UMF.Installer(.app) on your desktop.
+  - Download the latest version of [[https://www.mono-project.com/download/stable/#download-mac|Mono]] and install it.
-  - Use the ''-install "path"'' parameter to install.
+  - [[https://umodframework.com/beta|Download UMF]]
-    * ''cd ~ && cd "Desktop/UMF.Installer.app/Contents/MacOS/" && mono UMF.Installer.exe -install "/PATH/TO/GAME/FOLDER"''
+  - Extract the zip file and place the UMF.Installer(.app) on your desktop.
-    * **EXAMPLE:** ''cd ~ && cd "Desktop/UMF.Installer.app/Contents/MacOS/" && mono UMF.Installer.exe -install ~/"Library/Application Support/Steam/steamapps/common/Slime Rancher/"''
+  - Open a **Terminal**.
+  - Use the ''**-install /PATH/TO/GAME/FOLDER/**'' parameter to install.
+    * **<color #00a2e8>Path Example:</color>**\\ ''cd ~/Desktop/UMF.Installer.app/Contents/MacOS/ && mono UMF.Installer.exe -install **/PATH/TO/GAME/FOLDER/**''
+    * **<color #00a2e8>Default Slime Rancher Steam Example:</color>**\\ ''cd ~/Desktop/UMF.Installer.app/Contents/MacOS/ && mono UMF.Installer.exe -install ~/Library/Application\ Support/Steam/steamapps/common/Slime\ Rancher/''
+    * **<color #00a2e8>Default Slime Rancher Epic Example:</color>**\\ ''cd ~/Desktop/UMF.Installer.app/Contents/MacOS/ && mono UMF.Installer.exe -install /Users/Shared/Epic\ Games/SlimeRancher/''\\
+  - Some users may need to also use ''chmod -R +rwx **/PATH/TO/GAME/FOLDER/**'' in order to give full permissions.
 \\
 ----
@@ Line 220: / Line 231: @@
 **1.** Find a mod that you want.
-\\
+  * [[https://umodframework.com/mods|Official Mod List]]
-[[https://umodframework.com/mods|Official Mod List]]
 <del>**<color #22b14c>Automatic Install:</color>**</del> **<color #ed1c24>(Not yet available for MacOS)</color>**
@@ Line 228: / Line 238: @@
   * <del>The first time you will need to set your browser to always open those Install links with UMF.</del>
   * <del>If there is no Install link then follow the Manual Install steps.</del>
-\\
+/*  * {{:installguide_macos_uribrowsers.gif?nolink|}}
-{{:installguide_macosx_uribrowsers.gif?nolink|}}
+  * {{:installguide_macos_modinstall.png?nolink|}}*/
-{{:installguide_macosx_modinstall.png?nolink|}}

Admin Detach Close

This topic does not exist yet

You've followed a link to a topic that doesn't exist yet. If permissions allow, you may create it by clicking on Create this page.