Mac Support: Difference between revisions

From Flashpoint Datahub
Jump to navigation Jump to search
(Officially releasing the Flashpoint 11 build!!)
(Temporary change to instructions while I finish with the new build)
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
This page provides information about the first official Flashpoint release for MacOS!
This page provides information about the first official Flashpoint release for MacOS! For information about older releases, see the [[/Beta 2022-06-22|Beta 2022-06-22]] subpage.


Please join our Discord and provide your feedback in the <code>#flashpoint-mac-linux-help</code> channel: http://discord.gg/S9uJ794
Please join our Discord and provide your feedback in the <code>#flashpoint-mac-linux-help</code> channel: http://discord.gg/S9uJ794
Line 14: Line 14:
<li>
<li>
Copy the following command, then paste it into the Terminal and press Return: <br>
Copy the following command, then paste it into the Terminal and press Return: <br>
<pre>/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/FlashpointProject/homebrew-flashpoint/main/InstallFlashpoint.command)"</pre>
<pre>/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/FlashpointProject/homebrew-flashpoint/main/DownloadFlashpoint.sh)"</pre>
[[File:PasteCommand.png]]
[[File:PasteCommand.png]]
</li>
</li>
<li>
<li>
Follow the instructions in your Terminal window to complete the installation.
Flashpoint may need to install some additional dependencies. If so, you will need to enter your password to authorize the Terminal to perform the installation. Your password will '''not''' be shared with Flashpoint. <br>
The terminal will not show anything while you are entering your password - this is normal. Simply type in your password and press Return, just as you usually would. <br>
[[File:EnterPassword.png]]
</li>
<li>
Once any dependencies have finished installing, Flashpoint will begin downloading. Wait for the download to complete. The terminal will indicate the download progress as shown below. <br>
[[File:TerminalDownloadingFlashpoint_v2.png]]
</li>
<li>
When the download completes, your new Flashpoint folder will open. Double-click the downloaded 7Z file to expand it.
* Note: You must use '''Archive Utility''' to expand the file! If double-clicking the file does not work, please [https://bluemaxima.org/flashpoint/datahub/index.php?title=Mac_Support&oldid=8290 follow the old installation instructions]. We are working on a fix - stay tuned!
</li>
<li>
When the file finishes expanding, you will see a new folder called "Flashpoint 11 Infinity". Open the folder, then open '''Flashpoint.app'''. <br>
[[File:FlashpointFolder.png]]
</li>
</li>
<li>
<li>
Line 26: Line 40:
</ol>
</ol>
'''Flashpoint is now installed!'''
'''Flashpoint is now installed!'''
== Troubleshooting ==
[[File:WineNotFound.png|thumb|The error message displayed when Wine is not installed and is required to run a game.]]
=== Installing Wine ===
If you see an error message about Wine when trying to run a game, that means you need to install Wine. Copy the following command, then paste it into the Terminal and press Return: <br>
<pre>/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/FlashpointProject/homebrew-flashpoint/main/InstallDependencies.sh)"</pre>
After Wine is installed, the game should run without further issues.
==== Installing Wine on old MacOS versions ====
If you are on MacOS Sierra (10.12) or earlier, the Flashpoint installer cannot automatically install Wine. If you want to play a game that requires Wine, you will need to install it through [https://www.macports.org/install.php#installing MacPorts] by following [https://github.com/Gcenx/macports-wine#how-to-use-this-repository these instructions].
For more information about Wine on MacOS, including manual installation instructions for each MacOS version, see [https://github.com/Gcenx/wine-on-mac Wine on Mac].
=== Flash EOL Screen ===
If you see the Flash Player EOL information screen (shown below) when you try to play a game, that means that Waterfox is loading your installed Flash Player plugin instead of the plugin that is bundled with Flashpoint. To fix the problem, [https://helpx.adobe.com/flash-player/kb/uninstall-flash-player-mac-os.html uninstall Flash Player from your Mac] and restart Flashpoint. Games should work in Waterfox now.
[[File:FlashTimebomb.png|200px]]
=== Fixing Dependencies Error ===
If you see a "Failed to install Flashpoint dependencies" error when trying to download Flashpoint, that likely means that something is wrong with your Homebrew installation. Run the following command in your terminal:
brew doctor
Next, read through the output and run any commands that it tells you to run.
Finally, [[#Installing Flashpoint|try installing Flashpoint again]].


== Using Flashpoint ==
== Using Flashpoint ==
Line 31: Line 71:


== Changelog ==
== Changelog ==
2022-08-25: Bundled dependencies with Flashpoint to make Homebrew unnecessary in many cases. Updated install scripts appropriately.


2022-08-17: Flashpoint 11 Infinity for Mac is now available!
2022-08-17: Flashpoint 11 Infinity for Mac is now available!
2022-06-22: Updated SeaMonkey to work in MacOS Big Sur and later.
2019-12-15: Added <code>"wmode":"direct"</code> to the default SWFObject parameters. This fixes certain 3D Flash games which previously did not work properly.
2019-12-14: First beta available!


== Technologies ==
== Technologies ==
Line 53: Line 89:
** Java in the browser is not supported yet.
** Java in the browser is not supported yet.
* Shockwave: Fully supported with Wine, including Shockwave in the browser.
* Shockwave: Fully supported with Wine, including Shockwave in the browser.
* Unity Web Player and ShiVa3D: Supported with Wine and the help of custom shell scripts.
* ShiVa3D: Supported with Wine and the help of custom shell scripts.
* 3DVIA, Authorware, GoBit, PopCap, Silverlight, Vitalize, Tcl, DeepV, LiveMath, AnimaFlex, Visual WebMap, o2c-Player, Squeak, WebAnimator, iPix: All supported in Flashpoint Navigator with Wine!
* 3DVIA, Authorware, GoBit, PopCap, Silverlight, Vitalize, Tcl, DeepV, LiveMath, AnimaFlex, Visual WebMap, o2c-Player, Squeak, WebAnimator, iPix: All supported in Flashpoint Navigator with Wine!
An attempt was made to support Unity Web Player, but it is not working right now. See [[#Known Issues|Known Issues]].


Most of the remaining unsupported technologies rely on Flashpoint Secure Player, which is only compatible with Windows right now. We hope to port some of Flashpoint Secure Player's functionality to a launcher extension to enable support for more platforms; see the [[Help Wanted List]] for more information. Another possibility may be to port Flashpoint Secure Player itself to MacOS and Linux, using the cross-platform features of .NET/C#. Regardless, Flashpoint Secure Player's support for ActiveX controls relies on Windows-only features and cannot be ported to other platforms.
Most of the remaining unsupported technologies rely on Flashpoint Secure Player, which is only compatible with Windows right now. We hope to port some of Flashpoint Secure Player's functionality to a launcher extension to enable support for more platforms; see the [[Help Wanted List]] for more information. Another possibility may be to port Flashpoint Secure Player itself to MacOS and Linux, using the cross-platform features of .NET/C#. Regardless, Flashpoint Secure Player's support for ActiveX controls relies on Windows-only features and cannot be ported to other platforms.
Line 61: Line 99:
* [https://github.com/FlashpointProject/launcher/issues/333#issuecomment-1218457380 Launching HTML5 games that use Flashpoint Launcher's Browser Mode fails and shows an error popup].
* [https://github.com/FlashpointProject/launcher/issues/333#issuecomment-1218457380 Launching HTML5 games that use Flashpoint Launcher's Browser Mode fails and shows an error popup].
* For unknown reasons, if a game fails to launch, the launcher may claim that an update is available and force a restart, as shown below. No update will actually occur. <br> [[File:LauncherRestart.png]]
* For unknown reasons, if a game fails to launch, the launcher may claim that an update is available and force a restart, as shown below. No update will actually occur. <br> [[File:LauncherRestart.png]]
* Unity Web Player games will get stuck on the loading screen. Audio will play but the graphics will not initialize. We are currently trying to diagnose the cause of this problem.
* Clicking a link inside a Flash game that launches your default web browser may also crash the browser. This is because the Flash projector is launched with an environment variable telling it to load FlashpointProxyMac, and it passes the variable to its child processes. But the variable value is a relative path to the FlashpointProxyMac library, and the relative path will not resolve correctly for applications in other locations, such as your default web browser. Thus the browser will fail to load the library and will crash.
* Clicking a link inside a Flash game that launches your default web browser may also crash the browser. This is because the Flash projector is launched with an environment variable telling it to load FlashpointProxyMac, and it passes the variable to its child processes. But the variable value is a relative path to the FlashpointProxyMac library, and the relative path will not resolve correctly for applications in other locations, such as your default web browser. Thus the browser will fail to load the library and will crash.
** This only happens if the browser is not already open because when launching a new instance of an existing process, it inherits the environment of the existing process.
** This only happens if the browser is not already open because when launching a new instance of an existing process, it inherits the environment of the existing process.
Line 67: Line 106:
* Flash games that use Waterfox may not work in mainland China due to Adobe's geolocation restrictions, which we have not patched out of the MacOS browser plugin yet. A workaround would be to use Wine to play the games instead. To switch to Wine, click the Config tab of the launcher, scroll down and click the "Native Platforms" dropdown, and uncheck Flash.
* Flash games that use Waterfox may not work in mainland China due to Adobe's geolocation restrictions, which we have not patched out of the MacOS browser plugin yet. A workaround would be to use Wine to play the games instead. To switch to Wine, click the Config tab of the launcher, scroll down and click the "Native Platforms" dropdown, and uncheck Flash.
* HTML5 games may perform poorly in Waterfox on Apple Silicon Macs. This is a side effect of running Waterfox in Intel (x86_64) mode, which the Flash plugin requires. In the future, we plan to run HTML5 games in native mode on Apple Silicon Macs while continuing to run Flash games in Intel mode. This would require two separate startWaterfox shell scripts and a launcher extension to choose which one to run based on the launched game's Platform field.
* HTML5 games may perform poorly in Waterfox on Apple Silicon Macs. This is a side effect of running Waterfox in Intel (x86_64) mode, which the Flash plugin requires. In the future, we plan to run HTML5 games in native mode on Apple Silicon Macs while continuing to run Flash games in Intel mode. This would require two separate startWaterfox shell scripts and a launcher extension to choose which one to run based on the launched game's Platform field.
* A [[:File:JavaScriptError.png|JavaScript error popup]] may appear when starting Flashpoint. After dismissing the popup, Flashpoint should work normally.
* [https://github.com/FlashpointProject/launcher/issues/378 The Flashpoint Path box on the Config tab is highlighted in red even though it is valid]. This may be confusing but does not impact Flashpoint's functionality.
* [https://github.com/FlashpointProject/launcher/issues/378 The Flashpoint Path box on the Config tab is highlighted in red even though it is valid]. This may be confusing but does not impact Flashpoint's functionality.


<noinclude>[[Category:Technologies]]</noinclude>
<noinclude>[[Category:Technologies]]</noinclude>

Revision as of 13:14, 26 August 2022

This page provides information about the first official Flashpoint release for MacOS! For information about older releases, see the Beta 2022-06-22 subpage.

Please join our Discord and provide your feedback in the #flashpoint-mac-linux-help channel: http://discord.gg/S9uJ794

Installing Flashpoint

  1. Open Finder, then click the Applications tab.
  2. Scroll down and double-click the Utilities folder to open it. Then open the Terminal app.
    TerminalInUtilitiesFolder.png
  3. Copy the following command, then paste it into the Terminal and press Return:
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/FlashpointProject/homebrew-flashpoint/main/DownloadFlashpoint.sh)"

    PasteCommand.png

  4. Flashpoint may need to install some additional dependencies. If so, you will need to enter your password to authorize the Terminal to perform the installation. Your password will not be shared with Flashpoint.
    The terminal will not show anything while you are entering your password - this is normal. Simply type in your password and press Return, just as you usually would.
    EnterPassword.png
  5. Once any dependencies have finished installing, Flashpoint will begin downloading. Wait for the download to complete. The terminal will indicate the download progress as shown below.
    TerminalDownloadingFlashpoint v2.png
  6. When the download completes, your new Flashpoint folder will open. Double-click the downloaded 7Z file to expand it.
  7. When the file finishes expanding, you will see a new folder called "Flashpoint 11 Infinity". Open the folder, then open Flashpoint.app.
    FlashpointFolder.png
  8. After Flashpoint opens, Control-click the Flashpoint icon in the Dock, then choose Options > Keep in Dock.
    KeepInDock.png

Flashpoint is now installed!

Troubleshooting

The error message displayed when Wine is not installed and is required to run a game.

Installing Wine

If you see an error message about Wine when trying to run a game, that means you need to install Wine. Copy the following command, then paste it into the Terminal and press Return:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/FlashpointProject/homebrew-flashpoint/main/InstallDependencies.sh)"

After Wine is installed, the game should run without further issues.

Installing Wine on old MacOS versions

If you are on MacOS Sierra (10.12) or earlier, the Flashpoint installer cannot automatically install Wine. If you want to play a game that requires Wine, you will need to install it through MacPorts by following these instructions.

For more information about Wine on MacOS, including manual installation instructions for each MacOS version, see Wine on Mac.

Flash EOL Screen

If you see the Flash Player EOL information screen (shown below) when you try to play a game, that means that Waterfox is loading your installed Flash Player plugin instead of the plugin that is bundled with Flashpoint. To fix the problem, uninstall Flash Player from your Mac and restart Flashpoint. Games should work in Waterfox now.

FlashTimebomb.png

Fixing Dependencies Error

If you see a "Failed to install Flashpoint dependencies" error when trying to download Flashpoint, that likely means that something is wrong with your Homebrew installation. Run the following command in your terminal:

brew doctor

Next, read through the output and run any commands that it tells you to run.

Finally, try installing Flashpoint again.

Using Flashpoint

See the Flashpoint Manual.

Changelog

2022-08-25: Bundled dependencies with Flashpoint to make Homebrew unnecessary in many cases. Updated install scripts appropriately.

2022-08-17: Flashpoint 11 Infinity for Mac is now available!

Technologies

Currently, only Flashpoint Infinity is available for Mac. We plan to also create a Flashpoint Ultimate package for MacOS in the future. To do this, we will need to set up Apache for use on MacOS, including all of its required modules.

Thanks to the work of volunteer LindirQuenya (Ardil), we now have an equivalent to FlashpointProxy for Mac, aptly named FlashpointProxyMac. This allows us to use the native standalone projectors for most Flash games and eliminates nearly all of the Flash-related bugs that plagued previous Flashpoint Mac builds.

Flashpoint for Mac now includes Wine-crossover as a dependency. This is a version of Wine specially designed to run on MacOS. Thanks to Wine-crossover, Flashpoint for Mac now supports 21 web technologies (Platforms):

  • Flash: Supported natively with standalone projectors. Older 32-bit-only Flash versions are supported through Wine.
  • HTML5: Supported natively with Waterfox Classic and Chromium.
  • Java Applets: Supported natively with the Java Development Kit.
    • Java in the browser is not supported yet.
  • Shockwave: Fully supported with Wine, including Shockwave in the browser.
  • ShiVa3D: Supported with Wine and the help of custom shell scripts.
  • 3DVIA, Authorware, GoBit, PopCap, Silverlight, Vitalize, Tcl, DeepV, LiveMath, AnimaFlex, Visual WebMap, o2c-Player, Squeak, WebAnimator, iPix: All supported in Flashpoint Navigator with Wine!

An attempt was made to support Unity Web Player, but it is not working right now. See Known Issues.

Most of the remaining unsupported technologies rely on Flashpoint Secure Player, which is only compatible with Windows right now. We hope to port some of Flashpoint Secure Player's functionality to a launcher extension to enable support for more platforms; see the Help Wanted List for more information. Another possibility may be to port Flashpoint Secure Player itself to MacOS and Linux, using the cross-platform features of .NET/C#. Regardless, Flashpoint Secure Player's support for ActiveX controls relies on Windows-only features and cannot be ported to other platforms.

Known Issues

  • Launching HTML5 games that use Flashpoint Launcher's Browser Mode fails and shows an error popup.
  • For unknown reasons, if a game fails to launch, the launcher may claim that an update is available and force a restart, as shown below. No update will actually occur.
    LauncherRestart.png
  • Unity Web Player games will get stuck on the loading screen. Audio will play but the graphics will not initialize. We are currently trying to diagnose the cause of this problem.
  • Clicking a link inside a Flash game that launches your default web browser may also crash the browser. This is because the Flash projector is launched with an environment variable telling it to load FlashpointProxyMac, and it passes the variable to its child processes. But the variable value is a relative path to the FlashpointProxyMac library, and the relative path will not resolve correctly for applications in other locations, such as your default web browser. Thus the browser will fail to load the library and will crash.
    • This only happens if the browser is not already open because when launching a new instance of an existing process, it inherits the environment of the existing process.
    • We considered avoiding the problem by referring to the FlashpointProxyMac library with an absolute path, but this would force the launched browser to use Flashpoint's proxy, which is not ideal either.
    • It seems like older Flash projector versions do not have this issue, so we are considering using the Adobe Flash Player 29 projector by default on MacOS if no better solution is found.
  • Flash games that use Waterfox may not work in mainland China due to Adobe's geolocation restrictions, which we have not patched out of the MacOS browser plugin yet. A workaround would be to use Wine to play the games instead. To switch to Wine, click the Config tab of the launcher, scroll down and click the "Native Platforms" dropdown, and uncheck Flash.
  • HTML5 games may perform poorly in Waterfox on Apple Silicon Macs. This is a side effect of running Waterfox in Intel (x86_64) mode, which the Flash plugin requires. In the future, we plan to run HTML5 games in native mode on Apple Silicon Macs while continuing to run Flash games in Intel mode. This would require two separate startWaterfox shell scripts and a launcher extension to choose which one to run based on the launched game's Platform field.
  • A JavaScript error popup may appear when starting Flashpoint. After dismissing the popup, Flashpoint should work normally.
  • The Flashpoint Path box on the Config tab is highlighted in red even though it is valid. This may be confusing but does not impact Flashpoint's functionality.