Linux Support: Difference between revisions

From Flashpoint Datahub
Jump to navigation Jump to search
No edit summary
(Updated Shockwave information)
Line 37: Line 37:
The [http://bluemaxima.org/flashpoint/faq/ Flashpoint FAQ] contains a list of all web game technologies ("Platforms") supported in the Windows version of Flashpoint. The Linux version currently supports a subset of these platforms. This is explained in detail below.
The [http://bluemaxima.org/flashpoint/faq/ Flashpoint FAQ] contains a list of all web game technologies ("Platforms") supported in the Windows version of Flashpoint. The Linux version currently supports a subset of these platforms. This is explained in detail below.
* Flash: Supported through Wine by default. Although a Linux Flash Projector exists, it suffers from graphical glitches on many systems. If you'd like to try your luck with the native projector, open <code>Flash.xml</code> in a text editor, then replace each instance of <code>FPSoftware/flashplayer_32_sa.exe</code> with <code>FPSoftware/Flash/linux/flashplayer32SA</code> (the path to the Linux projector). Finally, click the Config tab and uncheck "Use Wine" if it is checked.
* Flash: Supported through Wine by default. Although a Linux Flash Projector exists, it suffers from graphical glitches on many systems. If you'd like to try your luck with the native projector, open <code>Flash.xml</code> in a text editor, then replace each instance of <code>FPSoftware/flashplayer_32_sa.exe</code> with <code>FPSoftware/Flash/linux/flashplayer32SA</code> (the path to the Linux projector). Finally, click the Config tab and uncheck "Use Wine" if it is checked.
* Shockwave: supported through Wine, but only locally. Any games that use Shockwave Projector Redirector (SPR) will not work. This is because SPR is hardcoded to use proxy port 8888. A version that uses port 22500 should be released soon.
* Shockwave: supported through Wine, but only locally. Any games that use Shockwave Projector Redirector (SPR) will not work. This is because SPR is hardcoded to use proxy port 8888. However, a [https://github.com/FlashpointProject/Shockwave-Projector-Redirector-for-Flashpoint new version of SPR] with a user-configurable port number has just been released. It needs to be added to the Linux build and tested.
* HTML5: Supported natively through the Basilisk browser. Be sure to switch off Wine from the Config tab. To update Basilisk, download it from [http://us.basilisk-browser.org/release/basilisk-latest.linux64.tar.bz2 here] and extract it such that the executable is located at <code>FPSoftware/Basilisk-Portable/linux/basilisk</code>.
* HTML5: Supported natively through the Basilisk browser. Be sure to switch off Wine from the Config tab. To update Basilisk, download it from [http://us.basilisk-browser.org/release/basilisk-latest.linux64.tar.bz2 here] and extract it such that the executable is located at <code>FPSoftware/Basilisk-Portable/linux/basilisk</code>.
* Java Applets: Supported natively using the JDK.
* Java Applets: Supported natively using the JDK.

Revision as of 02:12, 30 July 2019

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support.

Latest Build

Download: https://unstable.life/owncloud/s/yCMzbOVV0uvOZ4X

  • This is the latest experimental build of Flashpoint Infinity for Linux, created on July 19, 2019.

Installation instructions:

  1. Download and extract the .tar.gz file.
  2. Install PHP and Wine if you do not have them. You'll need to follow distro-specific instructions if you have Ubuntu or Debian.
  3. Run the Flashpoint shortcut.
  4. Click the Config tab and check the "Use Wine" box if unchecked.

Major changes:

  • Configure Flash games to run using the Windows player, flashplayer_32_sa.exe
    • The Linux flash player suffers from too many graphical glitches
    • Requires Wine to be installed and enabled to play
  • Updated JDK to version 8u212
    • startJava.sh instructions and script updated
    • Made startJava.sh executable
  • Added support for Authorware Platform
    • See Authorware.xml
  • Adds Linux versions of the Save Manager scripts
  • Adds a "Flashpoint" shortcut (replacing the Windows version)
  • Adds Infinity 6.1 logos

To-Do List

  • Add the new SPR version
  • Update Shockwave.xml so SPR launch commands use --port 22500
  • Ensure the Theatre XMLs are fully updated for Linux support

Technologies

Currently, only Flashpoint Infinity is available for Linux. Like its Windows counterpart, it uses router.php as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the Flashpoint Redirector is used. On Windows, the HTTP *system proxy* is set to localhost:8888, and the *Redirector* forwards traffic to port 22500 if it originates from one of Flashpoint's applications. On Linux, each application is simply told to use localhost:22500 as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the http_proxy environment variable to http://localhost:22500/.

When Flashpoint is updated, each Platform XML must be updated. The Data/Images folder also needs to be updated with the images from the new build, or logos will not be visible for the newly added games. This zip contains all of the Platform XMLs in Flashpoint 6.1. It should be extracted Flashpoint's Data/Platforms folder.

The Flashpoint FAQ contains a list of all web game technologies ("Platforms") supported in the Windows version of Flashpoint. The Linux version currently supports a subset of these platforms. This is explained in detail below.

  • Flash: Supported through Wine by default. Although a Linux Flash Projector exists, it suffers from graphical glitches on many systems. If you'd like to try your luck with the native projector, open Flash.xml in a text editor, then replace each instance of FPSoftware/flashplayer_32_sa.exe with FPSoftware/Flash/linux/flashplayer32SA (the path to the Linux projector). Finally, click the Config tab and uncheck "Use Wine" if it is checked.
  • Shockwave: supported through Wine, but only locally. Any games that use Shockwave Projector Redirector (SPR) will not work. This is because SPR is hardcoded to use proxy port 8888. However, a new version of SPR with a user-configurable port number has just been released. It needs to be added to the Linux build and tested.
  • HTML5: Supported natively through the Basilisk browser. Be sure to switch off Wine from the Config tab. To update Basilisk, download it from here and extract it such that the executable is located at FPSoftware/Basilisk-Portable/linux/basilisk.
  • Java Applets: Supported natively using the JDK.
  • Unity Web Player: Supported through Wine.
  • PopCap Plugin: Supported through Wine.
  • Authorware Web Player: Supported through Wine.
  • Silverlight: Not supported. In the past, Pipelight allowed Linux users to use Silverlight, but the repository is no longer available for most Linux distros. Moonlight was another option, but is also no longer available. Attempts to use Silverlight in K-Meleon using Wine have failed.
  • 3DVIA Player: Not supported. A previous tester received this error, which crashed K-Meleon: Error: Access was denied while trying to open files in your profile directory. We need another tester to help us narrow this down.
  • 3D Groove GX: Not supported. When the http_proxy variable is set, Groove Player downloads but fails to load the file. Maybe the registry method described here would work better, but this needs to be tested. Two of our testers received the following set of errors: 1 2 3
  • ActiveX: Not supported. The most promising method so far was to install Internet Explorer 8 and each ActiveX plugin into the Wine prefix, but this needs considerable work.

Launcher Issues

A lot of work has been done to allow Flashpoint Launcher to support Linux, but there's a lot of room for improvement. This Trello post outlines some potential improvements.

Additional startup checks in the launcher could also benefit Linux (and Windows) users. For example, the launcher could check whether PHP and Wine are installed. This Trello post makes this suggestion.

The launcher also has issues escaping special characters on Linux. This is detailed here.