Changes

Jump to navigation Jump to search
Line 125: Line 125:     
==Manually Launching SMAPI on M1 Mac==  
 
==Manually Launching SMAPI on M1 Mac==  
 +
MacOS versions that rely on M1 chips may present an error when attempting to launch SMAPI. This error indicates that SMAPI's attempt to auto-launch was blocked because of a permissions issue. The following should help resolve the error. 
 +
{| class="wikitable"
 +
|-
 +
! Visual !! Instructions
 +
|-
 +
|
   −
Recent versions of MacOS, particularly those that rely on M1 chips, may present an error when attempting to launch SMAPI. 
+
<span style="font-size:180%;">'''STEP 1'''</span>
   −
[[File:Nullpermissions.png|220px]]
+
[[File:Nullpermissions.png|center|220px]]
 +
||First click on the information button (blue circle with italicized i), which will reveal a file path to the auto-launcher.
 +
|-
 +
|
   −
This error is telling you that SMAPI's attempt to auto-launch was blocked because of a permissions issue. You can manually override this error. First click on the information button (blue circle with italicized i), which will reveal a file path to the auto-launcher.
+
<span style="font-size:180%;">'''STEP 2'''</span>
   −
[[File:Nullpermissionsinfo.png|400px]]
+
[[File:Nullpermissionsinfo.png|center|400px]]
 +
||Double-click on the '''tmp''' folder icon to bring up a new Finder window for that folder. This folder is hidden, so the easiest way to access it is directly through the error message.
 +
|-
 +
|
   −
Double-click on the document icon to open a Finder window showing the hidden tmp folder with the SMAPI launcher. The tmp folder is in the hidden private folder, so it is easiest to access it directly through the error message.
+
<span style="font-size:180%;">'''STEP 3'''</span>
   −
If this is the first time you are doing this, your file will likely say open-smapi-terminal.sh (this is the default launcher that is created when installing SMAPI, and will not naturally be read by M1 Terminal).
+
[[File:Tmpsh.png|center|500px]]
 +
||The first time you do this, you'll need to locate the file likely named <samp>open-smapi-terminal.sh</samp>. (This is the default launcher created when installing SMAPI and isn't automatically read by M1 Terminal.)
   −
[[File:Tmpsh.png|500px]]
+
Right-click (two-fingered click on trackpad) on <samp>open-smapi-terminal.sh</samp> and navigate to ''Get Info''.  
 +
|-
 +
|
 +
 +
<span style="font-size:180%;">'''STEP 4'''</span>
   −
Right-click (two-fingered click on trackpad) on open-smapi-terminal.sh and select Get Info. In the "Open With" section, open the drop-down menu and go all the way to the bottom to select "Other...". Your Applications folder will open.  
+
[[File:Getinfosh.png|center|300 px]]
 +
||Locate the "Open With" section and click on the blue arrow box to open the drop-down menu.  
 +
|-
 +
|
   −
[[File:Getinfosh.png|240px]] 
+
<span style="font-size:180%;">'''STEP 5'''</span>
[[File:Openwithother.png|260px]]
     −
(It does not matter what the default application is -- if yours is not Sublime Text, don't worry about it, we're changing it anyway. It must be set to Terminal for SMAPI to launch.)
+
[[File:Openwithother.png|center|260px]]
 +
||Scroll to the bottom of the list and select "Other...". This will open the Applications folder.
   −
In your Applications folder, scroll down to find the Utilities folder and open it. You should find Terminal listed here. Select it and click "Add."
+
(It does not matter what the default application is -- if yours is not Sublime Text, don't worry about it, we're changing it anyway.)
 +
|-
 +
|
   −
[[File:Utilitiesfolder.png|500px]]
+
<span style="font-size:180%;">'''STEP 5'''</span>
   −
If it is grayed out, use the drop-down menu below the applications list to Enable "All Applications". All applications may temporarily gray out, but they will shortly become available. Select Terminal and click "Add."  
+
[[File:Utilitiesfolder.png|center|500px]]
 +
||Scroll down to find the "Utilities" folder and double-click to open it. Locate '''Terminal''', select it, and click the blue "Add" button.
 +
|-
 +
|[[File:Enableall.png|center|500px]]
 +
||If '''Terminal''' is grayed out, use the drop-down menu below the applications list to Enable "All Applications". All applications may temporarily gray out, but they will shortly become available. Select '''Terminal''' and click "Add."
 +
|-
 +
|
   −
[[File:Enableall.png|500px]]
+
<span style="font-size:180%;">'''STEP 6'''</span>
   −
After clicking Add you should be returned to the tmp folder where the SMAPI launcher resides. Double-click on it to launch SMAPI with Terminal.  
+
[[File:Tmpsh2.png|center|500px]]
 +
||After clicking "Add" you should be returned to the '''tmp''' folder from Step 2. Double-click on the file named <samp>open-smapi-terminal.command</samp> to launch SMAPI with Terminal.  
 +
|}
    
You may find you have to manually launch SMAPI every time you want to play. Once you have set Terminal as the launching application, manually launching is as simple as clicking on the info button in the error message, opening the tmp folder, and then double-clicking either the .sh or the .command launcher file. Both will launch SMAPI in terminal.
 
You may find you have to manually launch SMAPI every time you want to play. Once you have set Terminal as the launching application, manually launching is as simple as clicking on the info button in the error message, opening the tmp folder, and then double-clicking either the .sh or the .command launcher file. Both will launch SMAPI in terminal.
 +
       
[[Category:Modding]]
 
[[Category:Modding]]
      
==History==
 
==History==
 
{{History|Updated for SMAPI 4.0.0 and later.}}
 
{{History|Updated for SMAPI 4.0.0 and later.}}
634

edits

Navigation menu