Linux Support

From Flashpoint Datahub
Revision as of 10:16, 16 July 2019 by Nosamu (talk | contribs) (Added more detail about updating the Platform XMLs)
Jump to navigation Jump to search

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/XNPjEWguzICoDRE

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

Installation instructions:

  1. Download and extract the .tar.gz file.
  2. Install PHP and Wine if you do not have them.
  3. Run the Flashpoint Launcher executable.
  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 suffered 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

To-Do List

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. A version that uses port 22500 should be released soon.
  • HTML5: Supported natively through the Basilisk browser. Be sure to switch off Wine from the Config tab. Download Basilisk from here and extract it such that the executable is located at FPSoftware/Basilisk-Portable/linux/basilisk. In subsequent versions, Basilisk should be included in the build, and the HTML5 XMLs should be modified to point to it.
  • 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. We need someone to help us test Pipelight (a Silverlight replacement for Linux) by following this guide.
  • 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.

XMLs

https://unstable.life/Flashpoint/Data/Platforms/Flash.xml
https://unstable.life/Flashpoint/Data/Platforms/Shockwave.xml
https://unstable.life/Flashpoint/Data/Platforms/HTML5.xml
https://unstable.life/Flashpoint/Data/Platforms/3DVIA Player.xml
https://unstable.life/Flashpoint/Data/Platforms/3D Groove GX.xml
https://unstable.life/Flashpoint/Data/Platforms/ActiveX.xml
https://unstable.life/Flashpoint/Data/Platforms/Authorware.xml
https://unstable.life/Flashpoint/Data/Platforms/Java.xml
https://unstable.life/Flashpoint/Data/Platforms/Silverlight.xml
https://unstable.life/Flashpoint/Data/Platforms/Unity.xml

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.

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