Mac Support: Difference between revisions

From Flashpoint Datahub
Jump to navigation Jump to search
(Switched back to opening the launcher via the app)
(Updated to Flashpoint 14.0.2)
Line 1: Line 1:
This page provides information about the latest official Flashpoint release for macOS. For information about older releases, see the [[/Beta 2022-06-22|Beta 2022-06-22]] subpage.
This page provides information about the latest official Flashpoint release for Mac. For information about older releases, see the [[/Beta 2022-06-22|Beta 2022-06-22]] subpage.


If you have any issues running Flashpoint, please join our Discord and post your issues in a new thread on the <code>help</code> forum channel: http://discord.gg/S9uJ794
If you have any issues running Flashpoint, please [https://discord.gg/S9uJ794 join our Discord] and post your issues in a new thread on the <code>help</code> forum channel.


== Compatibility ==
== Compatibility ==
There are 2 variants of Flashpoint for macOS: a regular and legacy one. The regular variant is compatible with macOS Catalina and newer, while the legacy one is made for High Sierra and Mojave. If you have an earlier macOS version, you will need to use the older [[/Beta 2022-06-22|Beta 2022-06-22]] version of Flashpoint. See the table below for detailed information, or [[#Installing Flashpoint|skip to the next section]] to begin installing Flashpoint.
Flashpoint for Mac is fully compatible with macOS High Sierra and newer. Older versions won't work due to the launcher being incompatible with them. See the table below for a detailed support chart, or [[#Installing Flashpoint|skip to the next section to begin installing Flashpoint]].


{| class="wikitable"
{|class="wikitable"
!colspan="2"|Supported macOS versions
!colspan="2"|Supported macOS versions
!Notes
|-
|-
!<abbr title="10.12">Sierra</abbr> & older
!<abbr title="10.12">Sierra</abbr>
!style="background-color:#fdb3ab;"|Unsupported
!style="background-color:#fdb3ab;"|Unsupported
!Launcher claims to support<br><abbr title="10.11">El Capitan</abbr>, but uses syscalls<br>added in High Sierra.
|-
|-
!<abbr title="10.13">High Sierra</abbr>
!<abbr title="10.13">High Sierra</abbr>
!rowspan="2" style="background-color:#fef8c6;"|[[#Legacy Support|Legacy support]]
!rowspan="8" style="background-color:#d4f4b4;"|Fully supported
!rowspan="2"|May be very slow when<br>loading/searching content.
|-
|-
!<abbr title="10.14">Mojave</abbr>
!<abbr title="10.14">Mojave</abbr>
|-
|-
!<abbr title="10.15">Catalina</abbr>
!<abbr title="10.15">Catalina</abbr>
!rowspan="5" style="background-color:#d4f4b4;"|Full support
!rowspan="6"|Catalina & newer can't run<br>32-bit apps, so Wine must<br>convert 32-bit calls to 64-bit.<br>Non-native 32-bit apps<br>will run slower as a result.
|-
|-
!<abbr title="11">Big Sur</abbr>
!<abbr title="11">Big Sur</abbr>
Line 27: Line 30:
|-
|-
!<abbr title="14">Sonoma</abbr>
!<abbr title="14">Sonoma</abbr>
|-
!<abbr title="15">Sequoia</abbr>
|}
|}


Line 40: Line 45:
</li>
</li>
<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 to download Flashpoint:<br>
<pre>curl -fo ~/Downloads/fp13_mac.tar.xz https://download.unstable.life/upload/fp13_mac.tar.xz</pre>
<pre>mkdir -p ~/Downloads && curl -fL https://download.flashpointarchive.org/upload/fp14.0.2_mac.txz | tar xC ~/Downloads</pre>
[[File:MacFP13Download.png]]<br>
[[File:MacFP14Download.png]]<br>
'''Note''': Third-party firewalls such as LuLu may block the download with a "Couldn't connect to server" or "Could not resolve hostname" error. If you have any third-party firewalls installed, turn them off before running the download.
'''Note''': 3rd party firewalls like LuLu may block the download with a "Couldn't connect to server" or "Could not resolve hostname" error. If you have any installed, turn them off beforehand.
</li>
<li>
When the download completes, the file, "fp13_mac.tar.xz", will be in your Downloads. Control-click the downloaded XZ file, then choose Open With > Archive Utility.<br>
[[File:MacArchiveUtility.png]]<br>
'''Note''': You must use the Archive Utility instead of any third-party tools you may have installed, as some of them may set a quarantine flag that will prevent Flashpoint from working properly.
</li>
</li>
<li>
<li>
When the file finishes expanding, you will see a new folder called "Flashpoint 13 for macOS". Open the folder, then open the Flashpoint application.<br>
When the download completes, you will see a new folder called "Flashpoint 14.0.2 for Mac" in your Downloads. Open the folder, then run the Flashpoint application.<br>
[[File:MacFlashpointApp.png]]
[[File:MacFP14FlashpointApp.png]]
</li>
</li>
<li>
<li>
Line 66: Line 66:


[[File:FlashTimebomb.png|200px]]
[[File:FlashTimebomb.png|200px]]
== Legacy Support ==
For those still running macOS High Sierra or Mojave, there is a legacy variant of Flashpoint that can be installed instead of the regular one. To install it, follow all of the instructions listed in the [[#Installing Flashpoint|installation section]] until step 3, then replace the terminal command you are meant to run with the following:
<pre>curl -fko ~/Downloads/fp13_mac_legacy.tar.xz https://download.unstable.life/upload/fp13_mac_legacy.tar.xz</pre>
This will download the legacy variant of Flashpoint to your Downloads folder. Once it's finished downloading, you may follow the rest of the installation steps.
The only major difference between this variant and the regular one is the version of Wine bundled in. The regular variant uses a version of Wine built for macOS Catalina and newer that runs with only 64-bit libraries, while the legacy variant uses an older version that includes both 32-bit and 64-bit libraries. This is because macOS Catalina dropped support for running 32-bit programs, which many of the platforms that can be ran on Flashpoint are, such as Flash, Shockwave and other web-based plugins.


== Using Flashpoint ==
== Using Flashpoint ==
Line 78: Line 71:


== Changelog ==
== Changelog ==
2025-06-16: Flashpoint 14.0.2 for Mac is now available!


2024-06-27: Brought back the ability to open Flashpoint with the application, and reduced the download's file size.
2024-06-27: Brought back the ability to open Flashpoint with the application, and reduced the download's file size.
Line 90: Line 85:


== Technologies ==
== Technologies ==
Currently, only Flashpoint Infinity is available for macOS. 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.
Currently, only Flashpoint Infinity is available for Mac. We plan to also create a Flashpoint Ultimate package for Mac in the future. To do this, we will need to set up Apache for use on Mac, including all of its required modules.


Thanks to the work of volunteer [https://github.com/LindirQuenya/ LindirQuenya (Ardil)], we now have an equivalent to FlashpointProxy for Mac, aptly named [https://github.com/FlashpointProject/FlashpointProxyMac 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.
Thanks to the work of volunteer [https://github.com/LindirQuenya/ LindirQuenya (Ardil)], we have an equivalent to FlashpointProxy for Mac, aptly named [https://github.com/FlashpointProject/FlashpointProxyMac 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 macOS supports several web technologies ([[Platforms]]), including:
Flashpoint for Mac supports several [[Platforms|web technologies]], including:
* Flash: Supported natively with standalone projectors.
* Flash: Supported natively with standalone projectors. Installed by default.
** Flash in the browser is supported natively with [https://classic.waterfox.net/ Waterfox Classic].
** Flash in the browser is supported natively with [https://classic.waterfox.net/ Waterfox Classic].
* HTML5: Supported natively with Waterfox Classic and Chromium.
* HTML5: Supported natively with Waterfox Classic and Chromium. Installed by default.
** Games that use Flashpoint Launcher's Browser Mode are [[#Known Issues|not supported yet]].
** Games that use Flashpoint Launcher's Browser Mode are [[#Known Issues|not supported yet]].
* Java Applets: Supported natively with the Java Development Kit.
* Java Applets: Supported natively with the Java Development Kit. Installed by default.
** 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. Installed by default.
* 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, Vitalize, Tcl, DeepV, LiveMath, AnimaFlex, Visual WebMap, Squeak, WebAnimator, iPix: All supported in Flashpoint Navigator with Wine!
* Various other web platforms that run via Flashpoint Navigator with Wine.
** For a full support list, see README.txt in the main folder extracted from the downloaded archive file.


An attempt was made to support Unity Web Player, but it is not working right now. See [[#Known Issues|Known Issues]].
An attempt was made to support Unity Web Player in Wine, but it is not working right now. See [[#Known Issues|Known Issues]].


== Known Issues ==
== Known Issues ==
* [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].
* 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.  
* Unity Web Player games in Wine 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.
** 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.
** 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.
** 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 Mac if no better solution is found.
* Flash games that use Waterfox Classic 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 Classic may not work in mainland China due to Adobe's geolocation restrictions, which we have not patched out of the Mac 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 Classic on Apple Silicon Macs because Waterfox Classic is an Intel binary. In the future, we plan to run HTML5 games using a different browser such as Chromium. Or we may switch from Waterfox Classic to our own build of Flashpoint Navigator for macOS, if we are able to get that working. Either way, we may need a launcher extension to choose which browser to launch based on a game's Platform, because both Flash and HTML5 games use Basilisk on Windows.
* HTML5 games may perform poorly in Waterfox Classic on Apple Silicon Macs because Waterfox Classic is an Intel binary. In the future, we plan to run HTML5 games using a different browser such as Chromium. Or we may switch from Waterfox Classic to our own build of Flashpoint Navigator for Mac, if we are able to get that working. Either way, we may need a launcher extension to choose which browser to launch based on a game's Platform, because both Flash and HTML5 games use Basilisk on Windows.


== Running Windows on your Mac ==
== Running Windows on your Mac ==

Revision as of 01:46, 16 June 2025

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

If you have any issues running Flashpoint, please join our Discord and post your issues in a new thread on the help forum channel.

Compatibility

Flashpoint for Mac is fully compatible with macOS High Sierra and newer. Older versions won't work due to the launcher being incompatible with them. See the table below for a detailed support chart, or skip to the next section to begin installing Flashpoint.

Supported macOS versions Notes
Sierra Unsupported Launcher claims to support
El Capitan, but uses syscalls
added in High Sierra.
High Sierra Fully supported May be very slow when
loading/searching content.
Mojave
Catalina Catalina & newer can't run
32-bit apps, so Wine must
convert 32-bit calls to 64-bit.
Non-native 32-bit apps
will run slower as a result.
Big Sur
Monterey
Ventura
Sonoma
Sequoia

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.
    MacUtilitiesFolder.png MacTerminal.png
  3. Copy the following command, then paste it into the Terminal and press Return to download Flashpoint:
    mkdir -p ~/Downloads && curl -fL https://download.flashpointarchive.org/upload/fp14.0.2_mac.txz | tar xC ~/Downloads

    MacFP14Download.png
    Note: 3rd party firewalls like LuLu may block the download with a "Couldn't connect to server" or "Could not resolve hostname" error. If you have any installed, turn them off beforehand.

  4. When the download completes, you will see a new folder called "Flashpoint 14.0.2 for Mac" in your Downloads. Open the folder, then run the Flashpoint application.
    MacFP14FlashpointApp.png
  5. After Flashpoint opens, you may optionally keep the application in the Dock by control-clicking the Flashpoint icon in the Dock, then choosing Options > Keep in Dock.
    MacKeepInDock.png

Flashpoint is now installed!

Troubleshooting

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 Classic 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 Classic now.

FlashTimebomb.png

Using Flashpoint

See the Flashpoint Manual.

Changelog

2025-06-16: Flashpoint 14.0.2 for Mac is now available!

2024-06-27: Brought back the ability to open Flashpoint with the application, and reduced the download's file size.

2024-06-25: Fixed an issue preventing Waterfox from launching.

2024-06-22: Flashpoint 13 for macOS is now available!

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 Mac in the future. To do this, we will need to set up Apache for use on Mac, including all of its required modules.

Thanks to the work of volunteer LindirQuenya (Ardil), we 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 supports several web technologies, including:

  • Flash: Supported natively with standalone projectors. Installed by default.
  • HTML5: Supported natively with Waterfox Classic and Chromium. Installed by default.
  • Java Applets: Supported natively with the Java Development Kit. Installed by default.
    • Java in the browser is not supported yet.
  • Shockwave: Fully supported with Wine, including Shockwave in the browser. Installed by default.
  • ShiVa3D: Supported with Wine and the help of custom shell scripts.
  • Various other web platforms that run via Flashpoint Navigator with Wine.
    • For a full support list, see README.txt in the main folder extracted from the downloaded archive file.

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

Known Issues

  • Launching HTML5 games that use Flashpoint Launcher's Browser Mode fails and shows an error popup.
  • Unity Web Player games in Wine 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 Mac if no better solution is found.
  • Flash games that use Waterfox Classic may not work in mainland China due to Adobe's geolocation restrictions, which we have not patched out of the Mac 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 Classic on Apple Silicon Macs because Waterfox Classic is an Intel binary. In the future, we plan to run HTML5 games using a different browser such as Chromium. Or we may switch from Waterfox Classic to our own build of Flashpoint Navigator for Mac, if we are able to get that working. Either way, we may need a launcher extension to choose which browser to launch based on a game's Platform, because both Flash and HTML5 games use Basilisk on Windows.

Running Windows on your Mac

For a better experience, you may want to use the latest version of Flashpoint for Windows instead of the current Mac version. There are two main options for doing so:

If you have enough disk space, Boot Camp is the most reliable option.

Once you have Windows up and running, follow these steps to install Flashpoint:

  1. Download Flashpoint if you haven't yet.
  2. Within your Windows environment, run the Flashpoint installer. You don't need to change any options, though you can if you want to.
    FlashpointInstaller.png
  3. When you're ready, click the "Install Flashpoint" button.
  4. After Flashpoint is done installing, double-click the new Flashpoint shortcut on your Windows desktop to start playing!