This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
install [2019/06/27 21:28] umfdev [<color #ffc90e>Command line Install:</color>] |
install [2021/08/06 23:46] (current) umfdev [Installing UMF for MacOS] |
||
---|---|---|---|
Line 1: | Line 1: | ||
~~NOTOC~~ | ~~NOTOC~~ | ||
~~Title: Install Guide ~~ | ~~Title: Install Guide ~~ | ||
+ | {{tag>Help}} | ||
<WRAP center round info 100%> | <WRAP center round info 100%> | ||
**This guide will aid you in the installation of UMF and it's Mods.** | **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. | **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]] | * 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". | **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. | * 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". | **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". | **5.** Click "Next" and then click "Exit". | ||
* You have now installed UMF can can start **[[#Installing Mods for Windows|Installing Mods]]**. | * 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]]** | **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. | **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>** | **<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. | * 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. | * 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.) | **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. | * 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. | **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. | * 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". | **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. | * 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". | **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". | **5.** Click "Next" and then click "Exit". | ||
* You have now installed UMF can can start **[[#Installing Mods for Linux|Installing Mods]]**. | * 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. | **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>** | <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>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> | * <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 ====== | ====== 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. | **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. | * 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. | * 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. | * 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 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. | * 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". | **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". | **5.** Click "Next" and then click "Exit". | ||
* You have now installed UMF can can start **[[#Installing Mods for MacOS|Installing Mods]]**. | * 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|}}*/ |
\\ | \\ | ||
- | ===== Command line Install: ===== | + | ===== Command line MacOS ===== |
If you have issues with the GUI Installer you can also install UMF using a Terminal. | 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. |
- | * **Default Slime Rancher Steam 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**. |
- | * **Default Slime Rancher Epic Example:** ''cd ~ && cd "Desktop/UMF.Installer.app/Contents/MacOS/" && mono UMF.Installer.exe -install "/Users/Shared/Epic Games/SlimeRancer/"'' | + | - Use the ''**-install /PATH/TO/GAME/FOLDER/**'' parameter to install. |
- | - You may need to also use ''chmod -R +rwx "/PATH/TO/GAME/FOLDER"'' in order to give full permissions. | + | * **<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 222: | Line 231: | ||
**1.** Find a mod that you want. | **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>** | <del>**<color #22b14c>Automatic Install:</color>**</del> **<color #ed1c24>(Not yet available for MacOS)</color>** | ||
Line 230: | Line 238: | ||
* <del>The first time you will need to set your browser to always open those Install links with UMF.</del> | * <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> | * <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|}} | + | |