Flashpoint Datahub - User contributions [en]

Linux Support

2022-10-08T16:37:03Z

Ardil: Clarify docker install instructions, since rootless mode is now a thing.

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

As it stands, the Docker version of Flashpoint for Linux supports Flash, HTML5, Shockwave, Unity and Java. The exceptions are content that uses the Chromium browser, and Shockwave content that plays in-browser.
If you want support for the other platforms that are Windows-exclusive, there are a few options to get the Windows version of Flashpoint running on Linux:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is the recommended non-native option.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.

Otherwise, download the [https://drive.google.com/file/d/1zgBrmyiMpSfW9xsZ9A4ejvR0lktWlTRR/view?usp=sharing latest Docker Flashpoint package] and [[#Manual Installation|install it]].

== Manual Installation ==

=== Dependencies ===
First, install Flashpoint's dependencies.
{| class="wikitable"
!colspan="9"|Dependency package names on various distros
|-
!Library/command name
!Docker
!PulseAudio*
!X11**
!XHost
!PHP
!bash
|-
!Debian-likea
|(see [https://docs.docker.com/engine/install/debian/ this page])
|pulseaudio
|xserver-xorg-core
|x11-xserver-utils
|php
|bash
|-
!Ubuntu-likeb
|(see [https://docs.docker.com/engine/install/ubuntu/ this page])
|pulseaudio
|xserver-xorg-core
|x11-xserver-utils
|php
|bash
|-
!Fedora-like
|(see [https://docs.docker.com/engine/install/fedora/ this page])
|pulseaudio
|xorg-x11-server-Xorg
|xhost
|php
|bash
|-
!Arch-likec
|docker
|pulseaudio
|xorg-server
|xorg-xhost
|php
|bash
|}
a : E.g. ChromeOS Terminal, MX Linux | b : E.g. Linux Mint, Pop!_OS, Zorin OS | c : E.g. Manjaro, SteamOS >=3.0

'''Note:''' Chances are that Docker and PHP will be the only packages that you'll need to install, as most distributions come with the rest of the packages already pre-installed.

* : PipeWire can also be used in place of PulseAudio by installing the <code>pipewire-pulse</code> package on Ubuntu-like and Arch-like distros, or <code>pipewire-pulseaudio</code> on Fedora-like distros. For Debian-like distros, see [https://wiki.debian.org/PipeWire#Using_as_a_substitute_for_PulseAudio.2FJACK.2FALSA this link].

** : X11 can also be used within Wayland by installing the <code>xwayland</code> package on Debian-like and Ubuntu-like distros, <code>xorg-x11-server-Xwayland</code> on Fedora-like distros, or <code>xorg-xwayland</code> on Arch-like distros.

To install them, use your distro's package manager:
{|class="wikitable"
!Distro
!Package manager install command
|-
!Debian-like
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Ubuntu-like
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Fedora-like
|<code>sudo dnf install {PACKAGE}</code>
|-
!Fedora-like (old)
|<code>sudo yum install {PACKAGE}</code>
|-
!Arch-like
|<code>sudo pacman -S {PACKAGE}</code>
|}
=== Installation ===
Before you start, you need to [https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user configure Docker to be managed by a non-root user], then reboot your computer.

If you have an Nvidia GPU and use a distro that isn't Arch-like, you will need to add Nvidia's repository and install the <code>nvidia-docker2</code> package. Follow the "Setting up NVIDIA Container Toolkit" instructions under the heading corresponding to your distro [https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html#docker here]. If you use an Arch-like distro, install either [https://aur.archlinux.org/packages/nvidia-container-toolkit <code>nvidia-container-toolkit</code>] or [https://aur.archlinux.org/packages/nvidia-docker <code>nvidia-docker</code>] from the AUR if you did or didn't already install Docker respectively.

Then, download the [https://drive.google.com/file/d/1zgBrmyiMpSfW9xsZ9A4ejvR0lktWlTRR/view?usp=sharing latest Docker Flashpoint package] if you haven't already and extract it somewhere.

Go to the place where you extracted it, and pull the docker images by running <code>./pull.sh</code>. They'll take ~3.5 GB.

Finally, run the <code>./flashpoint</code> executable script to start the launcher.

Config files can be found in <code>./LinuxConf/</code> and <code>./FPSoftware/FSPConfigs/</code>.

Save data is stored in <code>./SaveData</code>. Java save data isn't persistent, because there's no standardized location for it.

== Troubleshooting ==

=== proxy.sh: "Permission denied" error ===

Depending on your system's permissions, the <code>proxy.sh</code> script may throw a "permission denied" error in the launcher logs when launching a game, causing it to fail to start. To fix this, follow these steps:
# Close the Flashpoint launcher.
# Open <code>./LinuxConf/proxy.sh</code> in a text editor.
# Change <code>/var/lock/flashpoint-networking.lock</code> to <code>/tmp/flashpoint-networking.lock</code> and save the file.
# Relaunch Flashpoint.

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code> in the docker container.

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.

=== Supported Platforms ===
* 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, then tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser.
* Java Applets: Supported natively using the Oracle JDK.
* Unity Web Player: Supported through Pipelight.

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

Linux Support

2022-08-18T23:25:32Z

Ardil: Correct openjdk->oracle jdk

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

As it stands, the Docker version of Flashpoint for Linux supports Flash, HTML5, Shockwave, Unity and Java. The exceptions are content that uses the Chromium browser, and Shockwave content that plays in-browser.
If you want support for the other platforms that are Windows-exclusive, there are a few options to get the Windows version of Flashpoint running on Linux:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is the recommended non-native option.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.

Otherwise, download the [https://drive.google.com/file/d/1zgBrmyiMpSfW9xsZ9A4ejvR0lktWlTRR/view?usp=sharing latest Docker Flashpoint package] and [[#Manual Installation|install it]].

== Manual Installation ==

=== Dependencies ===
First, install Flashpoint's dependencies.
{| class="wikitable"
!colspan="9"|Dependency package names on various distros
|-
!Library/command name
!Docker
!PulseAudio*
!X11**
!PHP
!bash
|-
!Debian
|(see [https://docs.docker.com/engine/install/debian/ this page])
|pulseaudio
|xorg
|php
|bash
|-
!Ubuntu, Linux Mint
|(see [https://docs.docker.com/engine/install/ubuntu/ this page])
|pulseaudio
|xorg
|php
|bash
|-
!Fedora-like
|(see [https://docs.docker.com/engine/install/fedora/ this page])
|pulseaudio
|xorg-x11-server-Xorg
|php
|bash
|-
!Arch-like
|docker
|pulseaudio
|xorg-server
|php
|bash
|}

'''Note:''' Chances are that Docker and PHP will be the only packages that you'll need to install, as most distributions come with the rest of the packages already pre-installed.

* : PipeWire can also be used in place of PulseAudio by installing the <code>pipewire-pulse</code> package on Ubuntu-like and Arch-like distros. For Debian, see [https://wiki.debian.org/PipeWire#Using_as_a_substitute_for_PulseAudio.2FJACK.2FALSA this link].

** : X11 can also be used within Wayland by installing the <code>xwayland</code> package on Debian-like and Ubuntu-like distros, <code>xorg-x11-server-Xwayland</code> on Fedora-like distros, and <code>xorg-xwayland</code> on Arch-like distros.

To install them, use your distro's package manager:
{|class="wikitable"
!Distro
!Package manager install command
|-
!Debian
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Ubuntu, Linux Mint
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Fedora-like
|<code>sudo dnf install {PACKAGE}</code>
|-
!Fedora-like (old)
|<code>sudo yum install {PACKAGE}</code>
|-
!Arch-like
|<code>sudo pacman -S {PACKAGE}</code>
|}

=== Installation ===
Before you start, you need to [https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user configure Docker to run as a non-root user], then reboot your computer.

If you have an Nvidia GPU, you will need to add Nvidia's repository and install the <code>nvidia-docker2</code> package. Follow the "Setting up NVIDIA Container Toolkit" instructions under the heading corresponding to your distro [https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html#docker here].

Then, download the [https://drive.google.com/file/d/1zgBrmyiMpSfW9xsZ9A4ejvR0lktWlTRR/view?usp=sharing latest Docker Flashpoint package] if you haven't already and extract it somewhere.

Go to the place where you extracted it, and pull the docker images by running <code>./pull.sh</code>. They'll take ~3.5 GB.

Finally, run the <code>./flashpoint</code> executable script to start the launcher.

Config files can be found in <code>./LinuxConf/</code> and <code>./FPSoftware/FSPConfigs/</code>.

Save data is stored in <code>./SaveData</code>. Java save data isn't persistent, because there's no standardized location for it.

== Troubleshooting ==

=== proxy.sh: "Permission denied" error ===

Depending on your system's permissions, the <code>proxy.sh</code> script may throw a "permission denied" error in the launcher logs when launching a game, causing it to fail to start. To fix this, follow these steps:
# Close the Flashpoint launcher.
# Open <code>./LinuxConf/proxy.sh</code> in a text editor.
# Change <code>/var/lock/flashpoint-networking.lock</code> to <code>/tmp/flashpoint-networking.lock</code> and save the file.
# Relaunch Flashpoint.

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, it uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code> in the docker container.

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.

=== Supported Platforms ===
* 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, then tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser.
* Java Applets: Supported natively using the Oracle JDK.
* Unity Web Player: Supported through Pipelight.

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

Linux Support

2022-08-18T23:22:52Z

Ardil: Supported platforms cleanup, remove changelog.

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

As it stands, the Docker version of Flashpoint for Linux supports Flash, HTML5, Shockwave, Unity and Java. The exceptions are content that uses the Chromium browser, and Shockwave content that plays in-browser.
If you want support for the other platforms that are Windows-exclusive, there are a few options to get the Windows version of Flashpoint running on Linux:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is the recommended non-native option.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.

Otherwise, download the [https://drive.google.com/file/d/1zgBrmyiMpSfW9xsZ9A4ejvR0lktWlTRR/view?usp=sharing latest Docker Flashpoint package] and [[#Manual Installation|install it]].

== Manual Installation ==

=== Dependencies ===
First, install Flashpoint's dependencies.
{| class="wikitable"
!colspan="9"|Dependency package names on various distros
|-
!Library/command name
!Docker
!PulseAudio*
!X11**
!PHP
!bash
|-
!Debian
|(see [https://docs.docker.com/engine/install/debian/ this page])
|pulseaudio
|xorg
|php
|bash
|-
!Ubuntu, Linux Mint
|(see [https://docs.docker.com/engine/install/ubuntu/ this page])
|pulseaudio
|xorg
|php
|bash
|-
!Fedora-like
|(see [https://docs.docker.com/engine/install/fedora/ this page])
|pulseaudio
|xorg-x11-server-Xorg
|php
|bash
|-
!Arch-like
|docker
|pulseaudio
|xorg-server
|php
|bash
|}

'''Note:''' Chances are that Docker and PHP will be the only packages that you'll need to install, as most distributions come with the rest of the packages already pre-installed.

* : PipeWire can also be used in place of PulseAudio by installing the <code>pipewire-pulse</code> package on Ubuntu-like and Arch-like distros. For Debian, see [https://wiki.debian.org/PipeWire#Using_as_a_substitute_for_PulseAudio.2FJACK.2FALSA this link].

** : X11 can also be used within Wayland by installing the <code>xwayland</code> package on Debian-like and Ubuntu-like distros, <code>xorg-x11-server-Xwayland</code> on Fedora-like distros, and <code>xorg-xwayland</code> on Arch-like distros.

To install them, use your distro's package manager:
{|class="wikitable"
!Distro
!Package manager install command
|-
!Debian
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Ubuntu, Linux Mint
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Fedora-like
|<code>sudo dnf install {PACKAGE}</code>
|-
!Fedora-like (old)
|<code>sudo yum install {PACKAGE}</code>
|-
!Arch-like
|<code>sudo pacman -S {PACKAGE}</code>
|}

=== Installation ===
Before you start, you need to [https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user configure Docker to run as a non-root user], then reboot your computer.

If you have an Nvidia GPU, you will need to add Nvidia's repository and install the <code>nvidia-docker2</code> package. Follow the "Setting up NVIDIA Container Toolkit" instructions under the heading corresponding to your distro [https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html#docker here].

Then, download the [https://drive.google.com/file/d/1zgBrmyiMpSfW9xsZ9A4ejvR0lktWlTRR/view?usp=sharing latest Docker Flashpoint package] if you haven't already and extract it somewhere.

Go to the place where you extracted it, and pull the docker images by running <code>./pull.sh</code>. They'll take ~3.5 GB.

Finally, run the <code>./flashpoint</code> executable script to start the launcher.

Config files can be found in <code>./LinuxConf/</code> and <code>./FPSoftware/FSPConfigs/</code>.

Save data is stored in <code>./SaveData</code>. Java save data isn't persistent, because there's no standardized location for it.

== Troubleshooting ==

=== proxy.sh: "Permission denied" error ===

Depending on your system's permissions, the <code>proxy.sh</code> script may throw a "permission denied" error in the launcher logs when launching a game, causing it to fail to start. To fix this, follow these steps:
# Close the Flashpoint launcher.
# Open <code>./LinuxConf/proxy.sh</code> in a text editor.
# Change <code>/var/lock/flashpoint-networking.lock</code> to <code>/tmp/flashpoint-networking.lock</code> and save the file.
# Relaunch Flashpoint.

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, it uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code> in the docker container.

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.

=== Supported Platforms ===
* 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, then tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser.
* Java Applets: Supported natively using the OpenJDK.
* Unity Web Player: Supported through Pipelight.

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

Linux Support

2022-08-18T22:56:27Z

Ardil: /* Troubleshooting */ Remove outdated issues.

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

As it stands, the Docker version of Flashpoint for Linux supports Flash, HTML5, Shockwave, Unity and Java. The exceptions are content that uses the Chromium browser, and Shockwave content that plays in-browser.
If you want support for the other platforms that are Windows-exclusive, there are a few options to get the Windows version of Flashpoint running on Linux:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is the recommended non-native option.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.

Otherwise, download the [https://drive.google.com/file/d/1zgBrmyiMpSfW9xsZ9A4ejvR0lktWlTRR/view?usp=sharing latest Docker Flashpoint package] and [[#Manual Installation|install it]].

== Manual Installation ==

=== Dependencies ===
First, install Flashpoint's dependencies.
{| class="wikitable"
!colspan="9"|Dependency package names on various distros
|-
!Library/command name
!Docker
!PulseAudio*
!X11**
!PHP
!bash
|-
!Debian
|(see [https://docs.docker.com/engine/install/debian/ this page])
|pulseaudio
|xorg
|php
|bash
|-
!Ubuntu, Linux Mint
|(see [https://docs.docker.com/engine/install/ubuntu/ this page])
|pulseaudio
|xorg
|php
|bash
|-
!Fedora-like
|(see [https://docs.docker.com/engine/install/fedora/ this page])
|pulseaudio
|xorg-x11-server-Xorg
|php
|bash
|-
!Arch-like
|docker
|pulseaudio
|xorg-server
|php
|bash
|}

'''Note:''' Chances are that Docker and PHP will be the only packages that you'll need to install, as most distributions come with the rest of the packages already pre-installed.

* : PipeWire can also be used in place of PulseAudio by installing the <code>pipewire-pulse</code> package on Ubuntu-like and Arch-like distros. For Debian, see [https://wiki.debian.org/PipeWire#Using_as_a_substitute_for_PulseAudio.2FJACK.2FALSA this link].

** : X11 can also be used within Wayland by installing the <code>xwayland</code> package on Debian-like and Ubuntu-like distros, <code>xorg-x11-server-Xwayland</code> on Fedora-like distros, and <code>xorg-xwayland</code> on Arch-like distros.

To install them, use your distro's package manager:
{|class="wikitable"
!Distro
!Package manager install command
|-
!Debian
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Ubuntu, Linux Mint
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Fedora-like
|<code>sudo dnf install {PACKAGE}</code>
|-
!Fedora-like (old)
|<code>sudo yum install {PACKAGE}</code>
|-
!Arch-like
|<code>sudo pacman -S {PACKAGE}</code>
|}

=== Installation ===
Before you start, you need to [https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user configure Docker to run as a non-root user], then reboot your computer.

If you have an Nvidia GPU, you will need to add Nvidia's repository and install the <code>nvidia-docker2</code> package. Follow the "Setting up NVIDIA Container Toolkit" instructions under the heading corresponding to your distro [https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html#docker here].

Then, download the [https://drive.google.com/file/d/1zgBrmyiMpSfW9xsZ9A4ejvR0lktWlTRR/view?usp=sharing latest Docker Flashpoint package] if you haven't already and extract it somewhere.

Go to the place where you extracted it, and pull the docker images by running <code>./pull.sh</code>. They'll take ~3.5 GB.

Finally, run the <code>./flashpoint</code> executable script to start the launcher.

Config files can be found in <code>./LinuxConf/</code> and <code>./FPSoftware/FSPConfigs/</code>.

Save data is stored in <code>./SaveData</code>. Java save data isn't persistent, because there's no standardized location for it.

== Troubleshooting ==

=== proxy.sh: "Permission denied" error ===

Depending on your system's permissions, the <code>proxy.sh</code> script may throw a "permission denied" error in the launcher logs when launching a game, causing it to fail to start. To fix this, follow these steps:
# Close the Flashpoint launcher.
# Open <code>./LinuxConf/proxy.sh</code> in a text editor.
# Change <code>/var/lock/flashpoint-networking.lock</code> to <code>/tmp/flashpoint-networking.lock</code> and save the file.
# Relaunch Flashpoint.

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, it uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code>.

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.

=== Supported Platforms ===
* 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, then either turn off use Wine, or tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser. 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>. By default, Basilisk will store its configuration in the location defined by <code>XDG_CONFIG_DIR</code>, so Flashpoint uses a shell script to set the configuration location. A pre-configured copy of Basilisk, along with the shell script, is packaged and also available [https://drive.google.com/file/d/1Y5Mgm9dCa4gCc6UF5WFPqQruzsO81xhf/view?usp=sharing here]. This [https://cdn.discordapp.com/attachments/516027726851735632/612891261665411073/BasiliskSetup.txt text file] describes Basilisk's configuration.
* Java Applets: Supported natively using the OpenJDK. This support is not currently working, however.
* Unity Web Player: Supported through Wine. Unity 2.x and 3.x games may not work; this needs further testing.
* PopCap Plugin: Supported through Wine.
* Authorware Web Player: Supported through Wine.
* GoBit Plugin: Supported through Wine.

=== Unsupported Platforms ===
* Silverlight: In the past, [http://www.webupd8.org/2013/08/pipelight-use-silverlight-in-your-linux.html Pipelight] allowed Linux users to use Silverlight, but the repository is no longer available for most Linux distros. [https://www.maketecheasier.com/install-and-run-silverlight-in-linux/ Moonlight] was another option, but is also no longer available. Attempts to use Silverlight in K-Meleon using Wine have failed.
* 3DVIA Player: A previous tester received this error, which crashed K-Meleon: <code>Error: Access was denied while trying to open files in your profile directory</code>. We need another tester to help us narrow this down.
* 3D Groove GX: When the http_proxy variable is set, Groove Player downloads but fails to load the file. Maybe the registry method described [https://wiki.winehq.org/FAQ#How_do_I_configure_a_proxy.3F here] would work better, but this needs to be tested. Two of our testers received the following set of errors: [https://media.discordapp.net/attachments/496132309498724391/577330595609444352/unknown.png 1] [https://media.discordapp.net/attachments/496132309498724391/577330680678055948/unknown.png 2] [https://media.discordapp.net/attachments/496132309498724391/577330740396556309/unknown.png 3]
* ActiveX: 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.

== Wine ==
Most games rely on technology only available on Windows. A lot of these however can be run through Wine. If there is no native executable, or you have the Native Platform option unticked for the game's platform then the launcher will run it through Wine.

You may choose to use the native versions, in which case tick the platform under Native Platforms in Config.

If you wish to play games that rely on Wine, be sure to install the 32-bit version of Wine. There are links below to distro specific install guides:

* Ubuntu - https://wiki.winehq.org/Ubuntu
* Debian - https://wiki.debian.org/Wine#Installation_on_Debian_Jessie_and_newer
* Arch Linux - https://wiki.archlinux.org/index.php/Wine#Installation

=== Important Note ===

Update: As of Wine 6.0-rc1, Shockwave appears to be working again. If you are on 5.22, keep an eye out for an update from your distribution.

<s>As of Wine 5.22, the Shockwave wrappers are no longer launching. Avoid updating Wine until a fix is found.</s>

== Changelog ==

; 2021-07-26
: Added 10.0 Infinity package

; 2021-02-16
: Added Core/Ultimate standalone package for 9.0 based on 8.1 Infinity standalone

; 2020-11-07
: Updated .deb to Flashpoint 8.2-2 Infinity
: Added native executables for Flash and HTML5
: Replaced modified Flash Projectors with the unmodified ones
: Fixed extreme games option being disabled in config.json

; 2020-10-23
: Updated .deb to Flashpoint 8.2-1 Infinity

; 2020-07-04
: Updated to Flashpoint 8.1 Infinity
: Updated to Flashpoint Launcher 9.0.2

; 2019-09-28
: Updated to Flashpoint 6.3
: Bundled WIP Launcher with better Multi-Platform Support:
:* Proper linux argument escaping (Supersonic RC works now, yay!)
:* SPR games automatically use port 22500 (Hacky, may be removed later)
:* Wine will always (and only) be used for running .exe files (even if use Wine is turned off in Config)
:* .bat files will always run their .sh equivalents (even if use Wine is turned on in Config)
:* Windows execs are mapped to native execs (if existing), so Windows game XMLs should work out the box. (See execs.json)
:* Can mark a platform as 'native' in Config, will force native execs to be used instead of Windows execs even if use Wine is turned on.
:** If no native execs are available (like Shockwave) then it will fallback to running the Windows exec with Wine.
: Added native Basilisk support files
: Updated SPR files
: Updated router.php

; 2019-09-18
: Added new SPR version (see update-spr.sh) and Shockwave XMLs
: Added interim Launcher hack to make Shockwave games that use SPR work properly
: Made the save manager scripts use a valid interpreter (/bin/sh)
:* TODO: they still need further work/testing

; 2019-07-21 and prior
: 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
: Adds Linux versions of the Save Manager scripts
: Adds a "Flashpoint" shortcut (replacing the Windows version)
: Adds Flashpoint 6.2 games
: Removed the game logos, as in Flashpoint Infinity 6.2 for Windows
: Removed the Wineprefix because it was not used

'''To-Do List'''
* Allow the launcher to automatically start/stop the flashpoint server on Linux
* Rewrite and test startUnity.sh and startJava.sh scripts
* Find a way to get Basilisk working better in Wine, or use an alternative browser like K-Meleon
* Get Java working natively again with OpenJDK 8
* Test Unity 2.x and 3.x games
* AMF support for games like Neon Rider for the community levels

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

Help Wanted List

2022-08-06T16:43:08Z

Ardil: Remove trello link, referring them to the repo is good enough.

# '''Help developing a system for automated Flashpoint builds''': Currently, every build of Flashpoint is created on BlueMaxima's computer using his master copy. To improve release quality and frequency, we need an automated way to build Flashpoint, including Windows and Linux builds. If you have knowledge of Linux and Git, and preferably CI/CD skills, please join the #development-chat channel in [http://discord.gg/S9uJ794 our Discord] and let us know that you'd like to help! We're also looking for people with experience with automation tools such as Salt, Ansible or Chef.
# '''Linux testers and developers''': We are unable to offer an official Linux version of Flashpoint due to a lack of maintainers. We hope to once again offer an official Linux version, but we need help finalizing our experimental builds. For more information and the latest download links, see [[Linux Support]]. Please join [http://discord.gg/S9uJ794 our Discord], and let us know in #development-chat what's working and what isn't. We are also looking for help developing the build further.
# '''Mac testers and developers''': A heavily experimental package of Flashpoint for Mac is available, but we need help fixing a lot of Launcher issues before we can offer an official version. None of our Launcher developers currently have access to a Mac, so we need someone to help us solve Mac-specific issues with the launcher. To download the latest package and get started, see [[Mac Support]].
# '''Flashpoint Launcher developers''': We use a custom Electron app called Flashpoint Launcher for displaying and launching games in Flashpoint. We need some more help with its development.
#* See the GitHub repository for more info: https://github.com/FlashpointProject/launcher
#* Skills needed: proficiency with Electron and TypeScript
# '''Flashpoint Launcher extension developers''': We are looking for developers to help develop new features for the Flashpoint project through launcher extensions. To learn more about creating launcher extensions, see the [https://github.com/FlashpointProject/launcher/blob/master/docs/extensions.md extension documentation] and the [https://flashpointproject.github.io/launcher_ApiDocs/modules/_typings_flashpoint_launcher_d_._flashpoint_launcher_.html API documentation].
#* See [[Launcher Extensions]] for some examples of useful launcher extensions.
#* One idea we have for a future extension is one that detects common error conditions (such as <code>router.php</code> being deleted by antivirus), alerts the user to the problem, and provides the user with instructions to fix the problem. Work on this extension has been started but is unfinished; the code is [https://github.com/FlashpointProject/Troubleshooter available here]. If you're interested in working on the extension, please join our Discord and let us know!
# '''Flashpoint Launcher translators''': One great way to help us reach more people is localizing Flashpoint Launcher into your language. See [[Translation Guide]] for more details on how to translate.
# '''Help with XML-RPC games''': some Adobe Flash games use XML remote procedure calls for some of their functionality. We need help coding this functionality for each game that requires it, using Flashpoint’s PHP library. Here’s an example of how XML-RPC is used: https://help.adobe.com/en_US/as3/dev/WSb2ba3b1aad8a27b061afd5d7127074bbf44-7fff.html
# '''HTTPS support''': Some games have obfuscation or exact URL sitelocks that make them only work on HTTPS URLs. We would like to support HTTPS in Flashpoint without installing a root certificate on the user's system. We need someone to set up the Apache server to use HTTPS, generate an SSL root certificate (self-signed should be fine), and direct one of our portable browsers to trust this certificate on all sites. The Apache server should act as a proxy for HTTPS traffic and serve files from its htdocs folder, just as it does for HTTP traffic. Proposed solutions include:
## My plan for implementing it would be based on [https://github.com/mdn/webextensions-examples/tree/master/http-response this sample extension], and replace the response data outright with a version fetched over HTTP on certain URL match patterns. This is very similar to how I implemented [https://addons.mozilla.org/en-US/firefox/addon/annotationsreloaded/ AnnotationsReloaded].
##* <code>filterResponseData</code> was added in Firefox 57, though you could also restrict it on earlier versions in <code>manifest.json</code>.
##* Theoretically you could create a "fake domain" to store a configuration for this extension to be picked up by the proxy and then have the extension dynamically update its matched patterns every time the browser launches (<code>manifest.json</code> would not be able to be updated dynamically). This would require a browser based on Firefox 57+. You wouldn't even need to dynamically process the actual response, just overwrite it.
## Another potential solution would be something like [https://github.com/Rob--W/crxviewer/blob/master/src/domain-fronter.js this], which changes the URL of the request rather than modifying the response. It might perform better in terms of network requests, as they wouldn't be duplicated. I believe the domain fronter changes the URL back once the response is returned, so XHR would report the correct URL.
## Alternatively, given that [https://gitlab.fp.unstable.life/flashpoint/software/fpbrowser FPBrowser] is now hosted and compiled by us, we can probably redirect all the browser's HTTPS API calls to the HTTP ones.
# '''Help curating Pogo games''': Pogo.com is removing all of their Flash games. We need help from someone familiar with capturing network activity so that we can have a chance to save these games. If you or someone you know have this expertise, please let us know. Please join our efforts to archive these games at this Google doc link: https://docs.google.com/document/d/1PW58X2jfpt57Ce2fN4r4BXeALO0iW9o-r7-cYrI-w2A/edit. Also, We need help analyzing our packet captures and re-implementing enough of the server backend to make the single-player modes playable in Flashpoint.
# '''RTMP streaming support''': Some games use [https://en.wikipedia.org/wiki/Real-Time_Messaging_Protocol Real-Time Messaging Protocol] (RTMP) for streaming video or audio. We need help supporting this technology in Flashpoint.
#* Flash's RTMP connections appear to completely bypass the Redirector and standard browser developer tools. We need help figuring out how to force Flash Player's RTMP connections to go through Flashpoint's proxy.
#* Flashpoint's Apache/PHP server does not support RTMP, and according to this [https://en.wikipedia.org/wiki/List_of_RTMP_software#RTMP_server_software list of RTMP server software], there may not be any way to do so. We need help figuring out how to add support for RTMP to Flashpoint's server.
#* Using [http://rtmpdump.mplayerhq.hu/ RTMPDump], we can download the videos or audio streamed to a Flash game/movie. We need help figuring out which games in Flashpoint or elsewhere may be using RTMP, so we can download the media they depend on. The top priority should be checking games that are already in Flashpoint because we do not want to be unknowingly relying on external RTMP servers that may go offline at any time.
#* Here is an example of a game that uses RTMP for streaming video: [http://downloads.bbc.co.uk/tv/isite-flash/doctorwho/games/graske/geoip/bbc_drwho.swf Link], [https://cdn.discordapp.com/attachments/444854424515379201/620820731793768478/ATTACK_OF_THE_GRASKE.7z Curation]
# '''Help implementing Kongregate user content in Flashpoint''': [https://docs.google.com/spreadsheets/d/1OnnhmWgvljBZK4_oxoO6itpQWCddRc-usz5iPcrUvzU/edit This Google doc] lists all of the games on Kongregate for which we've scraped the user levels. We need help re-implementing the Kongregate API and possibly hacking the games so the user levels can be loaded in Flashpoint. It's especially complicated because games use HTTPS, and possible interactions between the games and the pages on which they're embedded.
# '''Moving content out of <samp>localflash</samp> and other local directories''': These directories are intended for Flash content and other platform content intended to be executed from the user's own computer rather than on a web page online. However, there still exists a large amount of online content in these directories even though it should not be. Assistance in moving this would be appreciated.
# '''Replacing games hacked to bypass sitelocks with unmodified versions''': This is a very low priority task, but would be desirable nonetheless. In its earlier years, certain games had to be directly modified as to bypass built-in sitelocks. However, as Flashpoint now has the ability to trick such games into believing they're being played online, this is no longer necessary. While there are no functional differences between a hacked game and a tricked unmodified game, having the original files would be preferable.
# '''[[Zipping Guide|ZIPping of legacy games]]''': Currently this task is locked to staff contributors. Games added prior to Flashpoint 10.0 still use the legacy system, rather than the newly-implemented gamezip system for compression. Moving games over to the new game zip system, preferably games which are particularly large or otherwise problematic, would be massively helpful for file sizes.
# '''Sorting of extreme tagged games''': Prior to Flashpoint 10, all extreme content was decided via a blanket on-off option. Flashpoint 10 introduced a tag system to allow more specific filtering of extreme content, but there still exists uncategorised content under the LEGACY-Extreme tag. Volunteers with a strong stomach may wish to assist in giving more descriptive NSFW tags,

== Former Projects: ==

# '''Help developing a curation submission website''': We introduced a new website to be used for submitting [[Curation_Format#What_is_a_Curation.3F|curations]]. The code is available from the [https://github.com/Dri0m/flashpoint-submission-system/ GitHub repository]. It is located at https://fpfss.unstable.life.
# '''Differential updates''': An updater for Flashpoint Ultimate has been released, and is [https://github.com/FlashpointProject/FlashpointUpdater/releases available here].
# '''Action Message Format support''': We finished adding an AMF implementation to PHP on Flashpoint's server, so now we are working to save user content databases for games that require AMF.
# '''Help curating Geocities.jp games''': Geocities.jp closed on March 31, 2019, and some of the games hosted there were lost forever. At Flashpoint, we worked to curate some of the games, and save the assets for as many as possible so they can be added to Flashpoint later.
# '''PHP script/library to read SWF headers''': Staff member XXLuigiMario created a PHP script that can read the width and height of any SWF, along with a userscript to call this PHP script whenever the browser loads an SWF. To see it in action, download his patches for Flashpoint [https://cdn.discordapp.com/attachments/569426826691346444/674753616002678793/Infinity7.1BasiliskPatch.7z Infinity] or [https://cdn.discordapp.com/attachments/569426826691346444/674745464683233337/Core4.1BasiliskPatch.7z Core].
# '''Portable Shockwave Player plugin''': We finished integrating a portable Shockwave Player plugin with Flashpoint, and it is available in current Flashpoint releases. This was accomplished using our [https://github.com/FlashpointProject/ShockwaveExtender/ Browser Plugin Extender] module.
# '''Hacking Unity Web Player games''': We discovered a viable method for hacking Unity Web Player games, the details of which have been [[Unity_Curation#Hacking_Unity_Web_Player_Games|shared here]].

'''See Also''': [[Help Wanted Games]]

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

Help Wanted List

2022-08-06T16:42:45Z

Ardil: Undo revision 8119 by Prostagma (talk)

# '''Help developing a system for automated Flashpoint builds''': Currently, every build of Flashpoint is created on BlueMaxima's computer using his master copy. To improve release quality and frequency, we need an automated way to build Flashpoint, including Windows and Linux builds. If you have knowledge of Linux and Git, and preferably CI/CD skills, please join the #development-chat channel in [http://discord.gg/S9uJ794 our Discord] and let us know that you'd like to help! We're also looking for people with experience with automation tools such as Salt, Ansible or Chef.
# '''Linux testers and developers''': We are unable to offer an official Linux version of Flashpoint due to a lack of maintainers. We hope to once again offer an official Linux version, but we need help finalizing our experimental builds. For more information and the latest download links, see [[Linux Support]]. Please join [http://discord.gg/S9uJ794 our Discord], and let us know in #development-chat what's working and what isn't. We are also looking for help developing the build further.
# '''Mac testers and developers''': A heavily experimental package of Flashpoint for Mac is available, but we need help fixing a lot of Launcher issues before we can offer an official version. None of our Launcher developers currently have access to a Mac, so we need someone to help us solve Mac-specific issues with the launcher. To download the latest package and get started, see [[Mac Support]].
# '''Flashpoint Launcher developers''': We use a custom Electron app called Flashpoint Launcher for displaying and launching games in Flashpoint. We need some more help with its development.
#* See the GitHub repository for more info: https://github.com/FlashpointProject/launcher
#* See the Trello board for some features we'd like implemented: https://trello.com/b/Tu9E5GLk/launcher
#* Skills needed: proficiency with Electron and TypeScript
# '''Flashpoint Launcher extension developers''': We are looking for developers to help develop new features for the Flashpoint project through launcher extensions. To learn more about creating launcher extensions, see the [https://github.com/FlashpointProject/launcher/blob/master/docs/extensions.md extension documentation] and the [https://flashpointproject.github.io/launcher_ApiDocs/modules/_typings_flashpoint_launcher_d_._flashpoint_launcher_.html API documentation].
#* See [[Launcher Extensions]] for some examples of useful launcher extensions.
#* One idea we have for a future extension is one that detects common error conditions (such as <code>router.php</code> being deleted by antivirus), alerts the user to the problem, and provides the user with instructions to fix the problem. Work on this extension has been started but is unfinished; the code is [https://github.com/FlashpointProject/Troubleshooter available here]. If you're interested in working on the extension, please join our Discord and let us know!
# '''Flashpoint Launcher translators''': One great way to help us reach more people is localizing Flashpoint Launcher into your language. See [[Translation Guide]] for more details on how to translate.
# '''Help with XML-RPC games''': some Adobe Flash games use XML remote procedure calls for some of their functionality. We need help coding this functionality for each game that requires it, using Flashpoint’s PHP library. Here’s an example of how XML-RPC is used: https://help.adobe.com/en_US/as3/dev/WSb2ba3b1aad8a27b061afd5d7127074bbf44-7fff.html
# '''HTTPS support''': Some games have obfuscation or exact URL sitelocks that make them only work on HTTPS URLs. We would like to support HTTPS in Flashpoint without installing a root certificate on the user's system. We need someone to set up the Apache server to use HTTPS, generate an SSL root certificate (self-signed should be fine), and direct one of our portable browsers to trust this certificate on all sites. The Apache server should act as a proxy for HTTPS traffic and serve files from its htdocs folder, just as it does for HTTP traffic. Proposed solutions include:
## My plan for implementing it would be based on [https://github.com/mdn/webextensions-examples/tree/master/http-response this sample extension], and replace the response data outright with a version fetched over HTTP on certain URL match patterns. This is very similar to how I implemented [https://addons.mozilla.org/en-US/firefox/addon/annotationsreloaded/ AnnotationsReloaded].
##* <code>filterResponseData</code> was added in Firefox 57, though you could also restrict it on earlier versions in <code>manifest.json</code>.
##* Theoretically you could create a "fake domain" to store a configuration for this extension to be picked up by the proxy and then have the extension dynamically update its matched patterns every time the browser launches (<code>manifest.json</code> would not be able to be updated dynamically). This would require a browser based on Firefox 57+. You wouldn't even need to dynamically process the actual response, just overwrite it.
## Another potential solution would be something like [https://github.com/Rob--W/crxviewer/blob/master/src/domain-fronter.js this], which changes the URL of the request rather than modifying the response. It might perform better in terms of network requests, as they wouldn't be duplicated. I believe the domain fronter changes the URL back once the response is returned, so XHR would report the correct URL.
## Alternatively, given that [https://gitlab.fp.unstable.life/flashpoint/software/fpbrowser FPBrowser] is now hosted and compiled by us, we can probably redirect all the browser's HTTPS API calls to the HTTP ones.
# '''Help curating Pogo games''': Pogo.com is removing all of their Flash games. We need help from someone familiar with capturing network activity so that we can have a chance to save these games. If you or someone you know have this expertise, please let us know. Please join our efforts to archive these games at this Google doc link: https://docs.google.com/document/d/1PW58X2jfpt57Ce2fN4r4BXeALO0iW9o-r7-cYrI-w2A/edit. Also, We need help analyzing our packet captures and re-implementing enough of the server backend to make the single-player modes playable in Flashpoint.
# '''RTMP streaming support''': Some games use [https://en.wikipedia.org/wiki/Real-Time_Messaging_Protocol Real-Time Messaging Protocol] (RTMP) for streaming video or audio. We need help supporting this technology in Flashpoint.
#* Flash's RTMP connections appear to completely bypass the Redirector and standard browser developer tools. We need help figuring out how to force Flash Player's RTMP connections to go through Flashpoint's proxy.
#* Flashpoint's Apache/PHP server does not support RTMP, and according to this [https://en.wikipedia.org/wiki/List_of_RTMP_software#RTMP_server_software list of RTMP server software], there may not be any way to do so. We need help figuring out how to add support for RTMP to Flashpoint's server.
#* Using [http://rtmpdump.mplayerhq.hu/ RTMPDump], we can download the videos or audio streamed to a Flash game/movie. We need help figuring out which games in Flashpoint or elsewhere may be using RTMP, so we can download the media they depend on. The top priority should be checking games that are already in Flashpoint because we do not want to be unknowingly relying on external RTMP servers that may go offline at any time.
#* Here is an example of a game that uses RTMP for streaming video: [http://downloads.bbc.co.uk/tv/isite-flash/doctorwho/games/graske/geoip/bbc_drwho.swf Link], [https://cdn.discordapp.com/attachments/444854424515379201/620820731793768478/ATTACK_OF_THE_GRASKE.7z Curation]
# '''Help implementing Kongregate user content in Flashpoint''': [https://docs.google.com/spreadsheets/d/1OnnhmWgvljBZK4_oxoO6itpQWCddRc-usz5iPcrUvzU/edit This Google doc] lists all of the games on Kongregate for which we've scraped the user levels. We need help re-implementing the Kongregate API and possibly hacking the games so the user levels can be loaded in Flashpoint. It's especially complicated because games use HTTPS, and possible interactions between the games and the pages on which they're embedded.
# '''Moving content out of <samp>localflash</samp> and other local directories''': These directories are intended for Flash content and other platform content intended to be executed from the user's own computer rather than on a web page online. However, there still exists a large amount of online content in these directories even though it should not be. Assistance in moving this would be appreciated.
# '''Replacing games hacked to bypass sitelocks with unmodified versions''': This is a very low priority task, but would be desirable nonetheless. In its earlier years, certain games had to be directly modified as to bypass built-in sitelocks. However, as Flashpoint now has the ability to trick such games into believing they're being played online, this is no longer necessary. While there are no functional differences between a hacked game and a tricked unmodified game, having the original files would be preferable.
# '''[[Zipping Guide|ZIPping of legacy games]]''': Currently this task is locked to staff contributors. Games added prior to Flashpoint 10.0 still use the legacy system, rather than the newly-implemented gamezip system for compression. Moving games over to the new game zip system, preferably games which are particularly large or otherwise problematic, would be massively helpful for file sizes.
# '''Sorting of extreme tagged games''': Prior to Flashpoint 10, all extreme content was decided via a blanket on-off option. Flashpoint 10 introduced a tag system to allow more specific filtering of extreme content, but there still exists uncategorised content under the LEGACY-Extreme tag. Volunteers with a strong stomach may wish to assist in giving more descriptive NSFW tags,

== Former Projects: ==

# '''Help developing a curation submission website''': We introduced a new website to be used for submitting [[Curation_Format#What_is_a_Curation.3F|curations]]. The code is available from the [https://github.com/Dri0m/flashpoint-submission-system/ GitHub repository]. It is located at https://fpfss.unstable.life.
# '''Differential updates''': An updater for Flashpoint Ultimate has been released, and is [https://github.com/FlashpointProject/FlashpointUpdater/releases available here].
# '''Action Message Format support''': We finished adding an AMF implementation to PHP on Flashpoint's server, so now we are working to save user content databases for games that require AMF.
# '''Help curating Geocities.jp games''': Geocities.jp closed on March 31, 2019, and some of the games hosted there were lost forever. At Flashpoint, we worked to curate some of the games, and save the assets for as many as possible so they can be added to Flashpoint later.
# '''PHP script/library to read SWF headers''': Staff member XXLuigiMario created a PHP script that can read the width and height of any SWF, along with a userscript to call this PHP script whenever the browser loads an SWF. To see it in action, download his patches for Flashpoint [https://cdn.discordapp.com/attachments/569426826691346444/674753616002678793/Infinity7.1BasiliskPatch.7z Infinity] or [https://cdn.discordapp.com/attachments/569426826691346444/674745464683233337/Core4.1BasiliskPatch.7z Core].
# '''Portable Shockwave Player plugin''': We finished integrating a portable Shockwave Player plugin with Flashpoint, and it is available in current Flashpoint releases. This was accomplished using our [https://github.com/FlashpointProject/ShockwaveExtender/ Browser Plugin Extender] module.
# '''Hacking Unity Web Player games''': We discovered a viable method for hacking Unity Web Player games, the details of which have been [[Unity_Curation#Hacking_Unity_Web_Player_Games|shared here]].

'''See Also''': [[Help Wanted Games]]

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

Help Wanted List

2022-05-14T01:21:03Z

Ardil: Add another https idea.

# '''Help developing a system for automated Flashpoint builds''': Currently, every build of Flashpoint is created on BlueMaxima's computer using his master copy. To improve release quality and frequency, we need an automated way to build Flashpoint, including Windows and Linux builds. If you have knowledge of Linux and Git, and preferably CI/CD skills, please join the #development-chat channel in [http://discord.gg/S9uJ794 our Discord] and let us know that you'd like to help! We're also looking for people with experience with automation tools such as Salt, Ansible or Chef.
# '''Linux testers and developers''': We are unable to offer an official Linux version of Flashpoint due to a lack of maintainers. We hope to once again offer an official Linux version, but we need help finalizing our experimental builds. For more information and the latest download links, see [[Linux Support]]. Please join [http://discord.gg/S9uJ794 our Discord], and let us know in #development-chat what's working and what isn't. We are also looking for help developing the build further.
# '''Mac testers and developers''': A heavily experimental package of Flashpoint for Mac is available, but we need help fixing a lot of Launcher issues before we can offer an official version. None of our Launcher developers currently have access to a Mac, so we need someone to help us solve Mac-specific issues with the launcher. To download the latest package and get started, see [[Mac Support]].
# '''Flashpoint Launcher developers''': We use a custom Electron app called Flashpoint Launcher for displaying and launching games in Flashpoint. We need some more help with its development.
#* See the GitHub repository for more info: https://github.com/FlashpointProject/launcher
#* See the Trello board for some features we'd like implemented: https://trello.com/b/Tu9E5GLk/launcher
#* Skills needed: proficiency with Electron and TypeScript
# '''Flashpoint Launcher extension developers''': We are looking for developers to help develop new features for the Flashpoint project through launcher extensions. To learn more about creating launcher extensions, see the [https://github.com/FlashpointProject/launcher/blob/master/docs/extensions.md extension documentation] and the [https://flashpointproject.github.io/launcher_ApiDocs/modules/_typings_flashpoint_launcher_d_._flashpoint_launcher_.html API documentation].
#* See [[Launcher Extensions]] for some examples of useful launcher extensions.
#* One idea we have for a future extension is one that detects common error conditions (such as <code>router.php</code> being deleted by antivirus), alerts the user to the problem, and provides the user with instructions to fix the problem. Work on this extension has been started but is unfinished; the code is [https://github.com/FlashpointProject/Troubleshooter available here]. If you're interested in working on the extension, please join our Discord and let us know!
# '''Flashpoint Launcher translators''': One great way to help us reach more people is localizing Flashpoint Launcher into your language. See [[Translation Guide]] for more details on how to translate.
# '''Help with XML-RPC games''': some Adobe Flash games use XML remote procedure calls for some of their functionality. We need help coding this functionality for each game that requires it, using Flashpoint’s PHP library. Here’s an example of how XML-RPC is used: https://help.adobe.com/en_US/as3/dev/WSb2ba3b1aad8a27b061afd5d7127074bbf44-7fff.html
# '''HTTPS support''': Some games have obfuscation or exact URL sitelocks that make them only work on HTTPS URLs. We would like to support HTTPS in Flashpoint without installing a root certificate on the user's system. We need someone to set up the Apache server to use HTTPS, generate an SSL root certificate (self-signed should be fine), and direct one of our portable browsers to trust this certificate on all sites. The Apache server should act as a proxy for HTTPS traffic and serve files from its htdocs folder, just as it does for HTTP traffic. Proposed solutions include:
## My plan for implementing it would be based on [https://github.com/mdn/webextensions-examples/tree/master/http-response this sample extension], and replace the response data outright with a version fetched over HTTP on certain URL match patterns. This is very similar to how I implemented [https://addons.mozilla.org/en-US/firefox/addon/annotationsreloaded/ AnnotationsReloaded].
##* <code>filterResponseData</code> was added in Firefox 57, though you could also restrict it on earlier versions in <code>manifest.json</code>.
##* Theoretically you could create a "fake domain" to store a configuration for this extension to be picked up by the proxy and then have the extension dynamically update its matched patterns every time the browser launches (<code>manifest.json</code> would not be able to be updated dynamically). This would require a browser based on Firefox 57+. You wouldn't even need to dynamically process the actual response, just overwrite it.
## Another potential solution would be something like [https://github.com/Rob--W/crxviewer/blob/master/src/domain-fronter.js this], which changes the URL of the request rather than modifying the response. It might perform better in terms of network requests, as they wouldn't be duplicated. I believe the domain fronter changes the URL back once the response is returned, so XHR would report the correct URL.
## Alternatively, given that [https://gitlab.fp.unstable.life/flashpoint/software/fpbrowser FPBrowser] is now hosted and compiled by us, we can probably redirect all the browser's HTTPS API calls to the HTTP ones.
# '''Help curating Pogo games''': Pogo.com is removing all of their Flash games. We need help from someone familiar with capturing network activity so that we can have a chance to save these games. If you or someone you know have this expertise, please let us know. Please join our efforts to archive these games at this Google doc link: https://docs.google.com/document/d/1PW58X2jfpt57Ce2fN4r4BXeALO0iW9o-r7-cYrI-w2A/edit. Also, We need help analyzing our packet captures and re-implementing enough of the server backend to make the single-player modes playable in Flashpoint.
# '''RTMP streaming support''': Some games use [https://en.wikipedia.org/wiki/Real-Time_Messaging_Protocol Real-Time Messaging Protocol] (RTMP) for streaming video or audio. We need help supporting this technology in Flashpoint.
#* Flash's RTMP connections appear to completely bypass the Redirector and standard browser developer tools. We need help figuring out how to force Flash Player's RTMP connections to go through Flashpoint's proxy.
#* Flashpoint's Apache/PHP server does not support RTMP, and according to this [https://en.wikipedia.org/wiki/List_of_RTMP_software#RTMP_server_software list of RTMP server software], there may not be any way to do so. We need help figuring out how to add support for RTMP to Flashpoint's server.
#* Using [http://rtmpdump.mplayerhq.hu/ RTMPDump], we can download the videos or audio streamed to a Flash game/movie. We need help figuring out which games in Flashpoint or elsewhere may be using RTMP, so we can download the media they depend on. The top priority should be checking games that are already in Flashpoint because we do not want to be unknowingly relying on external RTMP servers that may go offline at any time.
#* Here is an example of a game that uses RTMP for streaming video: [http://downloads.bbc.co.uk/tv/isite-flash/doctorwho/games/graske/geoip/bbc_drwho.swf Link], [https://cdn.discordapp.com/attachments/444854424515379201/620820731793768478/ATTACK_OF_THE_GRASKE.7z Curation]
# '''Help implementing Kongregate user content in Flashpoint''': [https://docs.google.com/spreadsheets/d/1OnnhmWgvljBZK4_oxoO6itpQWCddRc-usz5iPcrUvzU/edit This Google doc] lists all of the games on Kongregate for which we've scraped the user levels. We need help re-implementing the Kongregate API and possibly hacking the games so the user levels can be loaded in Flashpoint. It's especially complicated because games use HTTPS, and possible interactions between the games and the pages on which they're embedded.
# '''Moving content out of <samp>localflash</samp> and other local directories''': These directories are intended for Flash content and other platform content intended to be executed from the user's own computer rather than on a web page online. However, there still exists a large amount of online content in these directories even though it should not be. Assistance in moving this would be appreciated.
# '''Replacing games hacked to bypass sitelocks with unmodified versions''': This is a very low priority task, but would be desirable nonetheless. In its earlier years, certain games had to be directly modified as to bypass built-in sitelocks. However, as Flashpoint now has the ability to trick such games into believing they're being played online, this is no longer necessary. While there are no functional differences between a hacked game and a tricked unmodified game, having the original files would be preferable.
# '''[[Zipping Guide|ZIPping of legacy games]]''': Currently this task is locked to staff contributors. Games added prior to Flashpoint 10.0 still use the legacy system, rather than the newly-implemented gamezip system for compression. Moving games over to the new game zip system, preferably games which are particularly large or otherwise problematic, would be massively helpful for file sizes.
# '''Sorting of extreme tagged games''': Prior to Flashpoint 10, all extreme content was decided via a blanket on-off option. Flashpoint 10 introduced a tag system to allow more specific filtering of extreme content, but there still exists uncategorised content under the LEGACY-Extreme tag. Volunteers with a strong stomach may wish to assist in giving more descriptive NSFW tags,

== Former Projects: ==

# '''Help developing a curation submission website''': We introduced a new website to be used for submitting [[Curation_Format#What_is_a_Curation.3F|curations]]. The code is available from the [https://github.com/Dri0m/flashpoint-submission-system/ GitHub repository]. It is located at https://fpfss.unstable.life.
# '''Differential updates''': An updater for Flashpoint Ultimate has been released, and is [https://github.com/FlashpointProject/FlashpointUpdater/releases available here].
# '''Action Message Format support''': We finished adding an AMF implementation to PHP on Flashpoint's server, so now we are working to save user content databases for games that require AMF.
# '''Help curating Geocities.jp games''': Geocities.jp closed on March 31, 2019, and some of the games hosted there were lost forever. At Flashpoint, we worked to curate some of the games, and save the assets for as many as possible so they can be added to Flashpoint later.
# '''PHP script/library to read SWF headers''': Staff member XXLuigiMario created a PHP script that can read the width and height of any SWF, along with a userscript to call this PHP script whenever the browser loads an SWF. To see it in action, download his patches for Flashpoint [https://cdn.discordapp.com/attachments/569426826691346444/674753616002678793/Infinity7.1BasiliskPatch.7z Infinity] or [https://cdn.discordapp.com/attachments/569426826691346444/674745464683233337/Core4.1BasiliskPatch.7z Core].
# '''Portable Shockwave Player plugin''': We finished integrating a portable Shockwave Player plugin with Flashpoint, and it is available in current Flashpoint releases. This was accomplished using our [https://github.com/FlashpointProject/ShockwaveExtender/ Browser Plugin Extender] module.
# '''Hacking Unity Web Player games''': We discovered a viable method for hacking Unity Web Player games, the details of which have been [[Unity_Curation#Hacking_Unity_Web_Player_Games|shared here]].

'''See Also''': [[Help Wanted Games]]

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

Linux Support

2022-05-08T21:43:54Z

Ardil: Update package

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

Unfortunately, the current Flashpoint for Linux package only supports Flash and HTML5.
If this is an issue for you, there are a few options to get Flashpoint running with a more complete feature set:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is your best bet right now.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.

Otherwise, download the Flashpoint 10.1 package and [[#Manual Installation|install it]].

== Manual Installation ==

=== Dependencies ===
First, install Flashpoint's dependencies.
{| class="wikitable"
!colspan="9"|Dependency package names on various distros
|-
!Library/command name
!7z
!wine32
!glibc>=2.27
!php
!qemu-system-i386>=5.2
|-
!Debian
|p7zip
|[https://wiki.winehq.org/Debian winehq-stable]
|libc6
|php
|qemu-system-x86
|-
!Ubuntu, Linux Mint
|p7zip
|[https://wiki.winehq.org/Ubuntu winehq-stable]
|libc6
|php
|qemu-system-x86
|-
!Fedora-like
|p7zip
|[https://wiki.winehq.org/Fedora winehq-stable]
|glibc
|php
|qemu
|-
!Arch-like
|p7zip
|[https://wiki.archlinux.org/title/wine#Installation wine]
|glibc
|php
|qemu-arch-extra
|}
To install wine, follow the linked instructions.

For all other packages, install them through your distro's package manager:
{|class="wikitable"
!Distro
!Package manager install command
|-
!Debian
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Ubuntu, Linux Mint
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Fedora-like
|<code>sudo dnf install {PACKAGE}</code>
|-
!Fedora-like (old)
|<code>sudo yum install {PACKAGE}</code>
|-
!Arch-like
|<code>sudo pacman -S {PACKAGE}</code>
|}

=== Installation ===
Download the [https://bluepload.unstable.life/flashpoint-1012-linux-x64.7z Flashpoint 10.1 Infinity package] and extract it somewhere.

Go to the place where you extracted it, and run <code>./flashpoint</code>.

== Troubleshooting ==

If the Flash Player crashes immediately when launched, there are a few possible solutions:
* Replace our hacked Flash projector with the original, unhacked Adobe Flash projector. Follow these steps:
*# [https://drive.google.com/file/d/1Dt3EGqB6SmfM1hkGszUMnYYlNo7RtlhD/view?usp=sharing Download the projector from here]
*# In your Flashpoint folder, open <code>FPSoftware/Flash</code>
*# Replace the <code>flashplayer_32_sa.exe</code> file with the one you downloaded.
* Remove wine-dxvk from your system. This causes problems with the Flash projector on some computers.

In some cases, a problem with Wine may prevent games in Flashpoint from working. Look for the following error in the Logs tab of the launcher:
wine: 'examplewinedirectory/.wine' is a 64-bit installation, it cannot be used with a 32-bit wineserver.
If you see this error, then run the following command to change the wineprefix that FP is trying to use.
sed -i "2 i export WINEPREFIX=$HOME/.wine_fp" "$HOME/opt/flashpoint/launcher/flashpoint"
Alternatively, if you are running low on disk space and don't care about the contents of the wineprefix, you can take a more destructive route: navigate to your Wine directory (usually, it's your home directory) and run the commands below to resolve the problem. Note that this deletes your current wineprefix.
rm -r .wine/
winecfg

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, it uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code>.

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.

=== Supported Platforms ===
* 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, then either turn off use Wine, or tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser. 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>. By default, Basilisk will store its configuration in the location defined by <code>XDG_CONFIG_DIR</code>, so Flashpoint uses a shell script to set the configuration location. A pre-configured copy of Basilisk, along with the shell script, is packaged and also available [https://drive.google.com/file/d/1Y5Mgm9dCa4gCc6UF5WFPqQruzsO81xhf/view?usp=sharing here]. This [https://cdn.discordapp.com/attachments/516027726851735632/612891261665411073/BasiliskSetup.txt text file] describes Basilisk's configuration.
* Java Applets: Supported natively using the OpenJDK. This support is not currently working, however.
* Unity Web Player: Supported through Wine. Unity 2.x and 3.x games may not work; this needs further testing.
* PopCap Plugin: Supported through Wine.
* Authorware Web Player: Supported through Wine.
* GoBit Plugin: Supported through Wine.

=== Unsupported Platforms ===
* Silverlight: In the past, [http://www.webupd8.org/2013/08/pipelight-use-silverlight-in-your-linux.html Pipelight] allowed Linux users to use Silverlight, but the repository is no longer available for most Linux distros. [https://www.maketecheasier.com/install-and-run-silverlight-in-linux/ Moonlight] was another option, but is also no longer available. Attempts to use Silverlight in K-Meleon using Wine have failed.
* 3DVIA Player: A previous tester received this error, which crashed K-Meleon: <code>Error: Access was denied while trying to open files in your profile directory</code>. We need another tester to help us narrow this down.
* 3D Groove GX: When the http_proxy variable is set, Groove Player downloads but fails to load the file. Maybe the registry method described [https://wiki.winehq.org/FAQ#How_do_I_configure_a_proxy.3F here] would work better, but this needs to be tested. Two of our testers received the following set of errors: [https://media.discordapp.net/attachments/496132309498724391/577330595609444352/unknown.png 1] [https://media.discordapp.net/attachments/496132309498724391/577330680678055948/unknown.png 2] [https://media.discordapp.net/attachments/496132309498724391/577330740396556309/unknown.png 3]
* ActiveX: 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.

== Wine ==
Most games rely on technology only available on Windows. A lot of these however can be run through Wine. If there is no native executable, or you have the Native Platform option unticked for the game's platform then the launcher will run it through Wine.

You may choose to use the native versions, in which case tick the platform under Native Platforms in Config.

If you wish to play games that rely on Wine, be sure to install the 32-bit version of Wine. There are links below to distro specific install guides:

* Ubuntu - https://wiki.winehq.org/Ubuntu
* Debian - https://wiki.debian.org/Wine#Installation_on_Debian_Jessie_and_newer
* Arch Linux - https://wiki.archlinux.org/index.php/Wine#Installation

=== Important Note ===

Update: As of Wine 6.0-rc1, Shockwave appears to be working again. If you are on 5.22, keep an eye out for an update from your distribution.

<s>As of Wine 5.22, the Shockwave wrappers are no longer launching. Avoid updating Wine until a fix is found.</s>

== Changelog ==

; 2021-07-26
: Added 10.0 Infinity package

; 2021-02-16
: Added Core/Ultimate standalone package for 9.0 based on 8.1 Infinity standalone

; 2020-11-07
: Updated .deb to Flashpoint 8.2-2 Infinity
: Added native executables for Flash and HTML5
: Replaced modified Flash Projectors with the unmodified ones
: Fixed extreme games option being disabled in config.json

; 2020-10-23
: Updated .deb to Flashpoint 8.2-1 Infinity

; 2020-07-04
: Updated to Flashpoint 8.1 Infinity
: Updated to Flashpoint Launcher 9.0.2

; 2019-09-28
: Updated to Flashpoint 6.3
: Bundled WIP Launcher with better Multi-Platform Support:
:* Proper linux argument escaping (Supersonic RC works now, yay!)
:* SPR games automatically use port 22500 (Hacky, may be removed later)
:* Wine will always (and only) be used for running .exe files (even if use Wine is turned off in Config)
:* .bat files will always run their .sh equivalents (even if use Wine is turned on in Config)
:* Windows execs are mapped to native execs (if existing), so Windows game XMLs should work out the box. (See execs.json)
:* Can mark a platform as 'native' in Config, will force native execs to be used instead of Windows execs even if use Wine is turned on.
:** If no native execs are available (like Shockwave) then it will fallback to running the Windows exec with Wine.
: Added native Basilisk support files
: Updated SPR files
: Updated router.php

; 2019-09-18
: Added new SPR version (see update-spr.sh) and Shockwave XMLs
: Added interim Launcher hack to make Shockwave games that use SPR work properly
: Made the save manager scripts use a valid interpreter (/bin/sh)
:* TODO: they still need further work/testing

; 2019-07-21 and prior
: 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
: Adds Linux versions of the Save Manager scripts
: Adds a "Flashpoint" shortcut (replacing the Windows version)
: Adds Flashpoint 6.2 games
: Removed the game logos, as in Flashpoint Infinity 6.2 for Windows
: Removed the Wineprefix because it was not used

'''To-Do List'''
* Allow the launcher to automatically start/stop the flashpoint server on Linux
* Rewrite and test startUnity.sh and startJava.sh scripts
* Find a way to get Basilisk working better in Wine, or use an alternative browser like K-Meleon
* Get Java working natively again with OpenJDK 8
* Test Unity 2.x and 3.x games
* AMF support for games like Neon Rider for the community levels

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

Linux Support

2022-05-08T20:48:47Z

Ardil: I don't think we depend on git, wget, or tar. p7zip only sorta (only for unzipping and curation).

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

Unfortunately, the current Flashpoint for Linux package only supports Flash and HTML5.
If this is an issue for you, there are a few options to get Flashpoint running with a more complete feature set:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is your best bet right now.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.

Otherwise, download the Flashpoint 10.1 package and [[#Manual Installation|install it]].

== Manual Installation ==

=== Dependencies ===
First, install Flashpoint's dependencies.
{| class="wikitable"
!colspan="9"|Dependency package names on various distros
|-
!Library/command name
!7z
!wine32
!glibc>=2.27
!php
!qemu-system-i386>=5.2
|-
!Debian
|p7zip
|[https://wiki.winehq.org/Debian winehq-stable]
|libc6
|php
|qemu-system-x86
|-
!Ubuntu, Linux Mint
|p7zip
|[https://wiki.winehq.org/Ubuntu winehq-stable]
|libc6
|php
|qemu-system-x86
|-
!Fedora-like
|p7zip
|[https://wiki.winehq.org/Fedora winehq-stable]
|glibc
|php
|qemu
|-
!Arch-like
|p7zip
|[https://wiki.archlinux.org/title/wine#Installation wine]
|glibc
|php
|qemu-arch-extra
|}
To install wine, follow the linked instructions.

For all other packages, install them through your distro's package manager:
{|class="wikitable"
!Distro
!Package manager install command
|-
!Debian
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Ubuntu, Linux Mint
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Fedora-like
|<code>sudo dnf install {PACKAGE}</code>
|-
!Fedora-like (old)
|<code>sudo yum install {PACKAGE}</code>
|-
!Arch-like
|<code>sudo pacman -S {PACKAGE}</code>
|}

=== Installation ===
Download the [https://bluepload.unstable.life/flashpoint-1011-linux-x64.7z Flashpoint 10.1 Infinity package] and extract it somewhere.

Go to the place where you extracted it, and run <code>./flashpoint</code>.

== Troubleshooting ==

If the Flash Player crashes immediately when launched, there are a few possible solutions:
* Replace our hacked Flash projector with the original, unhacked Adobe Flash projector. Follow these steps:
*# [https://drive.google.com/file/d/1Dt3EGqB6SmfM1hkGszUMnYYlNo7RtlhD/view?usp=sharing Download the projector from here]
*# In your Flashpoint folder, open <code>FPSoftware/Flash</code>
*# Replace the <code>flashplayer_32_sa.exe</code> file with the one you downloaded.
* Remove wine-dxvk from your system. This causes problems with the Flash projector on some computers.

In some cases, a problem with Wine may prevent games in Flashpoint from working. Look for the following error in the Logs tab of the launcher:
wine: 'examplewinedirectory/.wine' is a 64-bit installation, it cannot be used with a 32-bit wineserver.
If you see this error, then run the following command to change the wineprefix that FP is trying to use.
sed -i "2 i export WINEPREFIX=$HOME/.wine_fp" "$HOME/opt/flashpoint/launcher/flashpoint"
Alternatively, if you are running low on disk space and don't care about the contents of the wineprefix, you can take a more destructive route: navigate to your Wine directory (usually, it's your home directory) and run the commands below to resolve the problem. Note that this deletes your current wineprefix.
rm -r .wine/
winecfg

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, it uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code>.

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.

=== Supported Platforms ===
* 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, then either turn off use Wine, or tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser. 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>. By default, Basilisk will store its configuration in the location defined by <code>XDG_CONFIG_DIR</code>, so Flashpoint uses a shell script to set the configuration location. A pre-configured copy of Basilisk, along with the shell script, is packaged and also available [https://drive.google.com/file/d/1Y5Mgm9dCa4gCc6UF5WFPqQruzsO81xhf/view?usp=sharing here]. This [https://cdn.discordapp.com/attachments/516027726851735632/612891261665411073/BasiliskSetup.txt text file] describes Basilisk's configuration.
* Java Applets: Supported natively using the OpenJDK. This support is not currently working, however.
* Unity Web Player: Supported through Wine. Unity 2.x and 3.x games may not work; this needs further testing.
* PopCap Plugin: Supported through Wine.
* Authorware Web Player: Supported through Wine.
* GoBit Plugin: Supported through Wine.

=== Unsupported Platforms ===
* Silverlight: In the past, [http://www.webupd8.org/2013/08/pipelight-use-silverlight-in-your-linux.html Pipelight] allowed Linux users to use Silverlight, but the repository is no longer available for most Linux distros. [https://www.maketecheasier.com/install-and-run-silverlight-in-linux/ Moonlight] was another option, but is also no longer available. Attempts to use Silverlight in K-Meleon using Wine have failed.
* 3DVIA Player: A previous tester received this error, which crashed K-Meleon: <code>Error: Access was denied while trying to open files in your profile directory</code>. We need another tester to help us narrow this down.
* 3D Groove GX: When the http_proxy variable is set, Groove Player downloads but fails to load the file. Maybe the registry method described [https://wiki.winehq.org/FAQ#How_do_I_configure_a_proxy.3F here] would work better, but this needs to be tested. Two of our testers received the following set of errors: [https://media.discordapp.net/attachments/496132309498724391/577330595609444352/unknown.png 1] [https://media.discordapp.net/attachments/496132309498724391/577330680678055948/unknown.png 2] [https://media.discordapp.net/attachments/496132309498724391/577330740396556309/unknown.png 3]
* ActiveX: 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.

== Wine ==
Most games rely on technology only available on Windows. A lot of these however can be run through Wine. If there is no native executable, or you have the Native Platform option unticked for the game's platform then the launcher will run it through Wine.

You may choose to use the native versions, in which case tick the platform under Native Platforms in Config.

If you wish to play games that rely on Wine, be sure to install the 32-bit version of Wine. There are links below to distro specific install guides:

* Ubuntu - https://wiki.winehq.org/Ubuntu
* Debian - https://wiki.debian.org/Wine#Installation_on_Debian_Jessie_and_newer
* Arch Linux - https://wiki.archlinux.org/index.php/Wine#Installation

=== Important Note ===

Update: As of Wine 6.0-rc1, Shockwave appears to be working again. If you are on 5.22, keep an eye out for an update from your distribution.

<s>As of Wine 5.22, the Shockwave wrappers are no longer launching. Avoid updating Wine until a fix is found.</s>

== Changelog ==

; 2021-07-26
: Added 10.0 Infinity package

; 2021-02-16
: Added Core/Ultimate standalone package for 9.0 based on 8.1 Infinity standalone

; 2020-11-07
: Updated .deb to Flashpoint 8.2-2 Infinity
: Added native executables for Flash and HTML5
: Replaced modified Flash Projectors with the unmodified ones
: Fixed extreme games option being disabled in config.json

; 2020-10-23
: Updated .deb to Flashpoint 8.2-1 Infinity

; 2020-07-04
: Updated to Flashpoint 8.1 Infinity
: Updated to Flashpoint Launcher 9.0.2

; 2019-09-28
: Updated to Flashpoint 6.3
: Bundled WIP Launcher with better Multi-Platform Support:
:* Proper linux argument escaping (Supersonic RC works now, yay!)
:* SPR games automatically use port 22500 (Hacky, may be removed later)
:* Wine will always (and only) be used for running .exe files (even if use Wine is turned off in Config)
:* .bat files will always run their .sh equivalents (even if use Wine is turned on in Config)
:* Windows execs are mapped to native execs (if existing), so Windows game XMLs should work out the box. (See execs.json)
:* Can mark a platform as 'native' in Config, will force native execs to be used instead of Windows execs even if use Wine is turned on.
:** If no native execs are available (like Shockwave) then it will fallback to running the Windows exec with Wine.
: Added native Basilisk support files
: Updated SPR files
: Updated router.php

; 2019-09-18
: Added new SPR version (see update-spr.sh) and Shockwave XMLs
: Added interim Launcher hack to make Shockwave games that use SPR work properly
: Made the save manager scripts use a valid interpreter (/bin/sh)
:* TODO: they still need further work/testing

; 2019-07-21 and prior
: 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
: Adds Linux versions of the Save Manager scripts
: Adds a "Flashpoint" shortcut (replacing the Windows version)
: Adds Flashpoint 6.2 games
: Removed the game logos, as in Flashpoint Infinity 6.2 for Windows
: Removed the Wineprefix because it was not used

'''To-Do List'''
* Allow the launcher to automatically start/stop the flashpoint server on Linux
* Rewrite and test startUnity.sh and startJava.sh scripts
* Find a way to get Basilisk working better in Wine, or use an alternative browser like K-Meleon
* Get Java working natively again with OpenJDK 8
* Test Unity 2.x and 3.x games
* AMF support for games like Neon Rider for the community levels

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

Linux Support

2022-05-08T20:42:29Z

Ardil: Update package and deps

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

Unfortunately, the current Flashpoint for Linux package only supports Flash and HTML5.
If this is an issue for you, there are a few options to get Flashpoint running with a more complete feature set:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is your best bet right now.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.

Otherwise, download the Flashpoint 10.1 package and [[#Manual Installation|install it]].

== Manual Installation ==

=== Dependencies ===
First, install Flashpoint's dependencies.
{| class="wikitable"
!colspan="9"|Dependency package names on various distros
|-
!Library/command name
!git
!7z
!tar
!wine32
!wget
!glibc>=2.27
!php
!qemu-system-i386>=5.2
|-
!Debian
|git
|p7zip
|tar
|[https://wiki.winehq.org/Debian winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Ubuntu, Linux Mint
|git
|p7zip
|tar
|[https://wiki.winehq.org/Ubuntu winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Fedora-like
|git
|p7zip
|tar
|[https://wiki.winehq.org/Fedora winehq-stable]
|wget
|glibc
|php
|qemu
|-
!Arch-like
|git
|p7zip
|tar
|[https://wiki.archlinux.org/title/wine#Installation wine]
|wget
|glibc
|php
|qemu-arch-extra
|}
To install wine, follow the linked instructions.

For all other packages, install them through your distro's package manager:
{|class="wikitable"
!Distro
!Package manager install command
|-
!Debian
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Ubuntu, Linux Mint
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Fedora-like
|<code>sudo dnf install {PACKAGE}</code>
|-
!Fedora-like (old)
|<code>sudo yum install {PACKAGE}</code>
|-
!Arch-like
|<code>sudo pacman -S {PACKAGE}</code>
|}

=== Installation ===
Download the [https://bluepload.unstable.life/flashpoint-1011-linux-x64.7z Flashpoint 10.1 Infinity package] and extract it somewhere.

Go to the place where you extracted it, and run <code>./flashpoint</code>.

== Troubleshooting ==

If the Flash Player crashes immediately when launched, there are a few possible solutions:
* Replace our hacked Flash projector with the original, unhacked Adobe Flash projector. Follow these steps:
*# [https://drive.google.com/file/d/1Dt3EGqB6SmfM1hkGszUMnYYlNo7RtlhD/view?usp=sharing Download the projector from here]
*# In your Flashpoint folder, open <code>FPSoftware/Flash</code>
*# Replace the <code>flashplayer_32_sa.exe</code> file with the one you downloaded.
* Remove wine-dxvk from your system. This causes problems with the Flash projector on some computers.

In some cases, a problem with Wine may prevent games in Flashpoint from working. Look for the following error in the Logs tab of the launcher:
wine: 'examplewinedirectory/.wine' is a 64-bit installation, it cannot be used with a 32-bit wineserver.
If you see this error, then run the following command to change the wineprefix that FP is trying to use.
sed -i "2 i export WINEPREFIX=$HOME/.wine_fp" "$HOME/opt/flashpoint/launcher/flashpoint"
Alternatively, if you are running low on disk space and don't care about the contents of the wineprefix, you can take a more destructive route: navigate to your Wine directory (usually, it's your home directory) and run the commands below to resolve the problem. Note that this deletes your current wineprefix.
rm -r .wine/
winecfg

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, it uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code>.

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.

=== Supported Platforms ===
* 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, then either turn off use Wine, or tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser. 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>. By default, Basilisk will store its configuration in the location defined by <code>XDG_CONFIG_DIR</code>, so Flashpoint uses a shell script to set the configuration location. A pre-configured copy of Basilisk, along with the shell script, is packaged and also available [https://drive.google.com/file/d/1Y5Mgm9dCa4gCc6UF5WFPqQruzsO81xhf/view?usp=sharing here]. This [https://cdn.discordapp.com/attachments/516027726851735632/612891261665411073/BasiliskSetup.txt text file] describes Basilisk's configuration.
* Java Applets: Supported natively using the OpenJDK. This support is not currently working, however.
* Unity Web Player: Supported through Wine. Unity 2.x and 3.x games may not work; this needs further testing.
* PopCap Plugin: Supported through Wine.
* Authorware Web Player: Supported through Wine.
* GoBit Plugin: Supported through Wine.

=== Unsupported Platforms ===
* Silverlight: In the past, [http://www.webupd8.org/2013/08/pipelight-use-silverlight-in-your-linux.html Pipelight] allowed Linux users to use Silverlight, but the repository is no longer available for most Linux distros. [https://www.maketecheasier.com/install-and-run-silverlight-in-linux/ Moonlight] was another option, but is also no longer available. Attempts to use Silverlight in K-Meleon using Wine have failed.
* 3DVIA Player: A previous tester received this error, which crashed K-Meleon: <code>Error: Access was denied while trying to open files in your profile directory</code>. We need another tester to help us narrow this down.
* 3D Groove GX: When the http_proxy variable is set, Groove Player downloads but fails to load the file. Maybe the registry method described [https://wiki.winehq.org/FAQ#How_do_I_configure_a_proxy.3F here] would work better, but this needs to be tested. Two of our testers received the following set of errors: [https://media.discordapp.net/attachments/496132309498724391/577330595609444352/unknown.png 1] [https://media.discordapp.net/attachments/496132309498724391/577330680678055948/unknown.png 2] [https://media.discordapp.net/attachments/496132309498724391/577330740396556309/unknown.png 3]
* ActiveX: 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.

== Wine ==
Most games rely on technology only available on Windows. A lot of these however can be run through Wine. If there is no native executable, or you have the Native Platform option unticked for the game's platform then the launcher will run it through Wine.

You may choose to use the native versions, in which case tick the platform under Native Platforms in Config.

If you wish to play games that rely on Wine, be sure to install the 32-bit version of Wine. There are links below to distro specific install guides:

* Ubuntu - https://wiki.winehq.org/Ubuntu
* Debian - https://wiki.debian.org/Wine#Installation_on_Debian_Jessie_and_newer
* Arch Linux - https://wiki.archlinux.org/index.php/Wine#Installation

=== Important Note ===

Update: As of Wine 6.0-rc1, Shockwave appears to be working again. If you are on 5.22, keep an eye out for an update from your distribution.

<s>As of Wine 5.22, the Shockwave wrappers are no longer launching. Avoid updating Wine until a fix is found.</s>

== Changelog ==

; 2021-07-26
: Added 10.0 Infinity package

; 2021-02-16
: Added Core/Ultimate standalone package for 9.0 based on 8.1 Infinity standalone

; 2020-11-07
: Updated .deb to Flashpoint 8.2-2 Infinity
: Added native executables for Flash and HTML5
: Replaced modified Flash Projectors with the unmodified ones
: Fixed extreme games option being disabled in config.json

; 2020-10-23
: Updated .deb to Flashpoint 8.2-1 Infinity

; 2020-07-04
: Updated to Flashpoint 8.1 Infinity
: Updated to Flashpoint Launcher 9.0.2

; 2019-09-28
: Updated to Flashpoint 6.3
: Bundled WIP Launcher with better Multi-Platform Support:
:* Proper linux argument escaping (Supersonic RC works now, yay!)
:* SPR games automatically use port 22500 (Hacky, may be removed later)
:* Wine will always (and only) be used for running .exe files (even if use Wine is turned off in Config)
:* .bat files will always run their .sh equivalents (even if use Wine is turned on in Config)
:* Windows execs are mapped to native execs (if existing), so Windows game XMLs should work out the box. (See execs.json)
:* Can mark a platform as 'native' in Config, will force native execs to be used instead of Windows execs even if use Wine is turned on.
:** If no native execs are available (like Shockwave) then it will fallback to running the Windows exec with Wine.
: Added native Basilisk support files
: Updated SPR files
: Updated router.php

; 2019-09-18
: Added new SPR version (see update-spr.sh) and Shockwave XMLs
: Added interim Launcher hack to make Shockwave games that use SPR work properly
: Made the save manager scripts use a valid interpreter (/bin/sh)
:* TODO: they still need further work/testing

; 2019-07-21 and prior
: 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
: Adds Linux versions of the Save Manager scripts
: Adds a "Flashpoint" shortcut (replacing the Windows version)
: Adds Flashpoint 6.2 games
: Removed the game logos, as in Flashpoint Infinity 6.2 for Windows
: Removed the Wineprefix because it was not used

'''To-Do List'''
* Allow the launcher to automatically start/stop the flashpoint server on Linux
* Rewrite and test startUnity.sh and startJava.sh scripts
* Find a way to get Basilisk working better in Wine, or use an alternative browser like K-Meleon
* Get Java working natively again with OpenJDK 8
* Test Unity 2.x and 3.x games
* AMF support for games like Neon Rider for the community levels

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

Linux Support

2022-05-07T17:38:08Z

Ardil: Update the flashpoint package to 10.1.

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

Unfortunately, the current Flashpoint for Linux package only supports Flash and HTML5.
If this is an issue for you, there are a few options to get Flashpoint running with a more complete feature set:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is your best bet right now.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.

Otherwise, download the Flashpoint 10.1 package and [[#Manual Installation|install it]].

== Manual Installation ==

=== Dependencies ===
First, install Flashpoint's dependencies.
{| class="wikitable"
!colspan="9"|Dependency package names on various distros
|-
!Library/command name
!git
!7z
!tar
!wine32
!wget
!glibc>=2.29
!php
!qemu-system-i386
|-
!Debian
|git
|p7zip
|tar
|[https://wiki.winehq.org/Debian winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Ubuntu, Linux Mint
|git
|p7zip
|tar
|[https://wiki.winehq.org/Ubuntu winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Fedora-like
|git
|p7zip
|tar
|[https://wiki.winehq.org/Fedora winehq-stable]
|wget
|glibc
|php
|qemu
|-
!Arch-like
|git
|p7zip
|tar
|[https://wiki.archlinux.org/title/wine#Installation wine]
|wget
|glibc
|php
|qemu-arch-extra
|}
To install wine, follow the linked instructions.

For all other packages, install them through your distro's package manager:
{|class="wikitable"
!Distro
!Package manager install command
|-
!Debian
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Ubuntu, Linux Mint
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Fedora-like
|<code>sudo dnf install {PACKAGE}</code>
|-
!Fedora-like (old)
|<code>sudo yum install {PACKAGE}</code>
|-
!Arch-like
|<code>sudo pacman -S {PACKAGE}</code>
|}

=== Installation ===
Download the [https://bluepload.unstable.life/flashpoint-101-linux-x64.7z Flashpoint 10.1 Infinity package] and extract it somewhere.

Go to the place where you extracted it, and run <code>./flashpoint</code>.

== Troubleshooting ==

If the Flash Player crashes immediately when launched, there are a few possible solutions:
* Replace our hacked Flash projector with the original, unhacked Adobe Flash projector. Follow these steps:
*# [https://drive.google.com/file/d/1Dt3EGqB6SmfM1hkGszUMnYYlNo7RtlhD/view?usp=sharing Download the projector from here]
*# In your Flashpoint folder, open <code>FPSoftware/Flash</code>
*# Replace the <code>flashplayer_32_sa.exe</code> file with the one you downloaded.
* Remove wine-dxvk from your system. This causes problems with the Flash projector on some computers.

In some cases, a problem with Wine may prevent games in Flashpoint from working. Look for the following error in the Logs tab of the launcher:
wine: 'examplewinedirectory/.wine' is a 64-bit installation, it cannot be used with a 32-bit wineserver.
If you see this error, then run the following command to change the wineprefix that FP is trying to use.
sed -i "2 i export WINEPREFIX=$HOME/.wine_fp" "$HOME/opt/flashpoint/launcher/flashpoint"
Alternatively, if you are running low on disk space and don't care about the contents of the wineprefix, you can take a more destructive route: navigate to your Wine directory (usually, it's your home directory) and run the commands below to resolve the problem. Note that this deletes your current wineprefix.
rm -r .wine/
winecfg

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, it uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code>.

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.

=== Supported Platforms ===
* 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, then either turn off use Wine, or tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser. 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>. By default, Basilisk will store its configuration in the location defined by <code>XDG_CONFIG_DIR</code>, so Flashpoint uses a shell script to set the configuration location. A pre-configured copy of Basilisk, along with the shell script, is packaged and also available [https://drive.google.com/file/d/1Y5Mgm9dCa4gCc6UF5WFPqQruzsO81xhf/view?usp=sharing here]. This [https://cdn.discordapp.com/attachments/516027726851735632/612891261665411073/BasiliskSetup.txt text file] describes Basilisk's configuration.
* Java Applets: Supported natively using the OpenJDK. This support is not currently working, however.
* Unity Web Player: Supported through Wine. Unity 2.x and 3.x games may not work; this needs further testing.
* PopCap Plugin: Supported through Wine.
* Authorware Web Player: Supported through Wine.
* GoBit Plugin: Supported through Wine.

=== Unsupported Platforms ===
* Silverlight: In the past, [http://www.webupd8.org/2013/08/pipelight-use-silverlight-in-your-linux.html Pipelight] allowed Linux users to use Silverlight, but the repository is no longer available for most Linux distros. [https://www.maketecheasier.com/install-and-run-silverlight-in-linux/ Moonlight] was another option, but is also no longer available. Attempts to use Silverlight in K-Meleon using Wine have failed.
* 3DVIA Player: A previous tester received this error, which crashed K-Meleon: <code>Error: Access was denied while trying to open files in your profile directory</code>. We need another tester to help us narrow this down.
* 3D Groove GX: When the http_proxy variable is set, Groove Player downloads but fails to load the file. Maybe the registry method described [https://wiki.winehq.org/FAQ#How_do_I_configure_a_proxy.3F here] would work better, but this needs to be tested. Two of our testers received the following set of errors: [https://media.discordapp.net/attachments/496132309498724391/577330595609444352/unknown.png 1] [https://media.discordapp.net/attachments/496132309498724391/577330680678055948/unknown.png 2] [https://media.discordapp.net/attachments/496132309498724391/577330740396556309/unknown.png 3]
* ActiveX: 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.

== Wine ==
Most games rely on technology only available on Windows. A lot of these however can be run through Wine. If there is no native executable, or you have the Native Platform option unticked for the game's platform then the launcher will run it through Wine.

You may choose to use the native versions, in which case tick the platform under Native Platforms in Config.

If you wish to play games that rely on Wine, be sure to install the 32-bit version of Wine. There are links below to distro specific install guides:

* Ubuntu - https://wiki.winehq.org/Ubuntu
* Debian - https://wiki.debian.org/Wine#Installation_on_Debian_Jessie_and_newer
* Arch Linux - https://wiki.archlinux.org/index.php/Wine#Installation

=== Important Note ===

Update: As of Wine 6.0-rc1, Shockwave appears to be working again. If you are on 5.22, keep an eye out for an update from your distribution.

<s>As of Wine 5.22, the Shockwave wrappers are no longer launching. Avoid updating Wine until a fix is found.</s>

== Changelog ==

; 2021-07-26
: Added 10.0 Infinity package

; 2021-02-16
: Added Core/Ultimate standalone package for 9.0 based on 8.1 Infinity standalone

; 2020-11-07
: Updated .deb to Flashpoint 8.2-2 Infinity
: Added native executables for Flash and HTML5
: Replaced modified Flash Projectors with the unmodified ones
: Fixed extreme games option being disabled in config.json

; 2020-10-23
: Updated .deb to Flashpoint 8.2-1 Infinity

; 2020-07-04
: Updated to Flashpoint 8.1 Infinity
: Updated to Flashpoint Launcher 9.0.2

; 2019-09-28
: Updated to Flashpoint 6.3
: Bundled WIP Launcher with better Multi-Platform Support:
:* Proper linux argument escaping (Supersonic RC works now, yay!)
:* SPR games automatically use port 22500 (Hacky, may be removed later)
:* Wine will always (and only) be used for running .exe files (even if use Wine is turned off in Config)
:* .bat files will always run their .sh equivalents (even if use Wine is turned on in Config)
:* Windows execs are mapped to native execs (if existing), so Windows game XMLs should work out the box. (See execs.json)
:* Can mark a platform as 'native' in Config, will force native execs to be used instead of Windows execs even if use Wine is turned on.
:** If no native execs are available (like Shockwave) then it will fallback to running the Windows exec with Wine.
: Added native Basilisk support files
: Updated SPR files
: Updated router.php

; 2019-09-18
: Added new SPR version (see update-spr.sh) and Shockwave XMLs
: Added interim Launcher hack to make Shockwave games that use SPR work properly
: Made the save manager scripts use a valid interpreter (/bin/sh)
:* TODO: they still need further work/testing

; 2019-07-21 and prior
: 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
: Adds Linux versions of the Save Manager scripts
: Adds a "Flashpoint" shortcut (replacing the Windows version)
: Adds Flashpoint 6.2 games
: Removed the game logos, as in Flashpoint Infinity 6.2 for Windows
: Removed the Wineprefix because it was not used

'''To-Do List'''
* Allow the launcher to automatically start/stop the flashpoint server on Linux
* Rewrite and test startUnity.sh and startJava.sh scripts
* Find a way to get Basilisk working better in Wine, or use an alternative browser like K-Meleon
* Get Java working natively again with OpenJDK 8
* Test Unity 2.x and 3.x games
* AMF support for games like Neon Rider for the community levels

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

Orphan Add-App Cleanup

2022-03-13T23:57:55Z

Ardil: Write basic summary.

This page contains directions for handling "orphaned" add-apps - that is, add-apps without a <code>parentGameId</code>. Add-apps are required to have a <code>parentGameId</code>, so the lack of one is an issue that must be dealt with.

==Standard Add-Apps==
These are the normal kind of add-app: an alternative version of a game.
There are five possible results that can be obtained from this process:
- '''selfparent'''
- '''delete'''
- '''recurate'''
- '''markbroken'''
- '''parent='''''parentUUID''
For each of these results, you should include a note with some explanation.

Generally, the process to find a parent is as follows:
#Try to find a game with a similar <code>launchCommand</code>, i.e. in the same folder or on the same domain.
##If this works, check that the orphan isn't exactly the same as its parent. If it is the same, '''delete'''. Otherwise, you've found the right parentUUID, and the result is '''parent='''''parentUUID''.
#Try playing the game. If there's a visible title, try to find a game with a similar (maybe translated?) one.
##If this works, check that the orphan isn't exactly the same as its parent. If it is exactly the same, '''delete'''. Otherwise, you've found the right parentUUID, and the result is '''parent='''''parentUUID''.
##If this partially works (preloader works, but the rest is broken), '''broken'''.
##If this doesn't work, '''delete'''.
##If this does work, but it doesn't appear to be related to any other game, '''selfparent'''.
#Check for other add-apps with similar names or <code>launchCommand</code>s.
##If you find a dupe, '''delete'''. If you find a similar one, try looking at that one's <code>parentGameId</code>.

If you ended up with either '''broken''' or '''delete''', check whether the files are still live. If they are, '''recurate'''.

==Extras==
These are extra files related to a game. Look at them, trying to find titles. If you aren't sure, ask around.

==Messages==
There are only three. Good luck matching them back to their parents.

Linux Support

2022-03-11T17:09:49Z

Ardil: Remove oudated instructions, make the Manual Installation header more friendly.

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

Unfortunately, no up-to-date Flashpoint packages are currently available. There are a few options to get Flashpoint running:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is your best bet right now.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.
* Download the outdated Flashpoint 10.0 package and [[#Manual Installation (for advanced users)|manually update it]] to get it working. This should work more consistently, as long as you are able to follow all of the steps.

== Manual Installation ==

No up-to-date Flashpoint packages for Linux are currently available, but with a few extra steps, you can download the outdated Flashpoint 10.0 package and update it to work again. The steps for doing so are below.

=== Dependencies ===
First, install Flashpoint's dependencies.
{| class="wikitable"
!colspan="9"|Dependency package names on various distros
|-
!Library/command name
!git
!7z
!tar
!wine32
!wget
!glibc>=2.29
!php
!qemu-system-i386
|-
!Debian
|git
|p7zip
|tar
|[https://wiki.winehq.org/Debian winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Ubuntu, Linux Mint
|git
|p7zip
|tar
|[https://wiki.winehq.org/Ubuntu winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Fedora-like
|git
|p7zip
|tar
|[https://wiki.winehq.org/Fedora winehq-stable]
|wget
|glibc
|php
|qemu
|-
!Arch-like
|git
|p7zip
|tar
|[https://wiki.archlinux.org/title/wine#Installation wine]
|wget
|glibc
|php
|qemu-arch-extra
|}
To install wine, follow the linked instructions.

For all other packages, install them through your distro's package manager:
{|class="wikitable"
!Distro
!Package manager install command
|-
!Debian
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Ubuntu, Linux Mint
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Fedora-like
|<code>sudo dnf install {PACKAGE}</code>
|-
!Fedora-like (old)
|<code>sudo yum install {PACKAGE}</code>
|-
!Arch-like
|<code>sudo pacman -S {PACKAGE}</code>
|}

=== Installation ===
Open a terminal and enter the following commands:
# Change the working directory to your home directory
cd
# Create the required directories
mkdir --verbose --parents opt/flashpoint/{launcher,data}
# Get the new flashpoint launcher (version 10.1.1)
cd opt/flashpoint/launcher
wget https://github.com/FlashpointProject/launcher/releases/download/10.1.1/Flashpoint-10.1.1_linux-x64.7z
7z x ./Flashpoint-10.1.1_linux-x64.7z
rm -v Flashpoint-10.1.1_linux-x64.7z
# Because PHP and QEMU are not killed correctly upon exit, create this launch script:
cat << EOF > flashpoint
#!/bin/sh
cd $HOME/opt/flashpoint/launcher
$HOME/opt/flashpoint/launcher/flashpoint-launcher
killall php
killall qemu-system-i386
EOF
chmod +x flashpoint
# Get Flashpoint 10.0 Infinity
cd ../data
# This ended up getting its name incremented because of a naming conflict.
# Don't worry, it is x64, even if the name says x65.
wget https://bluepload.unstable.life/flashpoint-10-linux-x65.7z
7z x flashpoint-10-linux-x65.7z
rm --verbose flashpoint-10-linux-x65.7z
cd ../launcher

Open flashpoint using the command <code>./flashpoint</code>. Go to Config, set the Flashpoint Path (in the "Flashpoint" section) to <code>../data</code>, and then scroll down and click the "Save & Restart" button.

=== Fix qemu failing to start ===
Execute the following command:
qemu-system-i386 -machine help | grep pc-i440fx-6.0
If that command outputs "pc-i440fx-6.0 Standard PC (i440FX + PIIX, 1996)" then open the file opt/flashpoint/data/Data/services.json and change the line 34 from:
"arguments": ["-m", "512", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
to
"arguments": ["-m", "512", "-machine", "pc-i440fx-6.0", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
Note that comments are not allowed in the json files.

If there is no output to the command "qemu-system-i386 -machine help | grep pc-i440fx-6.0" start qemu with the following command:
qemu-system-i386 -m 512 -net nic,model=e1000 -net user,hostfwd=tcp:127.0.0.1:22500-:80 -hda ~/opt/flashpoint/data/Server/alpine.qcow2
Wait for the alpine system to boot up and open the View menu and select compatmonitor0 and type the commands:
delvm quick
savevm quick
quit

== Troubleshooting ==

If the Flash Player crashes immediately when launched, there are a few possible solutions:
* Replace our hacked Flash projector with the original, unhacked Adobe Flash projector. Follow these steps:
*# [https://drive.google.com/file/d/1Dt3EGqB6SmfM1hkGszUMnYYlNo7RtlhD/view?usp=sharing Download the projector from here]
*# In your Flashpoint folder, open <code>FPSoftware/Flash</code>
*# Replace the <code>flashplayer_32_sa.exe</code> file with the one you downloaded.
* Remove wine-dxvk from your system. This causes problems with the Flash projector on some computers.

In some cases, a problem with Wine may prevent games in Flashpoint from working. Look for the following error in the Logs tab of the launcher:
wine: 'examplewinedirectory/.wine' is a 64-bit installation, it cannot be used with a 32-bit wineserver.
If you see this error, then run the following command to change the wineprefix that FP is trying to use.
sed -i "2 i export WINEPREFIX=$HOME/.wine_fp" "$HOME/opt/flashpoint/launcher/flashpoint"
Alternatively, if you are running low on disk space and don't care about the contents of the wineprefix, you can take a more destructive route: navigate to your Wine directory (usually, it's your home directory) and run the commands below to resolve the problem. Note that this deletes your current wineprefix.
rm -r .wine/
winecfg

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, it uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code>.

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.

=== Supported Platforms ===
* 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, then either turn off use Wine, or tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser. 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>. By default, Basilisk will store its configuration in the location defined by <code>XDG_CONFIG_DIR</code>, so Flashpoint uses a shell script to set the configuration location. A pre-configured copy of Basilisk, along with the shell script, is packaged and also available [https://drive.google.com/file/d/1Y5Mgm9dCa4gCc6UF5WFPqQruzsO81xhf/view?usp=sharing here]. This [https://cdn.discordapp.com/attachments/516027726851735632/612891261665411073/BasiliskSetup.txt text file] describes Basilisk's configuration.
* Java Applets: Supported natively using the OpenJDK. This support is not currently working, however.
* Unity Web Player: Supported through Wine. Unity 2.x and 3.x games may not work; this needs further testing.
* PopCap Plugin: Supported through Wine.
* Authorware Web Player: Supported through Wine.
* GoBit Plugin: Supported through Wine.

=== Unsupported Platforms ===
* Silverlight: In the past, [http://www.webupd8.org/2013/08/pipelight-use-silverlight-in-your-linux.html Pipelight] allowed Linux users to use Silverlight, but the repository is no longer available for most Linux distros. [https://www.maketecheasier.com/install-and-run-silverlight-in-linux/ Moonlight] was another option, but is also no longer available. Attempts to use Silverlight in K-Meleon using Wine have failed.
* 3DVIA Player: A previous tester received this error, which crashed K-Meleon: <code>Error: Access was denied while trying to open files in your profile directory</code>. We need another tester to help us narrow this down.
* 3D Groove GX: When the http_proxy variable is set, Groove Player downloads but fails to load the file. Maybe the registry method described [https://wiki.winehq.org/FAQ#How_do_I_configure_a_proxy.3F here] would work better, but this needs to be tested. Two of our testers received the following set of errors: [https://media.discordapp.net/attachments/496132309498724391/577330595609444352/unknown.png 1] [https://media.discordapp.net/attachments/496132309498724391/577330680678055948/unknown.png 2] [https://media.discordapp.net/attachments/496132309498724391/577330740396556309/unknown.png 3]
* ActiveX: 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.

== Wine ==
Most games rely on technology only available on Windows. A lot of these however can be run through Wine. If there is no native executable, or you have the Native Platform option unticked for the game's platform then the launcher will run it through Wine.

You may choose to use the native versions, in which case tick the platform under Native Platforms in Config.

If you wish to play games that rely on Wine, be sure to install the 32-bit version of Wine. There are links below to distro specific install guides:

* Ubuntu - https://wiki.winehq.org/Ubuntu
* Debian - https://wiki.debian.org/Wine#Installation_on_Debian_Jessie_and_newer
* Arch Linux - https://wiki.archlinux.org/index.php/Wine#Installation

=== Important Note ===

Update: As of Wine 6.0-rc1, Shockwave appears to be working again. If you are on 5.22, keep an eye out for an update from your distribution.

<s>As of Wine 5.22, the Shockwave wrappers are no longer launching. Avoid updating Wine until a fix is found.</s>

== Changelog ==

; 2021-07-26
: Added 10.0 Infinity package

; 2021-02-16
: Added Core/Ultimate standalone package for 9.0 based on 8.1 Infinity standalone

; 2020-11-07
: Updated .deb to Flashpoint 8.2-2 Infinity
: Added native executables for Flash and HTML5
: Replaced modified Flash Projectors with the unmodified ones
: Fixed extreme games option being disabled in config.json

; 2020-10-23
: Updated .deb to Flashpoint 8.2-1 Infinity

; 2020-07-04
: Updated to Flashpoint 8.1 Infinity
: Updated to Flashpoint Launcher 9.0.2

; 2019-09-28
: Updated to Flashpoint 6.3
: Bundled WIP Launcher with better Multi-Platform Support:
:* Proper linux argument escaping (Supersonic RC works now, yay!)
:* SPR games automatically use port 22500 (Hacky, may be removed later)
:* Wine will always (and only) be used for running .exe files (even if use Wine is turned off in Config)
:* .bat files will always run their .sh equivalents (even if use Wine is turned on in Config)
:* Windows execs are mapped to native execs (if existing), so Windows game XMLs should work out the box. (See execs.json)
:* Can mark a platform as 'native' in Config, will force native execs to be used instead of Windows execs even if use Wine is turned on.
:** If no native execs are available (like Shockwave) then it will fallback to running the Windows exec with Wine.
: Added native Basilisk support files
: Updated SPR files
: Updated router.php

; 2019-09-18
: Added new SPR version (see update-spr.sh) and Shockwave XMLs
: Added interim Launcher hack to make Shockwave games that use SPR work properly
: Made the save manager scripts use a valid interpreter (/bin/sh)
:* TODO: they still need further work/testing

; 2019-07-21 and prior
: 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
: Adds Linux versions of the Save Manager scripts
: Adds a "Flashpoint" shortcut (replacing the Windows version)
: Adds Flashpoint 6.2 games
: Removed the game logos, as in Flashpoint Infinity 6.2 for Windows
: Removed the Wineprefix because it was not used

'''To-Do List'''
* Allow the launcher to automatically start/stop the flashpoint server on Linux
* Rewrite and test startUnity.sh and startJava.sh scripts
* Find a way to get Basilisk working better in Wine, or use an alternative browser like K-Meleon
* Get Java working natively again with OpenJDK 8
* Test Unity 2.x and 3.x games
* AMF support for games like Neon Rider for the community levels

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

Linux Support

2022-03-11T14:39:42Z

Ardil: Ensure that working directory gets set correctly at the end.

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

Unfortunately, no up-to-date Flashpoint packages are currently available. There are a few options to get Flashpoint running:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is your best bet right now.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.
* Download the outdated Flashpoint 10.0 package and [[#Manual Installation (for advanced users)|manually update it]] to get it working. This should work more consistently, as long as you are able to follow all of the steps.

== Stand-Alone Packages ==

These are standalone packages suitable for all common Linux distributions.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages/]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Distro-specific Packages ==

These are experimental packages for specific Linux distributions. If you don't see a package for your system here, '''please use the stand-alone package instead!''' If you can help update these packages, please visit the Discord server and join #development-chat.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages|Outdated Packages]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Manual Installation (for advanced users) ==

No up-to-date Flashpoint packages for Linux are currently available, but with a few extra steps, you can download the outdated Flashpoint 10.0 package and update it to work again. The steps for doing so are below.

=== Dependencies ===
First, install Flashpoint's dependencies.
{| class="wikitable"
!colspan="9"|Dependency package names on various distros
|-
!Library/command name
!git
!7z
!tar
!wine32
!wget
!glibc>=2.29
!php
!qemu-system-i386
|-
!Debian
|git
|p7zip
|tar
|[https://wiki.winehq.org/Debian winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Ubuntu, Linux Mint
|git
|p7zip
|tar
|[https://wiki.winehq.org/Ubuntu winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Fedora-like
|git
|p7zip
|tar
|[https://wiki.winehq.org/Fedora winehq-stable]
|wget
|glibc
|php
|qemu
|-
!Arch-like
|git
|p7zip
|tar
|[https://wiki.archlinux.org/title/wine#Installation wine]
|wget
|glibc
|php
|qemu-arch-extra
|}
To install wine, follow the linked instructions.

For all other packages, install them through your distro's package manager:
{|class="wikitable"
!Distro
!Package manager install command
|-
!Debian
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Ubuntu, Linux Mint
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Fedora-like
|<code>sudo dnf install {PACKAGE}</code>
|-
!Fedora-like (old)
|<code>sudo yum install {PACKAGE}</code>
|-
!Arch-like
|<code>sudo pacman -S {PACKAGE}</code>
|}

=== Installation ===
Open a terminal and enter the following commands:
# Change the working directory to your home directory
cd
# Create the required directories
mkdir --verbose --parents opt/flashpoint/{launcher,data}
# Get the new flashpoint launcher (version 10.1.1)
cd opt/flashpoint/launcher
wget https://github.com/FlashpointProject/launcher/releases/download/10.1.1/Flashpoint-10.1.1_linux-x64.7z
7z x ./Flashpoint-10.1.1_linux-x64.7z
rm -v Flashpoint-10.1.1_linux-x64.7z
# Because PHP and QEMU are not killed correctly upon exit, create this launch script:
cat << EOF > flashpoint
#!/bin/sh
cd $HOME/opt/flashpoint/launcher
$HOME/opt/flashpoint/launcher/flashpoint-launcher
killall php
killall qemu-system-i386
EOF
chmod +x flashpoint
# Get Flashpoint 10.0 Infinity
cd ../data
# This ended up getting its name incremented because of a naming conflict.
# Don't worry, it is x64, even if the name says x65.
wget https://bluepload.unstable.life/flashpoint-10-linux-x65.7z
7z x flashpoint-10-linux-x65.7z
rm --verbose flashpoint-10-linux-x65.7z
cd ../launcher

Open flashpoint using the command <code>./flashpoint</code>. Go to Config, set the Flashpoint Path (in the "Flashpoint" section) to <code>../data</code>, and then scroll down and click the "Save & Restart" button.

=== Fix qemu failing to start ===
Execute the following command:
qemu-system-i386 -machine help | grep pc-i440fx-6.0
If that command outputs "pc-i440fx-6.0 Standard PC (i440FX + PIIX, 1996)" then open the file opt/flashpoint/data/Data/services.json and change the line 34 from:
"arguments": ["-m", "512", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
to
"arguments": ["-m", "512", "-machine", "pc-i440fx-6.0", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
Note that comments are not allowed in the json files.

If there is no output to the command "qemu-system-i386 -machine help | grep pc-i440fx-6.0" start qemu with the following command:
qemu-system-i386 -m 512 -net nic,model=e1000 -net user,hostfwd=tcp:127.0.0.1:22500-:80 -hda ~/opt/flashpoint/data/Server/alpine.qcow2
Wait for the alpine system to boot up and open the View menu and select compatmonitor0 and type the commands:
delvm quick
savevm quick
quit

== Troubleshooting ==

If the Flash Player crashes immediately when launched, there are a few possible solutions:
* Replace our hacked Flash projector with the original, unhacked Adobe Flash projector. Follow these steps:
*# [https://drive.google.com/file/d/1Dt3EGqB6SmfM1hkGszUMnYYlNo7RtlhD/view?usp=sharing Download the projector from here]
*# In your Flashpoint folder, open <code>FPSoftware/Flash</code>
*# Replace the <code>flashplayer_32_sa.exe</code> file with the one you downloaded.
* Remove wine-dxvk from your system. This causes problems with the Flash projector on some computers.

In some cases, a problem with Wine may prevent games in Flashpoint from working. Look for the following error in the Logs tab of the launcher:
wine: 'examplewinedirectory/.wine' is a 64-bit installation, it cannot be used with a 32-bit wineserver.
If you see this error, then run the following command to change the wineprefix that FP is trying to use.
sed -i "2 i export WINEPREFIX=$HOME/.wine_fp" "$HOME/opt/flashpoint/launcher/flashpoint"
Alternatively, if you are running low on disk space and don't care about the contents of the wineprefix, you can take a more destructive route: navigate to your Wine directory (usually, it's your home directory) and run the commands below to resolve the problem. Note that this deletes your current wineprefix.
rm -r .wine/
winecfg

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, it uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code>.

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.

=== Supported Platforms ===
* 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, then either turn off use Wine, or tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser. 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>. By default, Basilisk will store its configuration in the location defined by <code>XDG_CONFIG_DIR</code>, so Flashpoint uses a shell script to set the configuration location. A pre-configured copy of Basilisk, along with the shell script, is packaged and also available [https://drive.google.com/file/d/1Y5Mgm9dCa4gCc6UF5WFPqQruzsO81xhf/view?usp=sharing here]. This [https://cdn.discordapp.com/attachments/516027726851735632/612891261665411073/BasiliskSetup.txt text file] describes Basilisk's configuration.
* Java Applets: Supported natively using the OpenJDK. This support is not currently working, however.
* Unity Web Player: Supported through Wine. Unity 2.x and 3.x games may not work; this needs further testing.
* PopCap Plugin: Supported through Wine.
* Authorware Web Player: Supported through Wine.
* GoBit Plugin: Supported through Wine.

=== Unsupported Platforms ===
* Silverlight: In the past, [http://www.webupd8.org/2013/08/pipelight-use-silverlight-in-your-linux.html Pipelight] allowed Linux users to use Silverlight, but the repository is no longer available for most Linux distros. [https://www.maketecheasier.com/install-and-run-silverlight-in-linux/ Moonlight] was another option, but is also no longer available. Attempts to use Silverlight in K-Meleon using Wine have failed.
* 3DVIA Player: A previous tester received this error, which crashed K-Meleon: <code>Error: Access was denied while trying to open files in your profile directory</code>. We need another tester to help us narrow this down.
* 3D Groove GX: When the http_proxy variable is set, Groove Player downloads but fails to load the file. Maybe the registry method described [https://wiki.winehq.org/FAQ#How_do_I_configure_a_proxy.3F here] would work better, but this needs to be tested. Two of our testers received the following set of errors: [https://media.discordapp.net/attachments/496132309498724391/577330595609444352/unknown.png 1] [https://media.discordapp.net/attachments/496132309498724391/577330680678055948/unknown.png 2] [https://media.discordapp.net/attachments/496132309498724391/577330740396556309/unknown.png 3]
* ActiveX: 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.

== Wine ==
Most games rely on technology only available on Windows. A lot of these however can be run through Wine. If there is no native executable, or you have the Native Platform option unticked for the game's platform then the launcher will run it through Wine.

You may choose to use the native versions, in which case tick the platform under Native Platforms in Config.

If you wish to play games that rely on Wine, be sure to install the 32-bit version of Wine. There are links below to distro specific install guides:

* Ubuntu - https://wiki.winehq.org/Ubuntu
* Debian - https://wiki.debian.org/Wine#Installation_on_Debian_Jessie_and_newer
* Arch Linux - https://wiki.archlinux.org/index.php/Wine#Installation

=== Important Note ===

Update: As of Wine 6.0-rc1, Shockwave appears to be working again. If you are on 5.22, keep an eye out for an update from your distribution.

<s>As of Wine 5.22, the Shockwave wrappers are no longer launching. Avoid updating Wine until a fix is found.</s>

== Changelog ==

; 2021-07-26
: Added 10.0 Infinity package

; 2021-02-16
: Added Core/Ultimate standalone package for 9.0 based on 8.1 Infinity standalone

; 2020-11-07
: Updated .deb to Flashpoint 8.2-2 Infinity
: Added native executables for Flash and HTML5
: Replaced modified Flash Projectors with the unmodified ones
: Fixed extreme games option being disabled in config.json

; 2020-10-23
: Updated .deb to Flashpoint 8.2-1 Infinity

; 2020-07-04
: Updated to Flashpoint 8.1 Infinity
: Updated to Flashpoint Launcher 9.0.2

; 2019-09-28
: Updated to Flashpoint 6.3
: Bundled WIP Launcher with better Multi-Platform Support:
:* Proper linux argument escaping (Supersonic RC works now, yay!)
:* SPR games automatically use port 22500 (Hacky, may be removed later)
:* Wine will always (and only) be used for running .exe files (even if use Wine is turned off in Config)
:* .bat files will always run their .sh equivalents (even if use Wine is turned on in Config)
:* Windows execs are mapped to native execs (if existing), so Windows game XMLs should work out the box. (See execs.json)
:* Can mark a platform as 'native' in Config, will force native execs to be used instead of Windows execs even if use Wine is turned on.
:** If no native execs are available (like Shockwave) then it will fallback to running the Windows exec with Wine.
: Added native Basilisk support files
: Updated SPR files
: Updated router.php

; 2019-09-18
: Added new SPR version (see update-spr.sh) and Shockwave XMLs
: Added interim Launcher hack to make Shockwave games that use SPR work properly
: Made the save manager scripts use a valid interpreter (/bin/sh)
:* TODO: they still need further work/testing

; 2019-07-21 and prior
: 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
: Adds Linux versions of the Save Manager scripts
: Adds a "Flashpoint" shortcut (replacing the Windows version)
: Adds Flashpoint 6.2 games
: Removed the game logos, as in Flashpoint Infinity 6.2 for Windows
: Removed the Wineprefix because it was not used

'''To-Do List'''
* Allow the launcher to automatically start/stop the flashpoint server on Linux
* Rewrite and test startUnity.sh and startJava.sh scripts
* Find a way to get Basilisk working better in Wine, or use an alternative browser like K-Meleon
* Get Java working natively again with OpenJDK 8
* Test Unity 2.x and 3.x games
* AMF support for games like Neon Rider for the community levels

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

Linux Support

2022-02-19T03:21:53Z

Ardil: Use the right 7z.

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

Unfortunately, no up-to-date Flashpoint packages are currently available. There are a few options to get Flashpoint running:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is your best bet right now.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.
* Download the outdated Flashpoint 10.0 package and [[#Manual Installation (for advanced users)|manually update it]] to get it working. This should work more consistently, as long as you are able to follow all of the steps.

== Stand-Alone Packages ==

These are standalone packages suitable for all common Linux distributions.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages/]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Distro-specific Packages ==

These are experimental packages for specific Linux distributions. If you don't see a package for your system here, '''please use the stand-alone package instead!''' If you can help update these packages, please visit the Discord server and join #development-chat.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages|Outdated Packages]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Manual Installation (for advanced users) ==

No up-to-date Flashpoint packages for Linux are currently available, but with a few extra steps, you can download the outdated Flashpoint 10.0 package and update it to work again. The steps for doing so are below.

=== Dependencies ===
First, install Flashpoint's dependencies.
{| class="wikitable"
!colspan="9"|Dependency package names on various distros
|-
!Library/command name
!git
!7z
!tar
!wine32
!wget
!glibc>=2.29
!php
!qemu-system-i386
|-
!Debian
|git
|p7zip
|tar
|[https://wiki.winehq.org/Debian winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Ubuntu, Linux Mint
|git
|p7zip
|tar
|[https://wiki.winehq.org/Ubuntu winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Fedora-like
|git
|p7zip
|tar
|[https://wiki.winehq.org/Fedora winehq-stable]
|wget
|glibc
|php
|qemu
|-
!Arch-like
|git
|p7zip
|tar
|[https://wiki.archlinux.org/title/wine#Installation wine]
|wget
|glibc
|php
|qemu-arch-extra
|}
To install wine, follow the linked instructions.

For all other packages, install them through your distro's package manager:
{|class="wikitable"
!Distro
!Package manager install command
|-
!Debian
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Ubuntu, Linux Mint
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Fedora-like
|<code>sudo dnf install {PACKAGE}</code>
|-
!Fedora-like (old)
|<code>sudo yum install {PACKAGE}</code>
|-
!Arch-like
|<code>sudo pacman -S {PACKAGE}</code>
|}

=== Installation ===
Open a terminal and enter the following commands:
# Change the working directory to your home directory
cd
# Create the required directories
mkdir --verbose --parents opt/flashpoint/{launcher,data}
# Get the new flashpoint launcher (version 10.1.1)
cd opt/flashpoint/launcher
wget https://github.com/FlashpointProject/launcher/releases/download/10.1.1/Flashpoint-10.1.1_linux-x64.7z
7z x ./Flashpoint-10.1.1_linux-x64.7z
rm -v Flashpoint-10.1.1_linux-x64.7z
# Because PHP and QEMU are not killed correctly upon exit, create this launch script:
cat << EOF > flashpoint
#!/bin/sh
cd $HOME/opt/flashpoint/launcher
$HOME/opt/flashpoint/launcher/flashpoint-launcher
killall php
killall qemu-system-i386
EOF
chmod +x flashpoint
# Get Flashpoint 10.0 Infinity
cd ../data
# This ended up getting its name incremented because of a naming conflict.
# Don't worry, it is x64, even if the name says x65.
wget https://bluepload.unstable.life/flashpoint-10-linux-x65.7z
7z x flashpoint-10-linux-x65.7z
rm --verbose flashpoint-10-linux-x65.7z

Open flashpoint using the command <code>./flashpoint</code>. Go to Config, set the Flashpoint Path (in the "Flashpoint" section) to <code>../data</code>, and then scroll down and click the "Save & Restart" button.

=== Fix qemu failing to start ===
Execute the following command:
qemu-system-i386 -machine help | grep pc-i440fx-6.0
If that command outputs "pc-i440fx-6.0 Standard PC (i440FX + PIIX, 1996)" then open the file opt/flashpoint/data/Data/services.json and change the line 34 from:
"arguments": ["-m", "512", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
to
"arguments": ["-m", "512", "-machine", "pc-i440fx-6.0", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
Note that comments are not allowed in the json files.

If there is no output to the command "qemu-system-i386 -machine help | grep pc-i440fx-6.0" start qemu with the following command:
qemu-system-i386 -m 512 -net nic,model=e1000 -net user,hostfwd=tcp:127.0.0.1:22500-:80 -hda ~/opt/flashpoint/data/Server/alpine.qcow2
Wait for the alpine system to boot up and open the View menu and select compatmonitor0 and type the commands:
delvm quick
savevm quick
quit

== Troubleshooting ==

If the Flash Player crashes immediately when launched, there are a few possible solutions:
* Replace our hacked Flash projector with the original, unhacked Adobe Flash projector. Follow these steps:
*# [https://drive.google.com/file/d/1Dt3EGqB6SmfM1hkGszUMnYYlNo7RtlhD/view?usp=sharing Download the projector from here]
*# In your Flashpoint folder, open <code>FPSoftware/Flash</code>
*# Replace the <code>flashplayer_32_sa.exe</code> file with the one you downloaded.
* Remove wine-dxvk from your system. This causes problems with the Flash projector on some computers.

In some cases, a problem with Wine may prevent games in Flashpoint from working. Look for the following error in the Logs tab of the launcher:
wine: 'examplewinedirectory/.wine' is a 64-bit installation, it cannot be used with a 32-bit wineserver.
If you see this error, then run the following command to change the wineprefix that FP is trying to use.
sed -i "2 i export WINEPREFIX=$HOME/.wine_fp" "$HOME/opt/flashpoint/launcher/flashpoint"
Alternatively, if you are running low on disk space and don't care about the contents of the wineprefix, you can take a more destructive route: navigate to your Wine directory (usually, it's your home directory) and run the commands below to resolve the problem. Note that this deletes your current wineprefix.
rm -r .wine/
winecfg

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, it uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code>.

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.

=== Supported Platforms ===
* 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, then either turn off use Wine, or tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser. 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>. By default, Basilisk will store its configuration in the location defined by <code>XDG_CONFIG_DIR</code>, so Flashpoint uses a shell script to set the configuration location. A pre-configured copy of Basilisk, along with the shell script, is packaged and also available [https://drive.google.com/file/d/1Y5Mgm9dCa4gCc6UF5WFPqQruzsO81xhf/view?usp=sharing here]. This [https://cdn.discordapp.com/attachments/516027726851735632/612891261665411073/BasiliskSetup.txt text file] describes Basilisk's configuration.
* Java Applets: Supported natively using the OpenJDK. This support is not currently working, however.
* Unity Web Player: Supported through Wine. Unity 2.x and 3.x games may not work; this needs further testing.
* PopCap Plugin: Supported through Wine.
* Authorware Web Player: Supported through Wine.
* GoBit Plugin: Supported through Wine.

=== Unsupported Platforms ===
* Silverlight: In the past, [http://www.webupd8.org/2013/08/pipelight-use-silverlight-in-your-linux.html Pipelight] allowed Linux users to use Silverlight, but the repository is no longer available for most Linux distros. [https://www.maketecheasier.com/install-and-run-silverlight-in-linux/ Moonlight] was another option, but is also no longer available. Attempts to use Silverlight in K-Meleon using Wine have failed.
* 3DVIA Player: A previous tester received this error, which crashed K-Meleon: <code>Error: Access was denied while trying to open files in your profile directory</code>. We need another tester to help us narrow this down.
* 3D Groove GX: When the http_proxy variable is set, Groove Player downloads but fails to load the file. Maybe the registry method described [https://wiki.winehq.org/FAQ#How_do_I_configure_a_proxy.3F here] would work better, but this needs to be tested. Two of our testers received the following set of errors: [https://media.discordapp.net/attachments/496132309498724391/577330595609444352/unknown.png 1] [https://media.discordapp.net/attachments/496132309498724391/577330680678055948/unknown.png 2] [https://media.discordapp.net/attachments/496132309498724391/577330740396556309/unknown.png 3]
* ActiveX: 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.

== Wine ==
Most games rely on technology only available on Windows. A lot of these however can be run through Wine. If there is no native executable, or you have the Native Platform option unticked for the game's platform then the launcher will run it through Wine.

You may choose to use the native versions, in which case tick the platform under Native Platforms in Config.

If you wish to play games that rely on Wine, be sure to install the 32-bit version of Wine. There are links below to distro specific install guides:

* Ubuntu - https://wiki.winehq.org/Ubuntu
* Debian - https://wiki.debian.org/Wine#Installation_on_Debian_Jessie_and_newer
* Arch Linux - https://wiki.archlinux.org/index.php/Wine#Installation

=== Important Note ===

Update: As of Wine 6.0-rc1, Shockwave appears to be working again. If you are on 5.22, keep an eye out for an update from your distribution.

<s>As of Wine 5.22, the Shockwave wrappers are no longer launching. Avoid updating Wine until a fix is found.</s>

== Changelog ==

; 2021-07-26
: Added 10.0 Infinity package

; 2021-02-16
: Added Core/Ultimate standalone package for 9.0 based on 8.1 Infinity standalone

; 2020-11-07
: Updated .deb to Flashpoint 8.2-2 Infinity
: Added native executables for Flash and HTML5
: Replaced modified Flash Projectors with the unmodified ones
: Fixed extreme games option being disabled in config.json

; 2020-10-23
: Updated .deb to Flashpoint 8.2-1 Infinity

; 2020-07-04
: Updated to Flashpoint 8.1 Infinity
: Updated to Flashpoint Launcher 9.0.2

; 2019-09-28
: Updated to Flashpoint 6.3
: Bundled WIP Launcher with better Multi-Platform Support:
:* Proper linux argument escaping (Supersonic RC works now, yay!)
:* SPR games automatically use port 22500 (Hacky, may be removed later)
:* Wine will always (and only) be used for running .exe files (even if use Wine is turned off in Config)
:* .bat files will always run their .sh equivalents (even if use Wine is turned on in Config)
:* Windows execs are mapped to native execs (if existing), so Windows game XMLs should work out the box. (See execs.json)
:* Can mark a platform as 'native' in Config, will force native execs to be used instead of Windows execs even if use Wine is turned on.
:** If no native execs are available (like Shockwave) then it will fallback to running the Windows exec with Wine.
: Added native Basilisk support files
: Updated SPR files
: Updated router.php

; 2019-09-18
: Added new SPR version (see update-spr.sh) and Shockwave XMLs
: Added interim Launcher hack to make Shockwave games that use SPR work properly
: Made the save manager scripts use a valid interpreter (/bin/sh)
:* TODO: they still need further work/testing

; 2019-07-21 and prior
: 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
: Adds Linux versions of the Save Manager scripts
: Adds a "Flashpoint" shortcut (replacing the Windows version)
: Adds Flashpoint 6.2 games
: Removed the game logos, as in Flashpoint Infinity 6.2 for Windows
: Removed the Wineprefix because it was not used

'''To-Do List'''
* Allow the launcher to automatically start/stop the flashpoint server on Linux
* Rewrite and test startUnity.sh and startJava.sh scripts
* Find a way to get Basilisk working better in Wine, or use an alternative browser like K-Meleon
* Get Java working natively again with OpenJDK 8
* Test Unity 2.x and 3.x games
* AMF support for games like Neon Rider for the community levels

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

Linux Support

2022-02-19T03:14:36Z

Ardil: Use 7z version of FP 10, to save on bandwidth.

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

Unfortunately, no up-to-date Flashpoint packages are currently available. There are a few options to get Flashpoint running:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is your best bet right now.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.
* Download the outdated Flashpoint 10.0 package and [[#Manual Installation (for advanced users)|manually update it]] to get it working. This should work more consistently, as long as you are able to follow all of the steps.

== Stand-Alone Packages ==

These are standalone packages suitable for all common Linux distributions.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages/]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Distro-specific Packages ==

These are experimental packages for specific Linux distributions. If you don't see a package for your system here, '''please use the stand-alone package instead!''' If you can help update these packages, please visit the Discord server and join #development-chat.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages|Outdated Packages]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Manual Installation (for advanced users) ==

No up-to-date Flashpoint packages for Linux are currently available, but with a few extra steps, you can download the outdated Flashpoint 10.0 package and update it to work again. The steps for doing so are below.

=== Dependencies ===
First, install Flashpoint's dependencies.
{| class="wikitable"
!colspan="9"|Dependency package names on various distros
|-
!Library/command name
!git
!7z
!tar
!wine32
!wget
!glibc>=2.29
!php
!qemu-system-i386
|-
!Debian
|git
|p7zip
|tar
|[https://wiki.winehq.org/Debian winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Ubuntu, Linux Mint
|git
|p7zip
|tar
|[https://wiki.winehq.org/Ubuntu winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Fedora-like
|git
|p7zip
|tar
|[https://wiki.winehq.org/Fedora winehq-stable]
|wget
|glibc
|php
|qemu
|-
!Arch-like
|git
|p7zip
|tar
|[https://wiki.archlinux.org/title/wine#Installation wine]
|wget
|glibc
|php
|qemu-arch-extra
|}
To install wine, follow the linked instructions.

For all other packages, install them through your distro's package manager:
{|class="wikitable"
!Distro
!Package manager install command
|-
!Debian
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Ubuntu, Linux Mint
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Fedora-like
|<code>sudo dnf install {PACKAGE}</code>
|-
!Fedora-like (old)
|<code>sudo yum install {PACKAGE}</code>
|-
!Arch-like
|<code>sudo pacman -S {PACKAGE}</code>
|}

=== Installation ===
Open a terminal and enter the following commands:
# Change the working directory to your home directory
cd
# Create the required directories
mkdir --verbose --parents opt/flashpoint/{launcher,data}
# Get the new flashpoint launcher (version 10.1.1)
cd opt/flashpoint/launcher
wget https://github.com/FlashpointProject/launcher/releases/download/10.1.1/Flashpoint-10.1.1_linux-x64.7z
7z x ./Flashpoint-10.1.1_linux-x64.7z
rm -v Flashpoint-10.1.1_linux-x64.7z
# Because PHP and QEMU are not killed correctly upon exit, create this launch script:
cat << EOF > flashpoint
#!/bin/sh
cd $HOME/opt/flashpoint/launcher
$HOME/opt/flashpoint/launcher/flashpoint-launcher
killall php
killall qemu-system-i386
EOF
chmod +x flashpoint
# Get Flashpoint 10.0 Infinity
cd ../data
wget https://bluepload.unstable.life/flashpoint-10-linux-x64.7z
7z x flashpoint-10-linux-x64.7z
rm --verbose flashpoint-10-linux-x64.7z

Open flashpoint using the command <code>./flashpoint</code>. Go to Config, set the Flashpoint Path (in the "Flashpoint" section) to <code>../data</code>, and then scroll down and click the "Save & Restart" button.

=== Fix qemu failing to start ===
Execute the following command:
qemu-system-i386 -machine help | grep pc-i440fx-6.0
If that command outputs "pc-i440fx-6.0 Standard PC (i440FX + PIIX, 1996)" then open the file opt/flashpoint/data/Data/services.json and change the line 34 from:
"arguments": ["-m", "512", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
to
"arguments": ["-m", "512", "-machine", "pc-i440fx-6.0", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
Note that comments are not allowed in the json files.

If there is no output to the command "qemu-system-i386 -machine help | grep pc-i440fx-6.0" start qemu with the following command:
qemu-system-i386 -m 512 -net nic,model=e1000 -net user,hostfwd=tcp:127.0.0.1:22500-:80 -hda ~/opt/flashpoint/data/Server/alpine.qcow2
Wait for the alpine system to boot up and open the View menu and select compatmonitor0 and type the commands:
delvm quick
savevm quick
quit

== Troubleshooting ==

If the Flash Player crashes immediately when launched, there are a few possible solutions:
* Replace our hacked Flash projector with the original, unhacked Adobe Flash projector. Follow these steps:
*# [https://drive.google.com/file/d/1Dt3EGqB6SmfM1hkGszUMnYYlNo7RtlhD/view?usp=sharing Download the projector from here]
*# In your Flashpoint folder, open <code>FPSoftware/Flash</code>
*# Replace the <code>flashplayer_32_sa.exe</code> file with the one you downloaded.
* Remove wine-dxvk from your system. This causes problems with the Flash projector on some computers.

In some cases, a problem with Wine may prevent games in Flashpoint from working. Look for the following error in the Logs tab of the launcher:
wine: 'examplewinedirectory/.wine' is a 64-bit installation, it cannot be used with a 32-bit wineserver.
If you see this error, then run the following command to change the wineprefix that FP is trying to use.
sed -i "2 i export WINEPREFIX=$HOME/.wine_fp" "$HOME/opt/flashpoint/launcher/flashpoint"
Alternatively, if you are running low on disk space and don't care about the contents of the wineprefix, you can take a more destructive route: navigate to your Wine directory (usually, it's your home directory) and run the commands below to resolve the problem. Note that this deletes your current wineprefix.
rm -r .wine/
winecfg

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, it uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code>.

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.

=== Supported Platforms ===
* 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, then either turn off use Wine, or tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser. 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>. By default, Basilisk will store its configuration in the location defined by <code>XDG_CONFIG_DIR</code>, so Flashpoint uses a shell script to set the configuration location. A pre-configured copy of Basilisk, along with the shell script, is packaged and also available [https://drive.google.com/file/d/1Y5Mgm9dCa4gCc6UF5WFPqQruzsO81xhf/view?usp=sharing here]. This [https://cdn.discordapp.com/attachments/516027726851735632/612891261665411073/BasiliskSetup.txt text file] describes Basilisk's configuration.
* Java Applets: Supported natively using the OpenJDK. This support is not currently working, however.
* Unity Web Player: Supported through Wine. Unity 2.x and 3.x games may not work; this needs further testing.
* PopCap Plugin: Supported through Wine.
* Authorware Web Player: Supported through Wine.
* GoBit Plugin: Supported through Wine.

=== Unsupported Platforms ===
* Silverlight: In the past, [http://www.webupd8.org/2013/08/pipelight-use-silverlight-in-your-linux.html Pipelight] allowed Linux users to use Silverlight, but the repository is no longer available for most Linux distros. [https://www.maketecheasier.com/install-and-run-silverlight-in-linux/ Moonlight] was another option, but is also no longer available. Attempts to use Silverlight in K-Meleon using Wine have failed.
* 3DVIA Player: A previous tester received this error, which crashed K-Meleon: <code>Error: Access was denied while trying to open files in your profile directory</code>. We need another tester to help us narrow this down.
* 3D Groove GX: When the http_proxy variable is set, Groove Player downloads but fails to load the file. Maybe the registry method described [https://wiki.winehq.org/FAQ#How_do_I_configure_a_proxy.3F here] would work better, but this needs to be tested. Two of our testers received the following set of errors: [https://media.discordapp.net/attachments/496132309498724391/577330595609444352/unknown.png 1] [https://media.discordapp.net/attachments/496132309498724391/577330680678055948/unknown.png 2] [https://media.discordapp.net/attachments/496132309498724391/577330740396556309/unknown.png 3]
* ActiveX: 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.

== Wine ==
Most games rely on technology only available on Windows. A lot of these however can be run through Wine. If there is no native executable, or you have the Native Platform option unticked for the game's platform then the launcher will run it through Wine.

You may choose to use the native versions, in which case tick the platform under Native Platforms in Config.

If you wish to play games that rely on Wine, be sure to install the 32-bit version of Wine. There are links below to distro specific install guides:

* Ubuntu - https://wiki.winehq.org/Ubuntu
* Debian - https://wiki.debian.org/Wine#Installation_on_Debian_Jessie_and_newer
* Arch Linux - https://wiki.archlinux.org/index.php/Wine#Installation

=== Important Note ===

Update: As of Wine 6.0-rc1, Shockwave appears to be working again. If you are on 5.22, keep an eye out for an update from your distribution.

<s>As of Wine 5.22, the Shockwave wrappers are no longer launching. Avoid updating Wine until a fix is found.</s>

== Changelog ==

; 2021-07-26
: Added 10.0 Infinity package

; 2021-02-16
: Added Core/Ultimate standalone package for 9.0 based on 8.1 Infinity standalone

; 2020-11-07
: Updated .deb to Flashpoint 8.2-2 Infinity
: Added native executables for Flash and HTML5
: Replaced modified Flash Projectors with the unmodified ones
: Fixed extreme games option being disabled in config.json

; 2020-10-23
: Updated .deb to Flashpoint 8.2-1 Infinity

; 2020-07-04
: Updated to Flashpoint 8.1 Infinity
: Updated to Flashpoint Launcher 9.0.2

; 2019-09-28
: Updated to Flashpoint 6.3
: Bundled WIP Launcher with better Multi-Platform Support:
:* Proper linux argument escaping (Supersonic RC works now, yay!)
:* SPR games automatically use port 22500 (Hacky, may be removed later)
:* Wine will always (and only) be used for running .exe files (even if use Wine is turned off in Config)
:* .bat files will always run their .sh equivalents (even if use Wine is turned on in Config)
:* Windows execs are mapped to native execs (if existing), so Windows game XMLs should work out the box. (See execs.json)
:* Can mark a platform as 'native' in Config, will force native execs to be used instead of Windows execs even if use Wine is turned on.
:** If no native execs are available (like Shockwave) then it will fallback to running the Windows exec with Wine.
: Added native Basilisk support files
: Updated SPR files
: Updated router.php

; 2019-09-18
: Added new SPR version (see update-spr.sh) and Shockwave XMLs
: Added interim Launcher hack to make Shockwave games that use SPR work properly
: Made the save manager scripts use a valid interpreter (/bin/sh)
:* TODO: they still need further work/testing

; 2019-07-21 and prior
: 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
: Adds Linux versions of the Save Manager scripts
: Adds a "Flashpoint" shortcut (replacing the Windows version)
: Adds Flashpoint 6.2 games
: Removed the game logos, as in Flashpoint Infinity 6.2 for Windows
: Removed the Wineprefix because it was not used

'''To-Do List'''
* Allow the launcher to automatically start/stop the flashpoint server on Linux
* Rewrite and test startUnity.sh and startJava.sh scripts
* Find a way to get Basilisk working better in Wine, or use an alternative browser like K-Meleon
* Get Java working natively again with OpenJDK 8
* Test Unity 2.x and 3.x games
* AMF support for games like Neon Rider for the community levels

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

Linux Support

2022-02-07T15:58:36Z

Ardil: /* Installation */ It doesn't need to be a new terminal.

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

Unfortunately, no up-to-date Flashpoint packages are currently available. There are a few options to get Flashpoint running:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is your best bet right now.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.
* Download the outdated Flashpoint 10.0 package and [[#Manual Installation (for advanced users)|manually update it]] to get it working. This should work more consistently, as long as you are able to follow all of the steps.

== Stand-Alone Packages ==

These are standalone packages suitable for all common Linux distributions.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages/]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Distro-specific Packages ==

These are experimental packages for specific Linux distributions. If you don't see a package for your system here, '''please use the stand-alone package instead!''' If you can help update these packages, please visit the Discord server and join #development-chat.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages|Outdated Packages]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Manual Installation (for advanced users) ==

No up-to-date Flashpoint packages for Linux are currently available, but with a few extra steps, you can download the outdated Flashpoint 10.0 package and update it to work again. The steps for doing so are below.

=== Dependencies ===
First, install Flashpoint's dependencies.
{| class="wikitable"
!colspan="9"|Dependency package names on various distros
|-
!Library/command name
!git
!7z
!tar
!wine32
!wget
!glibc>=2.29
!php
!qemu-system-i386
|-
!Debian
|git
|p7zip
|tar
|[https://wiki.winehq.org/Debian winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Ubuntu, Linux Mint
|git
|p7zip
|tar
|[https://wiki.winehq.org/Ubuntu winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Fedora-like
|git
|p7zip
|tar
|[https://wiki.winehq.org/Fedora winehq-stable]
|wget
|glibc
|php
|qemu
|-
!Arch-like
|git
|p7zip
|tar
|[https://wiki.archlinux.org/title/wine#Installation wine]
|wget
|glibc
|php
|qemu-arch-extra
|}
To install wine, follow the linked instructions.

For all other packages, install them through your distro's package manager:
{|class="wikitable"
!Distro
!Package manager install command
|-
!Debian
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Ubuntu, Linux Mint
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Fedora-like
|<code>sudo dnf install {PACKAGE}</code>
|-
!Fedora-like (old)
|<code>sudo yum install {PACKAGE}</code>
|-
!Arch-like
|<code>sudo pacman -S {PACKAGE}</code>
|}

=== Installation ===
Open a terminal and enter the following commands:
# Change the working directory to your home directory
cd
# Create the required directories
mkdir --verbose --parents opt/flashpoint/{launcher,data}
# Get the new flashpoint launcher (version 10.1.1)
cd opt/flashpoint/launcher
wget https://github.com/FlashpointProject/launcher/releases/download/10.1.1/Flashpoint-10.1.1_linux-x64.7z
7z x ./Flashpoint-10.1.1_linux-x64.7z
rm -v Flashpoint-10.1.1_linux-x64.7z
# Because PHP and QEMU are not killed correctly upon exit, create this launch script:
cat << EOF > flashpoint
#!/bin/sh
cd $HOME/opt/flashpoint/launcher
$HOME/opt/flashpoint/launcher/flashpoint-launcher
killall php
killall qemu-system-i386
EOF
chmod +x flashpoint
# Get Flashpoint 10.0 Infinity
cd ../data
wget https://bluepload.unstable.life/flashpoint-10-linux-x64.tar.gz
tar --extract --verbose --file=./flashpoint-10-linux-x64.tar.gz
rm --verbose ./flashpoint-10-linux-x64.tar.gz

Open flashpoint using the command <code>./flashpoint</code>. Go to Config, set the Flashpoint Path (in the "Flashpoint" section) to <code>../data</code>, and then scroll down and click the "Save & Restart" button.

=== Fix qemu failing to start ===
Execute the following command:
qemu-system-i386 -machine help | grep pc-i440fx-6.0
If that command outputs "pc-i440fx-6.0 Standard PC (i440FX + PIIX, 1996)" then open the file opt/flashpoint/data/Data/services.json and change the line 34 from:
"arguments": ["-m", "512", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
to
"arguments": ["-m", "512", "-machine", "pc-i440fx-6.0", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
Note that comments are not allowed in the json files.

If there is no output to the command "qemu-system-i386 -machine help | grep pc-i440fx-6.0" start qemu with the following command:
qemu-system-i386 -m 512 -net nic,model=e1000 -net user,hostfwd=tcp:127.0.0.1:22500-:80 -hda ~/opt/flashpoint/data/Server/alpine.qcow2
Wait for the alpine system to boot up and open the View menu and select compatmonitor0 and type the commands:
delvm quick
savevm quick
quit

== Troubleshooting ==

If the Flash Player crashes immediately when launched, there are a few possible solutions:
* Replace our hacked Flash projector with the original, unhacked Adobe Flash projector. Follow these steps:
*# [https://drive.google.com/file/d/1Dt3EGqB6SmfM1hkGszUMnYYlNo7RtlhD/view?usp=sharing Download the projector from here]
*# In your Flashpoint folder, open <code>FPSoftware/Flash</code>
*# Replace the <code>flashplayer_32_sa.exe</code> file with the one you downloaded.
* Remove wine-dxvk from your system. This causes problems with the Flash projector on some computers.

In some cases, a problem with Wine may prevent games in Flashpoint from working. Look for the following error in the Logs tab of the launcher:
wine: 'examplewinedirectory/.wine' is a 64-bit installation, it cannot be used with a 32-bit wineserver.
If you see this error, then run the following command to change the wineprefix that FP is trying to use.
sed -i "2 i export WINEPREFIX=$HOME/.wine_fp" "$HOME/opt/flashpoint/launcher/flashpoint"
Alternatively, if you are running low on disk space and don't care about the contents of the wineprefix, you can take a more destructive route: navigate to your Wine directory (usually, it's your home directory) and run the commands below to resolve the problem. Note that this deletes your current wineprefix.
rm -r .wine/
winecfg

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, it uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code>.

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.

=== Supported Platforms ===
* 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, then either turn off use Wine, or tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser. 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>. By default, Basilisk will store its configuration in the location defined by <code>XDG_CONFIG_DIR</code>, so Flashpoint uses a shell script to set the configuration location. A pre-configured copy of Basilisk, along with the shell script, is packaged and also available [https://drive.google.com/file/d/1Y5Mgm9dCa4gCc6UF5WFPqQruzsO81xhf/view?usp=sharing here]. This [https://cdn.discordapp.com/attachments/516027726851735632/612891261665411073/BasiliskSetup.txt text file] describes Basilisk's configuration.
* Java Applets: Supported natively using the OpenJDK. This support is not currently working, however.
* Unity Web Player: Supported through Wine. Unity 2.x and 3.x games may not work; this needs further testing.
* PopCap Plugin: Supported through Wine.
* Authorware Web Player: Supported through Wine.
* GoBit Plugin: Supported through Wine.

=== Unsupported Platforms ===
* Silverlight: In the past, [http://www.webupd8.org/2013/08/pipelight-use-silverlight-in-your-linux.html Pipelight] allowed Linux users to use Silverlight, but the repository is no longer available for most Linux distros. [https://www.maketecheasier.com/install-and-run-silverlight-in-linux/ Moonlight] was another option, but is also no longer available. Attempts to use Silverlight in K-Meleon using Wine have failed.
* 3DVIA Player: A previous tester received this error, which crashed K-Meleon: <code>Error: Access was denied while trying to open files in your profile directory</code>. We need another tester to help us narrow this down.
* 3D Groove GX: When the http_proxy variable is set, Groove Player downloads but fails to load the file. Maybe the registry method described [https://wiki.winehq.org/FAQ#How_do_I_configure_a_proxy.3F here] would work better, but this needs to be tested. Two of our testers received the following set of errors: [https://media.discordapp.net/attachments/496132309498724391/577330595609444352/unknown.png 1] [https://media.discordapp.net/attachments/496132309498724391/577330680678055948/unknown.png 2] [https://media.discordapp.net/attachments/496132309498724391/577330740396556309/unknown.png 3]
* ActiveX: 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.

== Wine ==
Most games rely on technology only available on Windows. A lot of these however can be run through Wine. If there is no native executable, or you have the Native Platform option unticked for the game's platform then the launcher will run it through Wine.

You may choose to use the native versions, in which case tick the platform under Native Platforms in Config.

If you wish to play games that rely on Wine, be sure to install the 32-bit version of Wine. There are links below to distro specific install guides:

* Ubuntu - https://wiki.winehq.org/Ubuntu
* Debian - https://wiki.debian.org/Wine#Installation_on_Debian_Jessie_and_newer
* Arch Linux - https://wiki.archlinux.org/index.php/Wine#Installation

=== Important Note ===

Update: As of Wine 6.0-rc1, Shockwave appears to be working again. If you are on 5.22, keep an eye out for an update from your distribution.

<s>As of Wine 5.22, the Shockwave wrappers are no longer launching. Avoid updating Wine until a fix is found.</s>

== Changelog ==

; 2021-07-26
: Added 10.0 Infinity package

; 2021-02-16
: Added Core/Ultimate standalone package for 9.0 based on 8.1 Infinity standalone

; 2020-11-07
: Updated .deb to Flashpoint 8.2-2 Infinity
: Added native executables for Flash and HTML5
: Replaced modified Flash Projectors with the unmodified ones
: Fixed extreme games option being disabled in config.json

; 2020-10-23
: Updated .deb to Flashpoint 8.2-1 Infinity

; 2020-07-04
: Updated to Flashpoint 8.1 Infinity
: Updated to Flashpoint Launcher 9.0.2

; 2019-09-28
: Updated to Flashpoint 6.3
: Bundled WIP Launcher with better Multi-Platform Support:
:* Proper linux argument escaping (Supersonic RC works now, yay!)
:* SPR games automatically use port 22500 (Hacky, may be removed later)
:* Wine will always (and only) be used for running .exe files (even if use Wine is turned off in Config)
:* .bat files will always run their .sh equivalents (even if use Wine is turned on in Config)
:* Windows execs are mapped to native execs (if existing), so Windows game XMLs should work out the box. (See execs.json)
:* Can mark a platform as 'native' in Config, will force native execs to be used instead of Windows execs even if use Wine is turned on.
:** If no native execs are available (like Shockwave) then it will fallback to running the Windows exec with Wine.
: Added native Basilisk support files
: Updated SPR files
: Updated router.php

; 2019-09-18
: Added new SPR version (see update-spr.sh) and Shockwave XMLs
: Added interim Launcher hack to make Shockwave games that use SPR work properly
: Made the save manager scripts use a valid interpreter (/bin/sh)
:* TODO: they still need further work/testing

; 2019-07-21 and prior
: 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
: Adds Linux versions of the Save Manager scripts
: Adds a "Flashpoint" shortcut (replacing the Windows version)
: Adds Flashpoint 6.2 games
: Removed the game logos, as in Flashpoint Infinity 6.2 for Windows
: Removed the Wineprefix because it was not used

'''To-Do List'''
* Allow the launcher to automatically start/stop the flashpoint server on Linux
* Rewrite and test startUnity.sh and startJava.sh scripts
* Find a way to get Basilisk working better in Wine, or use an alternative browser like K-Meleon
* Get Java working natively again with OpenJDK 8
* Test Unity 2.x and 3.x games
* AMF support for games like Neon Rider for the community levels

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

Linux Support

2022-02-07T15:57:54Z

Ardil: /* Dependencies */ Explicitly state at the top that you need to install the deps.

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

Unfortunately, no up-to-date Flashpoint packages are currently available. There are a few options to get Flashpoint running:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is your best bet right now.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.
* Download the outdated Flashpoint 10.0 package and [[#Manual Installation (for advanced users)|manually update it]] to get it working. This should work more consistently, as long as you are able to follow all of the steps.

== Stand-Alone Packages ==

These are standalone packages suitable for all common Linux distributions.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages/]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Distro-specific Packages ==

These are experimental packages for specific Linux distributions. If you don't see a package for your system here, '''please use the stand-alone package instead!''' If you can help update these packages, please visit the Discord server and join #development-chat.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages|Outdated Packages]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Manual Installation (for advanced users) ==

No up-to-date Flashpoint packages for Linux are currently available, but with a few extra steps, you can download the outdated Flashpoint 10.0 package and update it to work again. The steps for doing so are below.

=== Dependencies ===
First, install Flashpoint's dependencies.
{| class="wikitable"
!colspan="9"|Dependency package names on various distros
|-
!Library/command name
!git
!7z
!tar
!wine32
!wget
!glibc>=2.29
!php
!qemu-system-i386
|-
!Debian
|git
|p7zip
|tar
|[https://wiki.winehq.org/Debian winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Ubuntu, Linux Mint
|git
|p7zip
|tar
|[https://wiki.winehq.org/Ubuntu winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Fedora-like
|git
|p7zip
|tar
|[https://wiki.winehq.org/Fedora winehq-stable]
|wget
|glibc
|php
|qemu
|-
!Arch-like
|git
|p7zip
|tar
|[https://wiki.archlinux.org/title/wine#Installation wine]
|wget
|glibc
|php
|qemu-arch-extra
|}
To install wine, follow the linked instructions.

For all other packages, install them through your distro's package manager:
{|class="wikitable"
!Distro
!Package manager install command
|-
!Debian
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Ubuntu, Linux Mint
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Fedora-like
|<code>sudo dnf install {PACKAGE}</code>
|-
!Fedora-like (old)
|<code>sudo yum install {PACKAGE}</code>
|-
!Arch-like
|<code>sudo pacman -S {PACKAGE}</code>
|}

=== Installation ===
Open a new terminal and enter the following commands:
# Change the working directory to your home directory
cd
# Create the required directories
mkdir --verbose --parents opt/flashpoint/{launcher,data}
# Get the new flashpoint launcher (version 10.1.1)
cd opt/flashpoint/launcher
wget https://github.com/FlashpointProject/launcher/releases/download/10.1.1/Flashpoint-10.1.1_linux-x64.7z
7z x ./Flashpoint-10.1.1_linux-x64.7z
rm -v Flashpoint-10.1.1_linux-x64.7z
# Because PHP and QEMU are not killed correctly upon exit, create this launch script:
cat << EOF > flashpoint
#!/bin/sh
cd $HOME/opt/flashpoint/launcher
$HOME/opt/flashpoint/launcher/flashpoint-launcher
killall php
killall qemu-system-i386
EOF
chmod +x flashpoint
# Get Flashpoint 10.0 Infinity
cd ../data
wget https://bluepload.unstable.life/flashpoint-10-linux-x64.tar.gz
tar --extract --verbose --file=./flashpoint-10-linux-x64.tar.gz
rm --verbose ./flashpoint-10-linux-x64.tar.gz

Open flashpoint using the command <code>./flashpoint</code>. Go to Config, set the Flashpoint Path (in the "Flashpoint" section) to <code>../data</code>, and then scroll down and click the "Save & Restart" button.

=== Fix qemu failing to start ===
Execute the following command:
qemu-system-i386 -machine help | grep pc-i440fx-6.0
If that command outputs "pc-i440fx-6.0 Standard PC (i440FX + PIIX, 1996)" then open the file opt/flashpoint/data/Data/services.json and change the line 34 from:
"arguments": ["-m", "512", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
to
"arguments": ["-m", "512", "-machine", "pc-i440fx-6.0", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
Note that comments are not allowed in the json files.

If there is no output to the command "qemu-system-i386 -machine help | grep pc-i440fx-6.0" start qemu with the following command:
qemu-system-i386 -m 512 -net nic,model=e1000 -net user,hostfwd=tcp:127.0.0.1:22500-:80 -hda ~/opt/flashpoint/data/Server/alpine.qcow2
Wait for the alpine system to boot up and open the View menu and select compatmonitor0 and type the commands:
delvm quick
savevm quick
quit

== Troubleshooting ==

If the Flash Player crashes immediately when launched, there are a few possible solutions:
* Replace our hacked Flash projector with the original, unhacked Adobe Flash projector. Follow these steps:
*# [https://drive.google.com/file/d/1Dt3EGqB6SmfM1hkGszUMnYYlNo7RtlhD/view?usp=sharing Download the projector from here]
*# In your Flashpoint folder, open <code>FPSoftware/Flash</code>
*# Replace the <code>flashplayer_32_sa.exe</code> file with the one you downloaded.
* Remove wine-dxvk from your system. This causes problems with the Flash projector on some computers.

In some cases, a problem with Wine may prevent games in Flashpoint from working. Look for the following error in the Logs tab of the launcher:
wine: 'examplewinedirectory/.wine' is a 64-bit installation, it cannot be used with a 32-bit wineserver.
If you see this error, then run the following command to change the wineprefix that FP is trying to use.
sed -i "2 i export WINEPREFIX=$HOME/.wine_fp" "$HOME/opt/flashpoint/launcher/flashpoint"
Alternatively, if you are running low on disk space and don't care about the contents of the wineprefix, you can take a more destructive route: navigate to your Wine directory (usually, it's your home directory) and run the commands below to resolve the problem. Note that this deletes your current wineprefix.
rm -r .wine/
winecfg

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, it uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code>.

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.

=== Supported Platforms ===
* 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, then either turn off use Wine, or tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser. 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>. By default, Basilisk will store its configuration in the location defined by <code>XDG_CONFIG_DIR</code>, so Flashpoint uses a shell script to set the configuration location. A pre-configured copy of Basilisk, along with the shell script, is packaged and also available [https://drive.google.com/file/d/1Y5Mgm9dCa4gCc6UF5WFPqQruzsO81xhf/view?usp=sharing here]. This [https://cdn.discordapp.com/attachments/516027726851735632/612891261665411073/BasiliskSetup.txt text file] describes Basilisk's configuration.
* Java Applets: Supported natively using the OpenJDK. This support is not currently working, however.
* Unity Web Player: Supported through Wine. Unity 2.x and 3.x games may not work; this needs further testing.
* PopCap Plugin: Supported through Wine.
* Authorware Web Player: Supported through Wine.
* GoBit Plugin: Supported through Wine.

=== Unsupported Platforms ===
* Silverlight: In the past, [http://www.webupd8.org/2013/08/pipelight-use-silverlight-in-your-linux.html Pipelight] allowed Linux users to use Silverlight, but the repository is no longer available for most Linux distros. [https://www.maketecheasier.com/install-and-run-silverlight-in-linux/ Moonlight] was another option, but is also no longer available. Attempts to use Silverlight in K-Meleon using Wine have failed.
* 3DVIA Player: A previous tester received this error, which crashed K-Meleon: <code>Error: Access was denied while trying to open files in your profile directory</code>. We need another tester to help us narrow this down.
* 3D Groove GX: When the http_proxy variable is set, Groove Player downloads but fails to load the file. Maybe the registry method described [https://wiki.winehq.org/FAQ#How_do_I_configure_a_proxy.3F here] would work better, but this needs to be tested. Two of our testers received the following set of errors: [https://media.discordapp.net/attachments/496132309498724391/577330595609444352/unknown.png 1] [https://media.discordapp.net/attachments/496132309498724391/577330680678055948/unknown.png 2] [https://media.discordapp.net/attachments/496132309498724391/577330740396556309/unknown.png 3]
* ActiveX: 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.

== Wine ==
Most games rely on technology only available on Windows. A lot of these however can be run through Wine. If there is no native executable, or you have the Native Platform option unticked for the game's platform then the launcher will run it through Wine.

You may choose to use the native versions, in which case tick the platform under Native Platforms in Config.

If you wish to play games that rely on Wine, be sure to install the 32-bit version of Wine. There are links below to distro specific install guides:

* Ubuntu - https://wiki.winehq.org/Ubuntu
* Debian - https://wiki.debian.org/Wine#Installation_on_Debian_Jessie_and_newer
* Arch Linux - https://wiki.archlinux.org/index.php/Wine#Installation

=== Important Note ===

Update: As of Wine 6.0-rc1, Shockwave appears to be working again. If you are on 5.22, keep an eye out for an update from your distribution.

<s>As of Wine 5.22, the Shockwave wrappers are no longer launching. Avoid updating Wine until a fix is found.</s>

== Changelog ==

; 2021-07-26
: Added 10.0 Infinity package

; 2021-02-16
: Added Core/Ultimate standalone package for 9.0 based on 8.1 Infinity standalone

; 2020-11-07
: Updated .deb to Flashpoint 8.2-2 Infinity
: Added native executables for Flash and HTML5
: Replaced modified Flash Projectors with the unmodified ones
: Fixed extreme games option being disabled in config.json

; 2020-10-23
: Updated .deb to Flashpoint 8.2-1 Infinity

; 2020-07-04
: Updated to Flashpoint 8.1 Infinity
: Updated to Flashpoint Launcher 9.0.2

; 2019-09-28
: Updated to Flashpoint 6.3
: Bundled WIP Launcher with better Multi-Platform Support:
:* Proper linux argument escaping (Supersonic RC works now, yay!)
:* SPR games automatically use port 22500 (Hacky, may be removed later)
:* Wine will always (and only) be used for running .exe files (even if use Wine is turned off in Config)
:* .bat files will always run their .sh equivalents (even if use Wine is turned on in Config)
:* Windows execs are mapped to native execs (if existing), so Windows game XMLs should work out the box. (See execs.json)
:* Can mark a platform as 'native' in Config, will force native execs to be used instead of Windows execs even if use Wine is turned on.
:** If no native execs are available (like Shockwave) then it will fallback to running the Windows exec with Wine.
: Added native Basilisk support files
: Updated SPR files
: Updated router.php

; 2019-09-18
: Added new SPR version (see update-spr.sh) and Shockwave XMLs
: Added interim Launcher hack to make Shockwave games that use SPR work properly
: Made the save manager scripts use a valid interpreter (/bin/sh)
:* TODO: they still need further work/testing

; 2019-07-21 and prior
: 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
: Adds Linux versions of the Save Manager scripts
: Adds a "Flashpoint" shortcut (replacing the Windows version)
: Adds Flashpoint 6.2 games
: Removed the game logos, as in Flashpoint Infinity 6.2 for Windows
: Removed the Wineprefix because it was not used

'''To-Do List'''
* Allow the launcher to automatically start/stop the flashpoint server on Linux
* Rewrite and test startUnity.sh and startJava.sh scripts
* Find a way to get Basilisk working better in Wine, or use an alternative browser like K-Meleon
* Get Java working natively again with OpenJDK 8
* Test Unity 2.x and 3.x games
* AMF support for games like Neon Rider for the community levels

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

Linux Support

2022-02-05T19:31:24Z

Ardil: Add chmod and put FP path-changing instructions in the right place, thanks CheeseBoye.

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

Unfortunately, no up-to-date Flashpoint packages are currently available. There are a few options to get Flashpoint running:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is your best bet right now.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.
* Download the outdated Flashpoint 10.0 package and [[#Manual Installation (for advanced users)|manually update it]] to get it working. This should work more consistently, as long as you are able to follow all of the steps.

== Stand-Alone Packages ==

These are standalone packages suitable for all common Linux distributions.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages/]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Distro-specific Packages ==

These are experimental packages for specific Linux distributions. If you don't see a package for your system here, '''please use the stand-alone package instead!''' If you can help update these packages, please visit the Discord server and join #development-chat.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages|Outdated Packages]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Manual Installation (for advanced users) ==

No up-to-date Flashpoint packages for Linux are currently available, but with a few extra steps, you can download the outdated Flashpoint 10.0 package and update it to work again. The steps for doing so are below.

=== Dependencies ===
{| class="wikitable"
!colspan="9"|Dependency package names on various distros
|-
!Library/command name
!git
!7z
!tar
!wine32
!wget
!glibc>=2.29
!php
!qemu-system-i386
|-
!Debian
|git
|p7zip
|tar
|[https://wiki.winehq.org/Debian winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Ubuntu, Linux Mint
|git
|p7zip
|tar
|[https://wiki.winehq.org/Ubuntu winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Fedora-like
|git
|p7zip
|tar
|[https://wiki.winehq.org/Fedora winehq-stable]
|wget
|glibc
|php
|qemu
|-
!Arch-like
|git
|p7zip
|tar
|[https://wiki.archlinux.org/title/wine#Installation wine]
|wget
|glibc
|php
|qemu-arch-extra
|}
To install wine, follow the linked instructions.

For all other packages, install them through your distro's package manager:
{|class="wikitable"
!Distro
!Package manager install command
|-
!Debian
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Ubuntu, Linux Mint
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Fedora-like
|<code>sudo dnf install {PACKAGE}</code>
|-
!Fedora-like (old)
|<code>sudo yum install {PACKAGE}</code>
|-
!Arch-like
|<code>sudo pacman -S {PACKAGE}</code>
|}

=== Installation ===
Open a new terminal and enter the following commands:
# Change the working directory to your home directory
cd
# Create the required directories
mkdir --verbose --parents opt/flashpoint/{launcher,data}
# Get the new flashpoint launcher (version 10.1.1)
cd opt/flashpoint/launcher
wget https://github.com/FlashpointProject/launcher/releases/download/10.1.1/Flashpoint-10.1.1_linux-x64.7z
7z x ./Flashpoint-10.1.1_linux-x64.7z
rm -v Flashpoint-10.1.1_linux-x64.7z
# Because PHP and QEMU are not killed correctly upon exit, create this launch script:
cat << EOF > flashpoint
#!/bin/sh
cd $HOME/opt/flashpoint/launcher
$HOME/opt/flashpoint/launcher/flashpoint-launcher
killall php
killall qemu-system-i386
EOF
chmod +x flashpoint
# Get Flashpoint 10.0 Infinity
cd ../data
wget https://bluepload.unstable.life/flashpoint-10-linux-x64.tar.gz
tar --extract --verbose --file=./flashpoint-10-linux-x64.tar.gz
rm --verbose ./flashpoint-10-linux-x64.tar.gz

Open flashpoint using the command <code>./flashpoint</code>. Go to Config, set the Flashpoint Path (in the "Flashpoint" section) to <code>../data</code>, and then scroll down and click the "Save & Restart" button.

=== Fix qemu failing to start ===
Execute the following command:
qemu-system-i386 -machine help | grep pc-i440fx-6.0
If that command outputs "pc-i440fx-6.0 Standard PC (i440FX + PIIX, 1996)" then open the file opt/flashpoint/data/Data/services.json and change the line 34 from:
"arguments": ["-m", "512", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
to
"arguments": ["-m", "512", "-machine", "pc-i440fx-6.0", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
Note that comments are not allowed in the json files.

If there is no output to the command "qemu-system-i386 -machine help | grep pc-i440fx-6.0" start qemu with the following command:
qemu-system-i386 -m 512 -net nic,model=e1000 -net user,hostfwd=tcp:127.0.0.1:22500-:80 -hda ~/opt/flashpoint/data/Server/alpine.qcow2
Wait for the alpine system to boot up and open the View menu and select compatmonitor0 and type the commands:
delvm quick
savevm quick
quit

== Troubleshooting ==

If the Flash Player crashes immediately when launched, there are a few possible solutions:
* Replace our hacked Flash projector with the original, unhacked Adobe Flash projector. Follow these steps:
*# [https://drive.google.com/file/d/1Dt3EGqB6SmfM1hkGszUMnYYlNo7RtlhD/view?usp=sharing Download the projector from here]
*# In your Flashpoint folder, open <code>FPSoftware/Flash</code>
*# Replace the <code>flashplayer_32_sa.exe</code> file with the one you downloaded.
* Remove wine-dxvk from your system. This causes problems with the Flash projector on some computers.

In some cases, a problem with Wine may prevent games in Flashpoint from working. Look for the following error in the Logs tab of the launcher:
wine: 'examplewinedirectory/.wine' is a 64-bit installation, it cannot be used with a 32-bit wineserver.
If you see this error, then run the following command to change the wineprefix that FP is trying to use.
sed -i "2 i export WINEPREFIX=$HOME/.wine_fp" "$HOME/opt/flashpoint/launcher/flashpoint"
Alternatively, if you are running low on disk space and don't care about the contents of the wineprefix, you can take a more destructive route: navigate to your Wine directory (usually, it's your home directory) and run the commands below to resolve the problem. Note that this deletes your current wineprefix.
rm -r .wine/
winecfg

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, it uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code>.

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.

=== Supported Platforms ===
* 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, then either turn off use Wine, or tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser. 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>. By default, Basilisk will store its configuration in the location defined by <code>XDG_CONFIG_DIR</code>, so Flashpoint uses a shell script to set the configuration location. A pre-configured copy of Basilisk, along with the shell script, is packaged and also available [https://drive.google.com/file/d/1Y5Mgm9dCa4gCc6UF5WFPqQruzsO81xhf/view?usp=sharing here]. This [https://cdn.discordapp.com/attachments/516027726851735632/612891261665411073/BasiliskSetup.txt text file] describes Basilisk's configuration.
* Java Applets: Supported natively using the OpenJDK. This support is not currently working, however.
* Unity Web Player: Supported through Wine. Unity 2.x and 3.x games may not work; this needs further testing.
* PopCap Plugin: Supported through Wine.
* Authorware Web Player: Supported through Wine.
* GoBit Plugin: Supported through Wine.

=== Unsupported Platforms ===
* Silverlight: In the past, [http://www.webupd8.org/2013/08/pipelight-use-silverlight-in-your-linux.html Pipelight] allowed Linux users to use Silverlight, but the repository is no longer available for most Linux distros. [https://www.maketecheasier.com/install-and-run-silverlight-in-linux/ Moonlight] was another option, but is also no longer available. Attempts to use Silverlight in K-Meleon using Wine have failed.
* 3DVIA Player: A previous tester received this error, which crashed K-Meleon: <code>Error: Access was denied while trying to open files in your profile directory</code>. We need another tester to help us narrow this down.
* 3D Groove GX: When the http_proxy variable is set, Groove Player downloads but fails to load the file. Maybe the registry method described [https://wiki.winehq.org/FAQ#How_do_I_configure_a_proxy.3F here] would work better, but this needs to be tested. Two of our testers received the following set of errors: [https://media.discordapp.net/attachments/496132309498724391/577330595609444352/unknown.png 1] [https://media.discordapp.net/attachments/496132309498724391/577330680678055948/unknown.png 2] [https://media.discordapp.net/attachments/496132309498724391/577330740396556309/unknown.png 3]
* ActiveX: 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.

== Wine ==
Most games rely on technology only available on Windows. A lot of these however can be run through Wine. If there is no native executable, or you have the Native Platform option unticked for the game's platform then the launcher will run it through Wine.

You may choose to use the native versions, in which case tick the platform under Native Platforms in Config.

If you wish to play games that rely on Wine, be sure to install the 32-bit version of Wine. There are links below to distro specific install guides:

* Ubuntu - https://wiki.winehq.org/Ubuntu
* Debian - https://wiki.debian.org/Wine#Installation_on_Debian_Jessie_and_newer
* Arch Linux - https://wiki.archlinux.org/index.php/Wine#Installation

=== Important Note ===

Update: As of Wine 6.0-rc1, Shockwave appears to be working again. If you are on 5.22, keep an eye out for an update from your distribution.

<s>As of Wine 5.22, the Shockwave wrappers are no longer launching. Avoid updating Wine until a fix is found.</s>

== Changelog ==

; 2021-07-26
: Added 10.0 Infinity package

; 2021-02-16
: Added Core/Ultimate standalone package for 9.0 based on 8.1 Infinity standalone

; 2020-11-07
: Updated .deb to Flashpoint 8.2-2 Infinity
: Added native executables for Flash and HTML5
: Replaced modified Flash Projectors with the unmodified ones
: Fixed extreme games option being disabled in config.json

; 2020-10-23
: Updated .deb to Flashpoint 8.2-1 Infinity

; 2020-07-04
: Updated to Flashpoint 8.1 Infinity
: Updated to Flashpoint Launcher 9.0.2

; 2019-09-28
: Updated to Flashpoint 6.3
: Bundled WIP Launcher with better Multi-Platform Support:
:* Proper linux argument escaping (Supersonic RC works now, yay!)
:* SPR games automatically use port 22500 (Hacky, may be removed later)
:* Wine will always (and only) be used for running .exe files (even if use Wine is turned off in Config)
:* .bat files will always run their .sh equivalents (even if use Wine is turned on in Config)
:* Windows execs are mapped to native execs (if existing), so Windows game XMLs should work out the box. (See execs.json)
:* Can mark a platform as 'native' in Config, will force native execs to be used instead of Windows execs even if use Wine is turned on.
:** If no native execs are available (like Shockwave) then it will fallback to running the Windows exec with Wine.
: Added native Basilisk support files
: Updated SPR files
: Updated router.php

; 2019-09-18
: Added new SPR version (see update-spr.sh) and Shockwave XMLs
: Added interim Launcher hack to make Shockwave games that use SPR work properly
: Made the save manager scripts use a valid interpreter (/bin/sh)
:* TODO: they still need further work/testing

; 2019-07-21 and prior
: 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
: Adds Linux versions of the Save Manager scripts
: Adds a "Flashpoint" shortcut (replacing the Windows version)
: Adds Flashpoint 6.2 games
: Removed the game logos, as in Flashpoint Infinity 6.2 for Windows
: Removed the Wineprefix because it was not used

'''To-Do List'''
* Allow the launcher to automatically start/stop the flashpoint server on Linux
* Rewrite and test startUnity.sh and startJava.sh scripts
* Find a way to get Basilisk working better in Wine, or use an alternative browser like K-Meleon
* Get Java working natively again with OpenJDK 8
* Test Unity 2.x and 3.x games
* AMF support for games like Neon Rider for the community levels

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

Linux Support

2022-01-31T19:59:43Z

Ardil: Note that comments are not allowed in json.

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

Unfortunately, no up-to-date Flashpoint packages are currently available. There are a few options to get Flashpoint running:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is your best bet right now.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.
* Download the outdated Flashpoint 10.0 package and [[#Manual Installation (for advanced users)|manually update it]] to get it working. This should work more consistently, as long as you are able to follow all of the steps.

== Stand-Alone Packages ==

These are standalone packages suitable for all common Linux distributions.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages/]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Distro-specific Packages ==

These are experimental packages for specific Linux distributions. If you don't see a package for your system here, '''please use the stand-alone package instead!''' If you can help update these packages, please visit the Discord server and join #development-chat.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages|Outdated Packages]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Manual Installation (for advanced users) ==

No up-to-date Flashpoint packages for Linux are currently available, but with a few extra steps, you can download the outdated Flashpoint 10.0 package and update it to work again. The steps for doing so are below.

=== Dependencies ===
{| class="wikitable"
!colspan="9"|Dependency package names on various distros
|-
!Library/command name
!git
!7z
!tar
!wine32
!wget
!glibc>=2.29
!php
!qemu-system-i386
|-
!Debian
|git
|p7zip
|tar
|[https://wiki.winehq.org/Debian winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Ubuntu, Linux Mint
|git
|p7zip
|tar
|[https://wiki.winehq.org/Ubuntu winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Fedora-like
|git
|p7zip
|tar
|[https://wiki.winehq.org/Fedora winehq-stable]
|wget
|glibc
|php
|qemu
|-
!Arch-like
|git
|p7zip
|tar
|[https://wiki.archlinux.org/title/wine#Installation wine]
|wget
|glibc
|php
|qemu-arch-extra
|}
To install wine, follow the linked instructions.

For all other packages, install them through your distro's package manager:
{|class="wikitable"
!Distro
!Package manager install command
|-
!Debian
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Ubuntu, Linux Mint
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Fedora-like
|<code>sudo dnf install {PACKAGE}</code>
|-
!Fedora-like (old)
|<code>sudo yum install {PACKAGE}</code>
|-
!Arch-like
|<code>sudo pacman -S {PACKAGE}</code>
|}

=== Installation ===
Open a new terminal and enter the following commands:
# Change the working directory to your home directory
cd
# Create the required directories
mkdir --verbose --parents opt/flashpoint/{launcher,data}
# Get the new flashpoint launcher (version 10.1.1)
cd opt/flashpoint/launcher
wget https://github.com/FlashpointProject/launcher/releases/download/10.1.1/Flashpoint-10.1.1_linux-x64.7z
7z x ./Flashpoint-10.1.1_linux-x64.7z
rm -v Flashpoint-10.1.1_linux-x64.7z
# Because PHP and QEMU are not killed correctly upon exit, create this launch script:
cat << EOF > flashpoint
#!/bin/sh
cd $HOME/opt/flashpoint/launcher
$HOME/opt/flashpoint/launcher/flashpoint-launcher
killall php
killall qemu-system-i386
EOF
# Get Flashpoint 10.0 Infinity
cd ../data
wget https://bluepload.unstable.life/flashpoint-10-linux-x64.tar.gz
tar --extract --verbose --file=./flashpoint-10-linux-x64.tar.gz
rm --verbose ./flashpoint-10-linux-x64.tar.gz

=== Fix qemu failing to start ===
Execute the following command:
qemu-system-i386 -machine help | grep pc-i440fx-6.0
If that command outputs "pc-i440fx-6.0 Standard PC (i440FX + PIIX, 1996)" then open the file opt/flashpoint/data/services.json and change the line 34 from:
"arguments": ["-m", "512", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
to
"arguments": ["-m", "512", "-machine", "pc-i440fx-6.0", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
Note that comments are not allowed in the json files.

If there is no output to the command "qemu-system-i386 -machine help | grep pc-i440fx-6.0" start qemu with the following command:
qemu-system-i386 -m 512 -net nic,model=e1000 -net user,hostfwd=tcp:127.0.0.1:22500-:80 -hda ~/opt/flashpoint/data/Server/alpine.qcow2
Wait for the alpine system to boot up and open the View menu and select compatmonitor0 and type the commands:
delvm quick
savevm quick
quit
Open flashpoint with the command "flashpoint" and then go to Config and on the Flashpoint section set the Flashpoint Path to ../data then scroll down and click on the "Save & Restart" button.

== Troubleshooting ==

If the Flash Player crashes immediately when launched, there are a few possible solutions:
* Replace our hacked Flash projector with the original, unhacked Adobe Flash projector. Follow these steps:
*# [https://drive.google.com/file/d/1Dt3EGqB6SmfM1hkGszUMnYYlNo7RtlhD/view?usp=sharing Download the projector from here]
*# In your Flashpoint folder, open <code>FPSoftware/Flash</code>
*# Replace the <code>flashplayer_32_sa.exe</code> file with the one you downloaded.
* Remove wine-dxvk from your system. This causes problems with the Flash projector on some computers.

In some cases, a problem with Wine may prevent games in Flashpoint from working. Look for the following error in the Logs tab of the launcher:
wine: 'examplewinedirectory/.wine' is a 64-bit installation, it cannot be used with a 32-bit wineserver.
If you see this error, then run the following command to change the wineprefix that FP is trying to use.
sed -i "2 i export WINEPREFIX=$HOME/.wine_fp" "$HOME/opt/flashpoint/launcher/flashpoint"
Alternatively, if you are running low on disk space and don't care about the contents of the wineprefix, you can take a more destructive route: navigate to your Wine directory (usually, it's your home directory) and run the commands below to resolve the problem. Note that this deletes your current wineprefix.
rm -r .wine/
winecfg

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, it uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code>.

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.

=== Supported Platforms ===
* 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, then either turn off use Wine, or tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser. 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>. By default, Basilisk will store its configuration in the location defined by <code>XDG_CONFIG_DIR</code>, so Flashpoint uses a shell script to set the configuration location. A pre-configured copy of Basilisk, along with the shell script, is packaged and also available [https://drive.google.com/file/d/1Y5Mgm9dCa4gCc6UF5WFPqQruzsO81xhf/view?usp=sharing here]. This [https://cdn.discordapp.com/attachments/516027726851735632/612891261665411073/BasiliskSetup.txt text file] describes Basilisk's configuration.
* Java Applets: Supported natively using the OpenJDK. This support is not currently working, however.
* Unity Web Player: Supported through Wine. Unity 2.x and 3.x games may not work; this needs further testing.
* PopCap Plugin: Supported through Wine.
* Authorware Web Player: Supported through Wine.
* GoBit Plugin: Supported through Wine.

=== Unsupported Platforms ===
* Silverlight: In the past, [http://www.webupd8.org/2013/08/pipelight-use-silverlight-in-your-linux.html Pipelight] allowed Linux users to use Silverlight, but the repository is no longer available for most Linux distros. [https://www.maketecheasier.com/install-and-run-silverlight-in-linux/ Moonlight] was another option, but is also no longer available. Attempts to use Silverlight in K-Meleon using Wine have failed.
* 3DVIA Player: A previous tester received this error, which crashed K-Meleon: <code>Error: Access was denied while trying to open files in your profile directory</code>. We need another tester to help us narrow this down.
* 3D Groove GX: When the http_proxy variable is set, Groove Player downloads but fails to load the file. Maybe the registry method described [https://wiki.winehq.org/FAQ#How_do_I_configure_a_proxy.3F here] would work better, but this needs to be tested. Two of our testers received the following set of errors: [https://media.discordapp.net/attachments/496132309498724391/577330595609444352/unknown.png 1] [https://media.discordapp.net/attachments/496132309498724391/577330680678055948/unknown.png 2] [https://media.discordapp.net/attachments/496132309498724391/577330740396556309/unknown.png 3]
* ActiveX: 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.

== Wine ==
Most games rely on technology only available on Windows. A lot of these however can be run through Wine. If there is no native executable, or you have the Native Platform option unticked for the game's platform then the launcher will run it through Wine.

You may choose to use the native versions, in which case tick the platform under Native Platforms in Config.

If you wish to play games that rely on Wine, be sure to install the 32-bit version of Wine. There are links below to distro specific install guides:

* Ubuntu - https://wiki.winehq.org/Ubuntu
* Debian - https://wiki.debian.org/Wine#Installation_on_Debian_Jessie_and_newer
* Arch Linux - https://wiki.archlinux.org/index.php/Wine#Installation

=== Important Note ===

Update: As of Wine 6.0-rc1, Shockwave appears to be working again. If you are on 5.22, keep an eye out for an update from your distribution.

<s>As of Wine 5.22, the Shockwave wrappers are no longer launching. Avoid updating Wine until a fix is found.</s>

== Changelog ==

; 2021-07-26
: Added 10.0 Infinity package

; 2021-02-16
: Added Core/Ultimate standalone package for 9.0 based on 8.1 Infinity standalone

; 2020-11-07
: Updated .deb to Flashpoint 8.2-2 Infinity
: Added native executables for Flash and HTML5
: Replaced modified Flash Projectors with the unmodified ones
: Fixed extreme games option being disabled in config.json

; 2020-10-23
: Updated .deb to Flashpoint 8.2-1 Infinity

; 2020-07-04
: Updated to Flashpoint 8.1 Infinity
: Updated to Flashpoint Launcher 9.0.2

; 2019-09-28
: Updated to Flashpoint 6.3
: Bundled WIP Launcher with better Multi-Platform Support:
:* Proper linux argument escaping (Supersonic RC works now, yay!)
:* SPR games automatically use port 22500 (Hacky, may be removed later)
:* Wine will always (and only) be used for running .exe files (even if use Wine is turned off in Config)
:* .bat files will always run their .sh equivalents (even if use Wine is turned on in Config)
:* Windows execs are mapped to native execs (if existing), so Windows game XMLs should work out the box. (See execs.json)
:* Can mark a platform as 'native' in Config, will force native execs to be used instead of Windows execs even if use Wine is turned on.
:** If no native execs are available (like Shockwave) then it will fallback to running the Windows exec with Wine.
: Added native Basilisk support files
: Updated SPR files
: Updated router.php

; 2019-09-18
: Added new SPR version (see update-spr.sh) and Shockwave XMLs
: Added interim Launcher hack to make Shockwave games that use SPR work properly
: Made the save manager scripts use a valid interpreter (/bin/sh)
:* TODO: they still need further work/testing

; 2019-07-21 and prior
: 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
: Adds Linux versions of the Save Manager scripts
: Adds a "Flashpoint" shortcut (replacing the Windows version)
: Adds Flashpoint 6.2 games
: Removed the game logos, as in Flashpoint Infinity 6.2 for Windows
: Removed the Wineprefix because it was not used

'''To-Do List'''
* Allow the launcher to automatically start/stop the flashpoint server on Linux
* Rewrite and test startUnity.sh and startJava.sh scripts
* Find a way to get Basilisk working better in Wine, or use an alternative browser like K-Meleon
* Get Java working natively again with OpenJDK 8
* Test Unity 2.x and 3.x games
* AMF support for games like Neon Rider for the community levels

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

Linux Support

2022-01-27T20:25:09Z

Ardil: /* Dependencies */ Add package manager command table.

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

Unfortunately, no up-to-date Flashpoint packages are currently available. There are a few options to get Flashpoint running:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is your best bet right now.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.
* Download the outdated Flashpoint 10.0 package and [[#Manual Installation (for advanced users)|manually update it]] to get it working. This should work more consistently, as long as you are able to follow all of the steps.

== Stand-Alone Packages ==

These are standalone packages suitable for all common Linux distributions.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages/]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Distro-specific Packages ==

These are experimental packages for specific Linux distributions. If you don't see a package for your system here, '''please use the stand-alone package instead!''' If you can help update these packages, please visit the Discord server and join #development-chat.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages|Outdated Packages]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Manual Installation (for advanced users) ==

No up-to-date Flashpoint packages for Linux are currently available, but with a few extra steps, you can download the outdated Flashpoint 10.0 package and update it to work again. The steps for doing so are below.

=== Dependencies ===
{| class="wikitable"
!colspan="9"|Dependency package names on various distros
|-
!Library/command name
!git
!7z
!tar
!wine32
!wget
!glibc>=2.29
!php
!qemu-system-i386
|-
!Debian
|git
|p7zip
|tar
|[https://wiki.winehq.org/Debian winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Ubuntu, Linux Mint
|git
|p7zip
|tar
|[https://wiki.winehq.org/Ubuntu winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Fedora-like
|git
|p7zip
|tar
|[https://wiki.winehq.org/Fedora winehq-stable]
|wget
|glibc
|php
|qemu
|-
!Arch-like
|git
|p7zip
|tar
|[https://wiki.archlinux.org/title/wine#Installation wine]
|wget
|glibc
|php
|qemu-arch-extra
|}
To install wine, follow the linked instructions.

For all other packages, install them through your distro's package manager:
{|class="wikitable"
!Distro
!Package manager install command
|-
!Debian
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Ubuntu, Linux Mint
|<code>sudo apt-get install {PACKAGE}</code>
|-
!Fedora-like
|<code>sudo dnf install {PACKAGE}</code>
|-
!Fedora-like (old)
|<code>sudo yum install {PACKAGE}</code>
|-
!Arch-like
|<code>sudo pacman -S {PACKAGE}</code>
|}

=== Installation ===
Open a new terminal and enter the following commands:
# Change the working directory to your home directory
cd
# Create the required directories
mkdir --verbose --parents opt/flashpoint/{launcher,data}
# Get the new flashpoint launcher (version 10.1.1)
cd opt/flashpoint/launcher
wget https://github.com/FlashpointProject/launcher/releases/download/10.1.1/Flashpoint-10.1.1_linux-x64.7z
7z x ./Flashpoint-10.1.1_linux-x64.7z
rm -v Flashpoint-10.1.1_linux-x64.7z
# Because PHP and QEMU are not killed correctly upon exit, create this launch script:
cat << EOF > flashpoint
#!/bin/sh
cd $HOME/opt/flashpoint/launcher
$HOME/opt/flashpoint/launcher/flashpoint-launcher
killall php
killall qemu-system-i386
EOF
# Get Flashpoint 10.0 Infinity
cd ../data
wget https://bluepload.unstable.life/flashpoint-10-linux-x64.tar.gz
tar --extract --verbose --file=./flashpoint-10-linux-x64.tar.gz
rm --verbose ./flashpoint-10-linux-x64.tar.gz

=== Fix qemu failing to start ===
Execute the following command:
qemu-system-i386 -machine help | grep pc-i440fx-6.0
If that command outputs "pc-i440fx-6.0 Standard PC (i440FX + PIIX, 1996)" then open the file opt/flashpoint/data/services.json and change the line 34 from:
"arguments": ["-m", "512", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
to
"arguments": ["-m", "512", "-machine", "pc-i440fx-6.0", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
If there is no output to the command "qemu-system-i386 -machine help | grep pc-i440fx-6.0" start qemu with the following command:
qemu-system-i386 -m 512 -net nic,model=e1000 -net user,hostfwd=tcp:127.0.0.1:22500-:80 -hda ~/opt/flashpoint/data/Server/alpine.qcow2
Wait for the alpine system to boot up and open the View menu and select compatmonitor0 and type the commands:
delvm quick
savevm quick
quit
Open flashpoint with the command "flashpoint" and then go to Config and on the Flashpoint section set the Flashpoint Path to ../data then scroll down and click on the "Save & Restart" button.

== Troubleshooting ==

If the Flash Player crashes immediately when launched, there are a few possible solutions:
* Replace our hacked Flash projector with the original, unhacked Adobe Flash projector. Follow these steps:
*# [https://drive.google.com/file/d/1Dt3EGqB6SmfM1hkGszUMnYYlNo7RtlhD/view?usp=sharing Download the projector from here]
*# In your Flashpoint folder, open <code>FPSoftware/Flash</code>
*# Replace the <code>flashplayer_32_sa.exe</code> file with the one you downloaded.
* Remove wine-dxvk from your system. This causes problems with the Flash projector on some computers.

In some cases, a problem with Wine may prevent games in Flashpoint from working. Look for the following error in the Logs tab of the launcher:
wine: 'examplewinedirectory/.wine' is a 64-bit installation, it cannot be used with a 32-bit wineserver.
If you see this error, then run the following command to change the wineprefix that FP is trying to use.
sed -i "2 i export WINEPREFIX=$HOME/.wine_fp" "$HOME/opt/flashpoint/launcher/flashpoint"
Alternatively, if you are running low on disk space and don't care about the contents of the wineprefix, you can take a more destructive route: navigate to your Wine directory (usually, it's your home directory) and run the commands below to resolve the problem. Note that this deletes your current wineprefix.
rm -r .wine/
winecfg

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, it uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code>.

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.

=== Supported Platforms ===
* 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, then either turn off use Wine, or tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser. 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>. By default, Basilisk will store its configuration in the location defined by <code>XDG_CONFIG_DIR</code>, so Flashpoint uses a shell script to set the configuration location. A pre-configured copy of Basilisk, along with the shell script, is packaged and also available [https://drive.google.com/file/d/1Y5Mgm9dCa4gCc6UF5WFPqQruzsO81xhf/view?usp=sharing here]. This [https://cdn.discordapp.com/attachments/516027726851735632/612891261665411073/BasiliskSetup.txt text file] describes Basilisk's configuration.
* Java Applets: Supported natively using the OpenJDK. This support is not currently working, however.
* Unity Web Player: Supported through Wine. Unity 2.x and 3.x games may not work; this needs further testing.
* PopCap Plugin: Supported through Wine.
* Authorware Web Player: Supported through Wine.
* GoBit Plugin: Supported through Wine.

=== Unsupported Platforms ===
* Silverlight: In the past, [http://www.webupd8.org/2013/08/pipelight-use-silverlight-in-your-linux.html Pipelight] allowed Linux users to use Silverlight, but the repository is no longer available for most Linux distros. [https://www.maketecheasier.com/install-and-run-silverlight-in-linux/ Moonlight] was another option, but is also no longer available. Attempts to use Silverlight in K-Meleon using Wine have failed.
* 3DVIA Player: A previous tester received this error, which crashed K-Meleon: <code>Error: Access was denied while trying to open files in your profile directory</code>. We need another tester to help us narrow this down.
* 3D Groove GX: When the http_proxy variable is set, Groove Player downloads but fails to load the file. Maybe the registry method described [https://wiki.winehq.org/FAQ#How_do_I_configure_a_proxy.3F here] would work better, but this needs to be tested. Two of our testers received the following set of errors: [https://media.discordapp.net/attachments/496132309498724391/577330595609444352/unknown.png 1] [https://media.discordapp.net/attachments/496132309498724391/577330680678055948/unknown.png 2] [https://media.discordapp.net/attachments/496132309498724391/577330740396556309/unknown.png 3]
* ActiveX: 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.

== Wine ==
Most games rely on technology only available on Windows. A lot of these however can be run through Wine. If there is no native executable, or you have the Native Platform option unticked for the game's platform then the launcher will run it through Wine.

You may choose to use the native versions, in which case tick the platform under Native Platforms in Config.

If you wish to play games that rely on Wine, be sure to install the 32-bit version of Wine. There are links below to distro specific install guides:

* Ubuntu - https://wiki.winehq.org/Ubuntu
* Debian - https://wiki.debian.org/Wine#Installation_on_Debian_Jessie_and_newer
* Arch Linux - https://wiki.archlinux.org/index.php/Wine#Installation

=== Important Note ===

Update: As of Wine 6.0-rc1, Shockwave appears to be working again. If you are on 5.22, keep an eye out for an update from your distribution.

<s>As of Wine 5.22, the Shockwave wrappers are no longer launching. Avoid updating Wine until a fix is found.</s>

== Changelog ==

; 2021-07-26
: Added 10.0 Infinity package

; 2021-02-16
: Added Core/Ultimate standalone package for 9.0 based on 8.1 Infinity standalone

; 2020-11-07
: Updated .deb to Flashpoint 8.2-2 Infinity
: Added native executables for Flash and HTML5
: Replaced modified Flash Projectors with the unmodified ones
: Fixed extreme games option being disabled in config.json

; 2020-10-23
: Updated .deb to Flashpoint 8.2-1 Infinity

; 2020-07-04
: Updated to Flashpoint 8.1 Infinity
: Updated to Flashpoint Launcher 9.0.2

; 2019-09-28
: Updated to Flashpoint 6.3
: Bundled WIP Launcher with better Multi-Platform Support:
:* Proper linux argument escaping (Supersonic RC works now, yay!)
:* SPR games automatically use port 22500 (Hacky, may be removed later)
:* Wine will always (and only) be used for running .exe files (even if use Wine is turned off in Config)
:* .bat files will always run their .sh equivalents (even if use Wine is turned on in Config)
:* Windows execs are mapped to native execs (if existing), so Windows game XMLs should work out the box. (See execs.json)
:* Can mark a platform as 'native' in Config, will force native execs to be used instead of Windows execs even if use Wine is turned on.
:** If no native execs are available (like Shockwave) then it will fallback to running the Windows exec with Wine.
: Added native Basilisk support files
: Updated SPR files
: Updated router.php

; 2019-09-18
: Added new SPR version (see update-spr.sh) and Shockwave XMLs
: Added interim Launcher hack to make Shockwave games that use SPR work properly
: Made the save manager scripts use a valid interpreter (/bin/sh)
:* TODO: they still need further work/testing

; 2019-07-21 and prior
: 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
: Adds Linux versions of the Save Manager scripts
: Adds a "Flashpoint" shortcut (replacing the Windows version)
: Adds Flashpoint 6.2 games
: Removed the game logos, as in Flashpoint Infinity 6.2 for Windows
: Removed the Wineprefix because it was not used

'''To-Do List'''
* Allow the launcher to automatically start/stop the flashpoint server on Linux
* Rewrite and test startUnity.sh and startJava.sh scripts
* Find a way to get Basilisk working better in Wine, or use an alternative browser like K-Meleon
* Get Java working natively again with OpenJDK 8
* Test Unity 2.x and 3.x games
* AMF support for games like Neon Rider for the community levels

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

Linux Support

2022-01-27T17:26:27Z

Ardil: Add dependency table for multiple distros.

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

Unfortunately, no up-to-date Flashpoint packages are currently available. There are a few options to get Flashpoint running:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is your best bet right now.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.
* Download the outdated Flashpoint 10.0 package and [[#Manual Installation (for advanced users)|manually update it]] to get it working. This should work more consistently, as long as you are able to follow all of the steps.

== Stand-Alone Packages ==

These are standalone packages suitable for all common Linux distributions.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages/]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Distro-specific Packages ==

These are experimental packages for specific Linux distributions. If you don't see a package for your system here, '''please use the stand-alone package instead!''' If you can help update these packages, please visit the Discord server and join #development-chat.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages|Outdated Packages]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Manual Installation (for advanced users) ==

No up-to-date Flashpoint packages for Linux are currently available, but with a few extra steps, you can download the outdated Flashpoint 10.0 package and update it to work again. The steps for doing so are below.

=== Dependencies ===
{| class="wikitable"
!colspan="9"|Dependency package names on various distros
|-
!Library/command name
!git
!7z
!tar
!wine32
!wget
!glibc>=2.29
!php
!qemu-system-i386
|-
!Debian
|git
|p7zip
|tar
|[https://wiki.winehq.org/Debian winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Ubuntu, Linux Mint
|git
|p7zip
|tar
|[https://wiki.winehq.org/Ubuntu winehq-stable]
|wget
|libc6
|php
|qemu-system-x86
|-
!Fedora-like
|git
|p7zip
|tar
|[https://wiki.winehq.org/Fedora winehq-stable]
|wget
|glibc
|php
|qemu
|-
!Arch-like
|git
|p7zip
|tar
|[https://wiki.archlinux.org/title/wine#Installation wine]
|wget
|glibc
|php
|qemu-arch-extra
|}
=== Installation ===
Open a new terminal and enter the following commands:
# Change the working directory to your home directory
cd
# Create the required directories
mkdir --verbose --parents opt/flashpoint/{launcher,data}
# Get the new flashpoint launcher (version 10.1.1)
cd opt/flashpoint/launcher
wget https://github.com/FlashpointProject/launcher/releases/download/10.1.1/Flashpoint-10.1.1_linux-x64.7z
7z x ./Flashpoint-10.1.1_linux-x64.7z
rm -v Flashpoint-10.1.1_linux-x64.7z
# Because PHP and QEMU are not killed correctly upon exit, create this launch script:
cat << EOF > flashpoint
#!/bin/sh
cd $HOME/opt/flashpoint/launcher
$HOME/opt/flashpoint/launcher/flashpoint-launcher
killall php
killall qemu-system-i386
EOF
# Get Flashpoint 10.0 Infinity
cd ../data
wget https://bluepload.unstable.life/flashpoint-10-linux-x64.tar.gz
tar --extract --verbose --file=./flashpoint-10-linux-x64.tar.gz
rm --verbose ./flashpoint-10-linux-x64.tar.gz

=== Fix qemu failing to start ===
Execute the following command:
qemu-system-i386 -machine help | grep pc-i440fx-6.0
If that command outputs "pc-i440fx-6.0 Standard PC (i440FX + PIIX, 1996)" then open the file opt/flashpoint/data/services.json and change the line 34 from:
"arguments": ["-m", "512", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
to
"arguments": ["-m", "512", "-machine", "pc-i440fx-6.0", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
If there is no output to the command "qemu-system-i386 -machine help | grep pc-i440fx-6.0" start qemu with the following command:
qemu-system-i386 -m 512 -net nic,model=e1000 -net user,hostfwd=tcp:127.0.0.1:22500-:80 -hda ~/opt/flashpoint/data/Server/alpine.qcow2
Wait for the alpine system to boot up and open the View menu and select compatmonitor0 and type the commands:
delvm quick
savevm quick
quit
Open flashpoint with the command "flashpoint" and then go to Config and on the Flashpoint section set the Flashpoint Path to ../data then scroll down and click on the "Save & Restart" button.

== Troubleshooting ==

If the Flash Player crashes immediately when launched, there are a few possible solutions:
* Replace our hacked Flash projector with the original, unhacked Adobe Flash projector. Follow these steps:
*# [https://drive.google.com/file/d/1Dt3EGqB6SmfM1hkGszUMnYYlNo7RtlhD/view?usp=sharing Download the projector from here]
*# In your Flashpoint folder, open <code>FPSoftware/Flash</code>
*# Replace the <code>flashplayer_32_sa.exe</code> file with the one you downloaded.
* Remove wine-dxvk from your system. This causes problems with the Flash projector on some computers.

In some cases, a problem with Wine may prevent games in Flashpoint from working. Look for the following error in the Logs tab of the launcher:
wine: 'examplewinedirectory/.wine' is a 64-bit installation, it cannot be used with a 32-bit wineserver.
If you see this error, then run the following command to change the wineprefix that FP is trying to use.
sed -i "2 i export WINEPREFIX=$HOME/.wine_fp" "$HOME/opt/flashpoint/launcher/flashpoint"
Alternatively, if you are running low on disk space and don't care about the contents of the wineprefix, you can take a more destructive route: navigate to your Wine directory (usually, it's your home directory) and run the commands below to resolve the problem. Note that this deletes your current wineprefix.
rm -r .wine/
winecfg

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, it uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code>.

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.

=== Supported Platforms ===
* 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, then either turn off use Wine, or tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser. 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>. By default, Basilisk will store its configuration in the location defined by <code>XDG_CONFIG_DIR</code>, so Flashpoint uses a shell script to set the configuration location. A pre-configured copy of Basilisk, along with the shell script, is packaged and also available [https://drive.google.com/file/d/1Y5Mgm9dCa4gCc6UF5WFPqQruzsO81xhf/view?usp=sharing here]. This [https://cdn.discordapp.com/attachments/516027726851735632/612891261665411073/BasiliskSetup.txt text file] describes Basilisk's configuration.
* Java Applets: Supported natively using the OpenJDK. This support is not currently working, however.
* Unity Web Player: Supported through Wine. Unity 2.x and 3.x games may not work; this needs further testing.
* PopCap Plugin: Supported through Wine.
* Authorware Web Player: Supported through Wine.
* GoBit Plugin: Supported through Wine.

=== Unsupported Platforms ===
* Silverlight: In the past, [http://www.webupd8.org/2013/08/pipelight-use-silverlight-in-your-linux.html Pipelight] allowed Linux users to use Silverlight, but the repository is no longer available for most Linux distros. [https://www.maketecheasier.com/install-and-run-silverlight-in-linux/ Moonlight] was another option, but is also no longer available. Attempts to use Silverlight in K-Meleon using Wine have failed.
* 3DVIA Player: A previous tester received this error, which crashed K-Meleon: <code>Error: Access was denied while trying to open files in your profile directory</code>. We need another tester to help us narrow this down.
* 3D Groove GX: When the http_proxy variable is set, Groove Player downloads but fails to load the file. Maybe the registry method described [https://wiki.winehq.org/FAQ#How_do_I_configure_a_proxy.3F here] would work better, but this needs to be tested. Two of our testers received the following set of errors: [https://media.discordapp.net/attachments/496132309498724391/577330595609444352/unknown.png 1] [https://media.discordapp.net/attachments/496132309498724391/577330680678055948/unknown.png 2] [https://media.discordapp.net/attachments/496132309498724391/577330740396556309/unknown.png 3]
* ActiveX: 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.

== Wine ==
Most games rely on technology only available on Windows. A lot of these however can be run through Wine. If there is no native executable, or you have the Native Platform option unticked for the game's platform then the launcher will run it through Wine.

You may choose to use the native versions, in which case tick the platform under Native Platforms in Config.

If you wish to play games that rely on Wine, be sure to install the 32-bit version of Wine. There are links below to distro specific install guides:

* Ubuntu - https://wiki.winehq.org/Ubuntu
* Debian - https://wiki.debian.org/Wine#Installation_on_Debian_Jessie_and_newer
* Arch Linux - https://wiki.archlinux.org/index.php/Wine#Installation

=== Important Note ===

Update: As of Wine 6.0-rc1, Shockwave appears to be working again. If you are on 5.22, keep an eye out for an update from your distribution.

<s>As of Wine 5.22, the Shockwave wrappers are no longer launching. Avoid updating Wine until a fix is found.</s>

== Changelog ==

; 2021-07-26
: Added 10.0 Infinity package

; 2021-02-16
: Added Core/Ultimate standalone package for 9.0 based on 8.1 Infinity standalone

; 2020-11-07
: Updated .deb to Flashpoint 8.2-2 Infinity
: Added native executables for Flash and HTML5
: Replaced modified Flash Projectors with the unmodified ones
: Fixed extreme games option being disabled in config.json

; 2020-10-23
: Updated .deb to Flashpoint 8.2-1 Infinity

; 2020-07-04
: Updated to Flashpoint 8.1 Infinity
: Updated to Flashpoint Launcher 9.0.2

; 2019-09-28
: Updated to Flashpoint 6.3
: Bundled WIP Launcher with better Multi-Platform Support:
:* Proper linux argument escaping (Supersonic RC works now, yay!)
:* SPR games automatically use port 22500 (Hacky, may be removed later)
:* Wine will always (and only) be used for running .exe files (even if use Wine is turned off in Config)
:* .bat files will always run their .sh equivalents (even if use Wine is turned on in Config)
:* Windows execs are mapped to native execs (if existing), so Windows game XMLs should work out the box. (See execs.json)
:* Can mark a platform as 'native' in Config, will force native execs to be used instead of Windows execs even if use Wine is turned on.
:** If no native execs are available (like Shockwave) then it will fallback to running the Windows exec with Wine.
: Added native Basilisk support files
: Updated SPR files
: Updated router.php

; 2019-09-18
: Added new SPR version (see update-spr.sh) and Shockwave XMLs
: Added interim Launcher hack to make Shockwave games that use SPR work properly
: Made the save manager scripts use a valid interpreter (/bin/sh)
:* TODO: they still need further work/testing

; 2019-07-21 and prior
: 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
: Adds Linux versions of the Save Manager scripts
: Adds a "Flashpoint" shortcut (replacing the Windows version)
: Adds Flashpoint 6.2 games
: Removed the game logos, as in Flashpoint Infinity 6.2 for Windows
: Removed the Wineprefix because it was not used

'''To-Do List'''
* Allow the launcher to automatically start/stop the flashpoint server on Linux
* Rewrite and test startUnity.sh and startJava.sh scripts
* Find a way to get Basilisk working better in Wine, or use an alternative browser like K-Meleon
* Get Java working natively again with OpenJDK 8
* Test Unity 2.x and 3.x games
* AMF support for games like Neon Rider for the community levels

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

Launcher Extensions

2022-01-25T03:52:40Z

Ardil: Fix links - Analytics and AutoMount were switched.

Flashpoint Launcher supports third party extensions to add new functionality, themes and logo sets. To learn more about creating launcher extensions, see the [https://github.com/FlashpointProject/launcher/blob/master/docs/extensions.md extension documentation] and the [https://flashpointproject.github.io/launcher_ApiDocs/modules/_typings_flashpoint_launcher_d_._flashpoint_launcher_.html API documentation]. Known community extensions are listed on this page.

== Installing an Extension ==

For now, extensions must be installed manually. Go to the folder you extracted Flashpoint into, navigate to '''/Data/Extensions''' and extract the extension zip inside it. Reload your launcher to activate them. Simply delete the extension and reload the launcher to remove it.

== Extensions ==

{| class="wikitable"
|-
!Name
!Author
!Version
!Flashpoint Version
!Launcher Version
!Home Page
!Download Link
|-
|Ruffle (Standalone + Web)
|Colin969
|Nightly
|9.0
|9.1.0
|[https://github.com/colin969/FPL-Ruffle GitHub repo]
|[https://github.com/colin969/FPL-Ruffle/releases Download]
|-
|Discord Rich Presence
|Colin969
|Nightly
|9.0
|9.1.0
|[https://github.com/colin969/FPL-DiscordRichPresence GitHub repo]
|[https://github.com/colin969/FPL-DiscordRichPresence/releases Download]
|-
|Browser Mode
|Colin969
|1.0.0
|9.0
|9.1.0
|None
|[https://cdn.discordapp.com/attachments/441713444694261760/778560277453078598/launch-in-browser-mode.zip Download]
|-
|Time Played
|Xwilarg
|1.1.0
|9.0
|9.1.0
|[https://github.com/Xwilarg/FPL-TimePlayed GitHub repo]
|[https://github.com/Xwilarg/FPL-TimePlayed/releases Download]
|-
|History
|LeShaps
|1.2.0
|9.0
|9.1.0
|[https://github.com/LeShaps/FPL-History GitHub repo]
|[https://github.com/LeShaps/FPL-History/releases Download]
|-
|GameZIP Auto Mounter
|Sgeo
|0.0.2
|10.0
|9.0.0
|[https://github.com/FlashpointProject/FlashpointAutoMount GitHub repo]
|[https://github.com/FlashpointProject/FlashpointAutoMount/archive/refs/heads/main.zip Download]
|-
|FPL Analytics
|Colin969
|1.0.0
|10.0
|10.0.0
|[https://github.com/FlashpointProject/FPL-Analytics GitHub repo]
|[https://github.com/FlashpointProject/FPL-Analytics/releases/ Download]
|-
|FPL Info Check
|Colin969
|1.0.0
|10.1
|10.0.0
|[https://github.com/colin969/FPL-InfoCheck GitHub repo]
|[https://github.com/colin969/FPL-InfoCheck/releases/ Download]
|-
|Extractor
|Colin969
|1.0.0
|10.1
|10.0.0
|None
|[https://cdn.discordapp.com/attachments/441713444694261760/869128757775056926/Extractor.zip Download], [https://cdn.discordapp.com/attachments/441713444694261760/882881679398690836/typings.zip Source code]
|}

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

Linux Support

2022-01-24T23:18:20Z

Ardil: Add justification for deleting wineprefix

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

Unfortunately, no up-to-date Flashpoint packages are currently available. There are a few options to get Flashpoint running:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is your best bet right now.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.
* Download the outdated Flashpoint 10.0 package and [[#Manual Installation (for advanced users)|manually update it]] to get it working. This should work more consistently, as long as you are able to follow all of the steps.

== Stand-Alone Packages ==

These are standalone packages suitable for all common Linux distributions.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages/]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Distro-specific Packages ==

These are experimental packages for specific Linux distributions. If you don't see a package for your system here, '''please use the stand-alone package instead!''' If you can help update these packages, please visit the Discord server and join #development-chat.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages|Outdated Packages]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Manual Installation (for advanced users) ==

No up-to-date Flashpoint packages for Linux are currently available, but with a few extra steps, you can download the outdated Flashpoint 10.0 package and update it to work again. The steps for doing so are below.

Dependencies: git, 7zip, tar, wine(32 bit), wget, glibc>=2.29, php, qemu (a qemu package that provide qemu-system-i386 is required)

First open a new terminal and type the following commands:
# Change the working directory to your home directory
cd
# Create the required directories
mkdir --verbose --parents opt/flashpoint/{launcher,data}
# Get the new flashpoint launcher (version 10.1.1)
cd opt/flashpoint/launcher
wget https://github.com/FlashpointProject/launcher/releases/download/10.1.1/Flashpoint-10.1.1_linux-x64.7z
7z x ./Flashpoint-10.1.1_linux-x64.7z
rm -v Flashpoint-10.1.1_linux-x64.7z
# Because PHP and QEMU are not killed correctly upon exit, create this launch script:
cat << EOF > flashpoint
#!/bin/sh
cd $HOME/opt/flashpoint/launcher
$HOME/opt/flashpoint/launcher/flashpoint-launcher
killall php
killall qemu-system-i386
EOF
# Get Flashpoint 10.0 Infinity
cd ../data
wget https://bluepload.unstable.life/flashpoint-10-linux-x64.tar.gz
tar --extract --verbose --file=./flashpoint-10-linux-x64.tar.gz
rm --verbose ./flashpoint-10-linux-x64.tar.gz

=== Fix qemu failing to start ===
Execute the following command:
qemu-system-i386 -machine help | grep pc-i440fx-6.0
If that command outputs "pc-i440fx-6.0 Standard PC (i440FX + PIIX, 1996)" then open the file opt/flashpoint/data/services.json and change the line 34 from:
"arguments": ["-m", "512", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
to
"arguments": ["-m", "512", "-machine", "pc-i440fx-6.0", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
If there is no output to the command "qemu-system-i386 -machine help | grep pc-i440fx-6.0" start qemu with the following command:
qemu-system-i386 -m 512 -net nic,model=e1000 -net user,hostfwd=tcp:127.0.0.1:22500-:80 -hda ~/opt/flashpoint/data/Server/alpine.qcow2
Wait for the alpine system to boot up and open the View menu and select compatmonitor0 and type the commands:
delvm quick
savevm quick
quit
Open flashpoint with the command "flashpoint" and then go to Config and on the Flashpoint section set the Flashpoint Path to ../data then scroll down and click on the "Save & Restart" button.

== Troubleshooting ==

If the Flash Player crashes immediately when launched, there are a few possible solutions:
* Replace our hacked Flash projector with the original, unhacked Adobe Flash projector. Follow these steps:
*# [https://drive.google.com/file/d/1Dt3EGqB6SmfM1hkGszUMnYYlNo7RtlhD/view?usp=sharing Download the projector from here]
*# In your Flashpoint folder, open <code>FPSoftware/Flash</code>
*# Replace the <code>flashplayer_32_sa.exe</code> file with the one you downloaded.
* Remove wine-dxvk from your system. This causes problems with the Flash projector on some computers.

In some cases, a problem with Wine may prevent games in Flashpoint from working. Look for the following error in the Logs tab of the launcher:
wine: 'examplewinedirectory/.wine' is a 64-bit installation, it cannot be used with a 32-bit wineserver.
If you see this error, then run the following command to change the wineprefix that FP is trying to use.
sed -i "2 i export WINEPREFIX=$HOME/.wine_fp" "$HOME/opt/flashpoint/launcher/flashpoint"
Alternatively, if you are running low on disk space and don't care about the contents of the wineprefix, you can take a more destructive route: navigate to your Wine directory (usually, it's your home directory) and run the commands below to resolve the problem. Note that this deletes your current wineprefix.
rm -r .wine/
winecfg

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, it uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code>.

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.

=== Supported Platforms ===
* 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, then either turn off use Wine, or tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser. 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>. By default, Basilisk will store its configuration in the location defined by <code>XDG_CONFIG_DIR</code>, so Flashpoint uses a shell script to set the configuration location. A pre-configured copy of Basilisk, along with the shell script, is packaged and also available [https://drive.google.com/file/d/1Y5Mgm9dCa4gCc6UF5WFPqQruzsO81xhf/view?usp=sharing here]. This [https://cdn.discordapp.com/attachments/516027726851735632/612891261665411073/BasiliskSetup.txt text file] describes Basilisk's configuration.
* Java Applets: Supported natively using the OpenJDK. This support is not currently working, however.
* Unity Web Player: Supported through Wine. Unity 2.x and 3.x games may not work; this needs further testing.
* PopCap Plugin: Supported through Wine.
* Authorware Web Player: Supported through Wine.
* GoBit Plugin: Supported through Wine.

=== Unsupported Platforms ===
* Silverlight: In the past, [http://www.webupd8.org/2013/08/pipelight-use-silverlight-in-your-linux.html Pipelight] allowed Linux users to use Silverlight, but the repository is no longer available for most Linux distros. [https://www.maketecheasier.com/install-and-run-silverlight-in-linux/ Moonlight] was another option, but is also no longer available. Attempts to use Silverlight in K-Meleon using Wine have failed.
* 3DVIA Player: A previous tester received this error, which crashed K-Meleon: <code>Error: Access was denied while trying to open files in your profile directory</code>. We need another tester to help us narrow this down.
* 3D Groove GX: When the http_proxy variable is set, Groove Player downloads but fails to load the file. Maybe the registry method described [https://wiki.winehq.org/FAQ#How_do_I_configure_a_proxy.3F here] would work better, but this needs to be tested. Two of our testers received the following set of errors: [https://media.discordapp.net/attachments/496132309498724391/577330595609444352/unknown.png 1] [https://media.discordapp.net/attachments/496132309498724391/577330680678055948/unknown.png 2] [https://media.discordapp.net/attachments/496132309498724391/577330740396556309/unknown.png 3]
* ActiveX: 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.

== Wine ==
Most games rely on technology only available on Windows. A lot of these however can be run through Wine. If there is no native executable, or you have the Native Platform option unticked for the game's platform then the launcher will run it through Wine.

You may choose to use the native versions, in which case tick the platform under Native Platforms in Config.

If you wish to play games that rely on Wine, be sure to install the 32-bit version of Wine. There are links below to distro specific install guides:

* Ubuntu - https://wiki.winehq.org/Ubuntu
* Debian - https://wiki.debian.org/Wine#Installation_on_Debian_Jessie_and_newer
* Arch Linux - https://wiki.archlinux.org/index.php/Wine#Installation

=== Important Note ===

Update: As of Wine 6.0-rc1, Shockwave appears to be working again. If you are on 5.22, keep an eye out for an update from your distribution.

<s>As of Wine 5.22, the Shockwave wrappers are no longer launching. Avoid updating Wine until a fix is found.</s>

== Changelog ==

; 2021-07-26
: Added 10.0 Infinity package

; 2021-02-16
: Added Core/Ultimate standalone package for 9.0 based on 8.1 Infinity standalone

; 2020-11-07
: Updated .deb to Flashpoint 8.2-2 Infinity
: Added native executables for Flash and HTML5
: Replaced modified Flash Projectors with the unmodified ones
: Fixed extreme games option being disabled in config.json

; 2020-10-23
: Updated .deb to Flashpoint 8.2-1 Infinity

; 2020-07-04
: Updated to Flashpoint 8.1 Infinity
: Updated to Flashpoint Launcher 9.0.2

; 2019-09-28
: Updated to Flashpoint 6.3
: Bundled WIP Launcher with better Multi-Platform Support:
:* Proper linux argument escaping (Supersonic RC works now, yay!)
:* SPR games automatically use port 22500 (Hacky, may be removed later)
:* Wine will always (and only) be used for running .exe files (even if use Wine is turned off in Config)
:* .bat files will always run their .sh equivalents (even if use Wine is turned on in Config)
:* Windows execs are mapped to native execs (if existing), so Windows game XMLs should work out the box. (See execs.json)
:* Can mark a platform as 'native' in Config, will force native execs to be used instead of Windows execs even if use Wine is turned on.
:** If no native execs are available (like Shockwave) then it will fallback to running the Windows exec with Wine.
: Added native Basilisk support files
: Updated SPR files
: Updated router.php

; 2019-09-18
: Added new SPR version (see update-spr.sh) and Shockwave XMLs
: Added interim Launcher hack to make Shockwave games that use SPR work properly
: Made the save manager scripts use a valid interpreter (/bin/sh)
:* TODO: they still need further work/testing

; 2019-07-21 and prior
: 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
: Adds Linux versions of the Save Manager scripts
: Adds a "Flashpoint" shortcut (replacing the Windows version)
: Adds Flashpoint 6.2 games
: Removed the game logos, as in Flashpoint Infinity 6.2 for Windows
: Removed the Wineprefix because it was not used

'''To-Do List'''
* Allow the launcher to automatically start/stop the flashpoint server on Linux
* Rewrite and test startUnity.sh and startJava.sh scripts
* Find a way to get Basilisk working better in Wine, or use an alternative browser like K-Meleon
* Get Java working natively again with OpenJDK 8
* Test Unity 2.x and 3.x games
* AMF support for games like Neon Rider for the community levels

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

Linux Support

2022-01-22T16:28:30Z

Ardil: Add non-destructive wineprefix switching method.

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

Unfortunately, no up-to-date Flashpoint packages are currently available. There are a few options to get Flashpoint running:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is your best bet right now.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.
* Download the outdated Flashpoint 10.0 package and [[#Manual Installation (for advanced users)|manually update it]] to get it working. This should work more consistently, as long as you are able to follow all of the steps.

== Stand-Alone Packages ==

These are standalone packages suitable for all common Linux distributions.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages/]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Distro-specific Packages ==

These are experimental packages for specific Linux distributions. If you don't see a package for your system here, '''please use the stand-alone package instead!''' If you can help update these packages, please visit the Discord server and join #development-chat.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages|Outdated Packages]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Manual Installation (for advanced users) ==

No up-to-date Flashpoint packages for Linux are currently available, but with a few extra steps, you can download the outdated Flashpoint 10.0 package and update it to work again. The steps for doing so are below.

Dependencies: git, 7zip, tar, wine(32 bit), wget, glibc>=2.29, php, qemu (a qemu package that provide qemu-system-i386 is required)

First open a new terminal and type the following commands:
# Change the working directory to your home directory
cd
# Create the required directories
mkdir --verbose --parents opt/flashpoint/{launcher,data}
# Get the new flashpoint launcher (version 10.1.1)
cd opt/flashpoint/launcher
wget https://github.com/FlashpointProject/launcher/releases/download/10.1.1/Flashpoint-10.1.1_linux-x64.7z
7z x ./Flashpoint-10.1.1_linux-x64.7z
rm -v Flashpoint-10.1.1_linux-x64.7z
# Because PHP and QEMU are not killed correctly upon exit, create this launch script:
cat << EOF > flashpoint
#!/bin/sh
cd $HOME/opt/flashpoint/launcher
$HOME/opt/flashpoint/launcher/flashpoint-launcher
killall php
killall qemu-system-i386
EOF
# Get Flashpoint 10.0 Infinity
cd ../data
wget https://bluepload.unstable.life/flashpoint-10-linux-x64.tar.gz
tar --extract --verbose --file=./flashpoint-10-linux-x64.tar.gz
rm --verbose ./flashpoint-10-linux-x64.tar.gz

=== Fix qemu failing to start ===
Execute the following command:
qemu-system-i386 -machine help | grep pc-i440fx-6.0
If that command outputs "pc-i440fx-6.0 Standard PC (i440FX + PIIX, 1996)" then open the file opt/flashpoint/data/services.json and change the line 34 from:
"arguments": ["-m", "512", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
to
"arguments": ["-m", "512", "-machine", "pc-i440fx-6.0", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
If there is no output to the command "qemu-system-i386 -machine help | grep pc-i440fx-6.0" start qemu with the following command:
qemu-system-i386 -m 512 -net nic,model=e1000 -net user,hostfwd=tcp:127.0.0.1:22500-:80 -hda ~/opt/flashpoint/data/Server/alpine.qcow2
Wait for the alpine system to boot up and open the View menu and select compatmonitor0 and type the commands:
delvm quick
savevm quick
quit
Open flashpoint with the command "flashpoint" and then go to Config and on the Flashpoint section set the Flashpoint Path to ../data then scroll down and click on the "Save & Restart" button.

== Troubleshooting ==

If the Flash Player crashes immediately when launched, there are a few possible solutions:
* Replace our hacked Flash projector with the original, unhacked Adobe Flash projector. Follow these steps:
*# [https://drive.google.com/file/d/1Dt3EGqB6SmfM1hkGszUMnYYlNo7RtlhD/view?usp=sharing Download the projector from here]
*# In your Flashpoint folder, open <code>FPSoftware/Flash</code>
*# Replace the <code>flashplayer_32_sa.exe</code> file with the one you downloaded.
* Remove wine-dxvk from your system. This causes problems with the Flash projector on some computers.

In some cases, a problem with Wine may prevent games in Flashpoint from working. Look for the following error in the Logs tab of the launcher:
wine: 'examplewinedirectory/.wine' is a 64-bit installation, it cannot be used with a 32-bit wineserver.
If you see this error, then run the following command to change the wineprefix that FP is trying to use.
sed -i "2 i export WINEPREFIX=$HOME/.wine_fp" "$HOME/opt/flashpoint/launcher/flashpoint"
Alternatively, you can take a more destructive route: navigate to your Wine directory and run the commands below to resolve the problem. Note that this deletes your current wineprefix.
rm -r .wine/
winecfg

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, it uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code>.

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.

=== Supported Platforms ===
* 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, then either turn off use Wine, or tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser. 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>. By default, Basilisk will store its configuration in the location defined by <code>XDG_CONFIG_DIR</code>, so Flashpoint uses a shell script to set the configuration location. A pre-configured copy of Basilisk, along with the shell script, is packaged and also available [https://drive.google.com/file/d/1Y5Mgm9dCa4gCc6UF5WFPqQruzsO81xhf/view?usp=sharing here]. This [https://cdn.discordapp.com/attachments/516027726851735632/612891261665411073/BasiliskSetup.txt text file] describes Basilisk's configuration.
* Java Applets: Supported natively using the OpenJDK. This support is not currently working, however.
* Unity Web Player: Supported through Wine. Unity 2.x and 3.x games may not work; this needs further testing.
* PopCap Plugin: Supported through Wine.
* Authorware Web Player: Supported through Wine.
* GoBit Plugin: Supported through Wine.

=== Unsupported Platforms ===
* Silverlight: In the past, [http://www.webupd8.org/2013/08/pipelight-use-silverlight-in-your-linux.html Pipelight] allowed Linux users to use Silverlight, but the repository is no longer available for most Linux distros. [https://www.maketecheasier.com/install-and-run-silverlight-in-linux/ Moonlight] was another option, but is also no longer available. Attempts to use Silverlight in K-Meleon using Wine have failed.
* 3DVIA Player: A previous tester received this error, which crashed K-Meleon: <code>Error: Access was denied while trying to open files in your profile directory</code>. We need another tester to help us narrow this down.
* 3D Groove GX: When the http_proxy variable is set, Groove Player downloads but fails to load the file. Maybe the registry method described [https://wiki.winehq.org/FAQ#How_do_I_configure_a_proxy.3F here] would work better, but this needs to be tested. Two of our testers received the following set of errors: [https://media.discordapp.net/attachments/496132309498724391/577330595609444352/unknown.png 1] [https://media.discordapp.net/attachments/496132309498724391/577330680678055948/unknown.png 2] [https://media.discordapp.net/attachments/496132309498724391/577330740396556309/unknown.png 3]
* ActiveX: 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.

== Wine ==
Most games rely on technology only available on Windows. A lot of these however can be run through Wine. If there is no native executable, or you have the Native Platform option unticked for the game's platform then the launcher will run it through Wine.

You may choose to use the native versions, in which case tick the platform under Native Platforms in Config.

If you wish to play games that rely on Wine, be sure to install the 32-bit version of Wine. There are links below to distro specific install guides:

* Ubuntu - https://wiki.winehq.org/Ubuntu
* Debian - https://wiki.debian.org/Wine#Installation_on_Debian_Jessie_and_newer
* Arch Linux - https://wiki.archlinux.org/index.php/Wine#Installation

=== Important Note ===

Update: As of Wine 6.0-rc1, Shockwave appears to be working again. If you are on 5.22, keep an eye out for an update from your distribution.

<s>As of Wine 5.22, the Shockwave wrappers are no longer launching. Avoid updating Wine until a fix is found.</s>

== Changelog ==

; 2021-07-26
: Added 10.0 Infinity package

; 2021-02-16
: Added Core/Ultimate standalone package for 9.0 based on 8.1 Infinity standalone

; 2020-11-07
: Updated .deb to Flashpoint 8.2-2 Infinity
: Added native executables for Flash and HTML5
: Replaced modified Flash Projectors with the unmodified ones
: Fixed extreme games option being disabled in config.json

; 2020-10-23
: Updated .deb to Flashpoint 8.2-1 Infinity

; 2020-07-04
: Updated to Flashpoint 8.1 Infinity
: Updated to Flashpoint Launcher 9.0.2

; 2019-09-28
: Updated to Flashpoint 6.3
: Bundled WIP Launcher with better Multi-Platform Support:
:* Proper linux argument escaping (Supersonic RC works now, yay!)
:* SPR games automatically use port 22500 (Hacky, may be removed later)
:* Wine will always (and only) be used for running .exe files (even if use Wine is turned off in Config)
:* .bat files will always run their .sh equivalents (even if use Wine is turned on in Config)
:* Windows execs are mapped to native execs (if existing), so Windows game XMLs should work out the box. (See execs.json)
:* Can mark a platform as 'native' in Config, will force native execs to be used instead of Windows execs even if use Wine is turned on.
:** If no native execs are available (like Shockwave) then it will fallback to running the Windows exec with Wine.
: Added native Basilisk support files
: Updated SPR files
: Updated router.php

; 2019-09-18
: Added new SPR version (see update-spr.sh) and Shockwave XMLs
: Added interim Launcher hack to make Shockwave games that use SPR work properly
: Made the save manager scripts use a valid interpreter (/bin/sh)
:* TODO: they still need further work/testing

; 2019-07-21 and prior
: 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
: Adds Linux versions of the Save Manager scripts
: Adds a "Flashpoint" shortcut (replacing the Windows version)
: Adds Flashpoint 6.2 games
: Removed the game logos, as in Flashpoint Infinity 6.2 for Windows
: Removed the Wineprefix because it was not used

'''To-Do List'''
* Allow the launcher to automatically start/stop the flashpoint server on Linux
* Rewrite and test startUnity.sh and startJava.sh scripts
* Find a way to get Basilisk working better in Wine, or use an alternative browser like K-Meleon
* Get Java working natively again with OpenJDK 8
* Test Unity 2.x and 3.x games
* AMF support for games like Neon Rider for the community levels

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

Linux Support

2022-01-22T16:03:39Z

Ardil: Remove the `install` command in the Linux manual instructions.

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, visit us at #flashpoint-mac-linux-help.

Unfortunately, no up-to-date Flashpoint packages are currently available. There are a few options to get Flashpoint running:
* [https://bluemaxima.org/flashpoint/downloads/ Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is your best bet right now.
* Run the Windows version of Flashpoint with [[#Wine|Wine]]. This works well on some computers, but does not work consistently.
* Download the outdated Flashpoint 10.0 package and [[#Manual Installation (for advanced users)|manually update it]] to get it working. This should work more consistently, as long as you are able to follow all of the steps.

== Stand-Alone Packages ==

These are standalone packages suitable for all common Linux distributions.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages/]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Distro-specific Packages ==

These are experimental packages for specific Linux distributions. If you don't see a package for your system here, '''please use the stand-alone package instead!''' If you can help update these packages, please visit the Discord server and join #development-chat.

Unfortunately, no working packages are currently available. See the [[/Outdated Packages|Outdated Packages]] page for previous builds, but be aware that they will not work properly. They are only useful as examples of completed builds, in case developers need them when working on future builds.

== Manual Installation (for advanced users) ==

No up-to-date Flashpoint packages for Linux are currently available, but with a few extra steps, you can download the outdated Flashpoint 10.0 package and update it to work again. The steps for doing so are below.

Dependencies: git, 7zip, tar, wine(32 bit), wget, glibc>=2.29, php, qemu (a qemu package that provide qemu-system-i386 is required)

First open a new terminal and type the following commands:
# Change the working directory to your home directory
cd
# Create the required directories
mkdir --verbose --parents opt/flashpoint/{launcher,data}
# Get the new flashpoint launcher (version 10.1.1)
cd opt/flashpoint/launcher
wget https://github.com/FlashpointProject/launcher/releases/download/10.1.1/Flashpoint-10.1.1_linux-x64.7z
7z x ./Flashpoint-10.1.1_linux-x64.7z
rm -v Flashpoint-10.1.1_linux-x64.7z
# Because PHP and QEMU are not killed correctly upon exit, create this launch script:
cat << EOF > flashpoint
#!/bin/sh
cd $HOME/opt/flashpoint/launcher
$HOME/opt/flashpoint/launcher/flashpoint-launcher
killall php
killall qemu-system-i386
EOF
# Get Flashpoint 10.0 Infinity
cd ../data
wget https://bluepload.unstable.life/flashpoint-10-linux-x64.tar.gz
tar --extract --verbose --file=./flashpoint-10-linux-x64.tar.gz
rm --verbose ./flashpoint-10-linux-x64.tar.gz

=== Fix qemu failing to start ===
Execute the following command:
qemu-system-i386 -machine help | grep pc-i440fx-6.0
If that command outputs "pc-i440fx-6.0 Standard PC (i440FX + PIIX, 1996)" then open the file opt/flashpoint/data/services.json and change the line 34 from:
"arguments": ["-m", "512", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
to
"arguments": ["-m", "512", "-machine", "pc-i440fx-6.0", "-net", "nic,model=e1000", "-net", "user,hostfwd=tcp:127.0.0.1:22500-:80", "-qmp", "tcp:127.0.0.1:4444,server,nowait", "-qmp", "tcp:127.0.0.1:4445,server,nowait", "-hda", "alpine.qcow2", "-loadvm", "quick", "-display", "none"],
If there is no output to the command "qemu-system-i386 -machine help | grep pc-i440fx-6.0" start qemu with the following command:
qemu-system-i386 -m 512 -net nic,model=e1000 -net user,hostfwd=tcp:127.0.0.1:22500-:80 -hda ~/opt/flashpoint/data/Server/alpine.qcow2
Wait for the alpine system to boot up and open the View menu and select compatmonitor0 and type the commands:
delvm quick
savevm quick
quit
Open flashpoint with the command "flashpoint" and then go to Config and on the Flashpoint section set the Flashpoint Path to ../data then scroll down and click on the "Save & Restart" button.

== Troubleshooting ==

If the Flash Player crashes immediately when launched, there are a few possible solutions:
* Replace our hacked Flash projector with the original, unhacked Adobe Flash projector. Follow these steps:
*# [https://drive.google.com/file/d/1Dt3EGqB6SmfM1hkGszUMnYYlNo7RtlhD/view?usp=sharing Download the projector from here]
*# In your Flashpoint folder, open <code>FPSoftware/Flash</code>
*# Replace the <code>flashplayer_32_sa.exe</code> file with the one you downloaded.
* Remove wine-dxvk from your system. This causes problems with the Flash projector on some computers.

In some cases, a problem with Wine may prevent games in Flashpoint from working. Look for the following error in the Logs tab of the launcher:
wine: 'examplewinedirectory/.wine' is a 64-bit installation, it cannot be used with a 32-bit wineserver.
If you see this error, then navigate to your Wine directory and run the commands below to resolve the problem. Note that this will reset your Wine settings.
rm -r .wine/
winecfg

== Technologies ==

Flashpoint Infinity, like its Windows counterpart, it uses <code>router.php</code> as a proxy server. But unlike Windows, Linux provides native ways to set per-application proxy settings, so no equivalent to the [https://github.com/FlashpointProject/FlashpointProxy Flashpoint Proxy library] is used. On Linux, each application is simply told via environment variables to use <code>localhost:22500</code> as a proxy server. For example, before Flashpoint Launcher opens the Flash projector, it sets the <code>http_proxy</code> environment variable to <code>http://localhost:22500/</code>.

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.

=== Supported Platforms ===
* 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, then either turn off use Wine, or tick it as a 'Native Platform' on the Config page.
* Shockwave: Supported through Wine.
* HTML5: Supported natively through the Basilisk browser. 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>. By default, Basilisk will store its configuration in the location defined by <code>XDG_CONFIG_DIR</code>, so Flashpoint uses a shell script to set the configuration location. A pre-configured copy of Basilisk, along with the shell script, is packaged and also available [https://drive.google.com/file/d/1Y5Mgm9dCa4gCc6UF5WFPqQruzsO81xhf/view?usp=sharing here]. This [https://cdn.discordapp.com/attachments/516027726851735632/612891261665411073/BasiliskSetup.txt text file] describes Basilisk's configuration.
* Java Applets: Supported natively using the OpenJDK. This support is not currently working, however.
* Unity Web Player: Supported through Wine. Unity 2.x and 3.x games may not work; this needs further testing.
* PopCap Plugin: Supported through Wine.
* Authorware Web Player: Supported through Wine.
* GoBit Plugin: Supported through Wine.

=== Unsupported Platforms ===
* Silverlight: In the past, [http://www.webupd8.org/2013/08/pipelight-use-silverlight-in-your-linux.html Pipelight] allowed Linux users to use Silverlight, but the repository is no longer available for most Linux distros. [https://www.maketecheasier.com/install-and-run-silverlight-in-linux/ Moonlight] was another option, but is also no longer available. Attempts to use Silverlight in K-Meleon using Wine have failed.
* 3DVIA Player: A previous tester received this error, which crashed K-Meleon: <code>Error: Access was denied while trying to open files in your profile directory</code>. We need another tester to help us narrow this down.
* 3D Groove GX: When the http_proxy variable is set, Groove Player downloads but fails to load the file. Maybe the registry method described [https://wiki.winehq.org/FAQ#How_do_I_configure_a_proxy.3F here] would work better, but this needs to be tested. Two of our testers received the following set of errors: [https://media.discordapp.net/attachments/496132309498724391/577330595609444352/unknown.png 1] [https://media.discordapp.net/attachments/496132309498724391/577330680678055948/unknown.png 2] [https://media.discordapp.net/attachments/496132309498724391/577330740396556309/unknown.png 3]
* ActiveX: 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.

== Wine ==
Most games rely on technology only available on Windows. A lot of these however can be run through Wine. If there is no native executable, or you have the Native Platform option unticked for the game's platform then the launcher will run it through Wine.

You may choose to use the native versions, in which case tick the platform under Native Platforms in Config.

If you wish to play games that rely on Wine, be sure to install the 32-bit version of Wine. There are links below to distro specific install guides:

* Ubuntu - https://wiki.winehq.org/Ubuntu
* Debian - https://wiki.debian.org/Wine#Installation_on_Debian_Jessie_and_newer
* Arch Linux - https://wiki.archlinux.org/index.php/Wine#Installation

=== Important Note ===

Update: As of Wine 6.0-rc1, Shockwave appears to be working again. If you are on 5.22, keep an eye out for an update from your distribution.

<s>As of Wine 5.22, the Shockwave wrappers are no longer launching. Avoid updating Wine until a fix is found.</s>

== Changelog ==

; 2021-07-26
: Added 10.0 Infinity package

; 2021-02-16
: Added Core/Ultimate standalone package for 9.0 based on 8.1 Infinity standalone

; 2020-11-07
: Updated .deb to Flashpoint 8.2-2 Infinity
: Added native executables for Flash and HTML5
: Replaced modified Flash Projectors with the unmodified ones
: Fixed extreme games option being disabled in config.json

; 2020-10-23
: Updated .deb to Flashpoint 8.2-1 Infinity

; 2020-07-04
: Updated to Flashpoint 8.1 Infinity
: Updated to Flashpoint Launcher 9.0.2

; 2019-09-28
: Updated to Flashpoint 6.3
: Bundled WIP Launcher with better Multi-Platform Support:
:* Proper linux argument escaping (Supersonic RC works now, yay!)
:* SPR games automatically use port 22500 (Hacky, may be removed later)
:* Wine will always (and only) be used for running .exe files (even if use Wine is turned off in Config)
:* .bat files will always run their .sh equivalents (even if use Wine is turned on in Config)
:* Windows execs are mapped to native execs (if existing), so Windows game XMLs should work out the box. (See execs.json)
:* Can mark a platform as 'native' in Config, will force native execs to be used instead of Windows execs even if use Wine is turned on.
:** If no native execs are available (like Shockwave) then it will fallback to running the Windows exec with Wine.
: Added native Basilisk support files
: Updated SPR files
: Updated router.php

; 2019-09-18
: Added new SPR version (see update-spr.sh) and Shockwave XMLs
: Added interim Launcher hack to make Shockwave games that use SPR work properly
: Made the save manager scripts use a valid interpreter (/bin/sh)
:* TODO: they still need further work/testing

; 2019-07-21 and prior
: 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
: Adds Linux versions of the Save Manager scripts
: Adds a "Flashpoint" shortcut (replacing the Windows version)
: Adds Flashpoint 6.2 games
: Removed the game logos, as in Flashpoint Infinity 6.2 for Windows
: Removed the Wineprefix because it was not used

'''To-Do List'''
* Allow the launcher to automatically start/stop the flashpoint server on Linux
* Rewrite and test startUnity.sh and startJava.sh scripts
* Find a way to get Basilisk working better in Wine, or use an alternative browser like K-Meleon
* Get Java working natively again with OpenJDK 8
* Test Unity 2.x and 3.x games
* AMF support for games like Neon Rider for the community levels

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

Extended FAQ

2022-01-21T01:49:19Z

Ardil: Remove Linux-specific uninstall info, per nosamu's request.

Be sure to check the [https://bluemaxima.org/flashpoint/faq/ main FAQ] if you don't see your question here, then ask in the #flashpoint-help channel of [http://discord.gg/S9uJ794 our Discord] if you are still not satisfied. If you are using an old version of Flashpoint, you might also want to read the [[Extended FAQ/Legacy|Legacy FAQ]].

Note that not all entries here are fully up to date yet.

==General questions about the project==

'''Q: [[#WhyFlashpoint|{{anchor|WhyFlashpoint|Why do I need Flashpoint to play the games offline? Can't I just use a standalone player like the Flash Player projector to play them?}}]]'''

'''A:''' Many web games have what is known as a ''sitelock'', which means that they will not work unless they are being played on the original site they were hosted on. Since the projector is not connected to the Internet and cannot identify those sites, those games will refuse to load on it. Flashpoint gets around this by running the games through a ''local server proxy'' which, simply put, tricks them into thinking they are being played on the original sites they were meant to be played on. Moreover, web games are commonly spread across multiple files rather than just one; those are known as ''multi-asset'' games. Those games are less likely to run with just the projector on its own, but Flashpoint also deals with that. For more details, see [[How Flashpoint Works]].

'''Q: [[#ROM|{{anchor|ROM|Can I have a zip or ROM of a specific game? Can I download just the games I want?}}]]'''

'''A:''' Flashpoint simulates the internet in order to make games think they are playing on their original websites (see the previous answer for a more detailed explanation of that). Since the files are laid out the same way as they would be on the internet, games are not separated cleanly into ZIPs or "ROMs." Flashpoint Infinity downloads games on demand, so you can keep only the games you like by using Flashpoint Infinity.

'''Q: [[#FlashEOL|{{anchor|FlashEOL|Will Flash games disappear from the Internet when December 2020 hits?}}]]'''

'''A:''' They won't disappear by themselves. However, once Flash support is removed from browsers, most people won't be able to use flash content unless they downgrade their browser version. In addition, they will have to downgrade their Flash version to one that does not contain the [[#FlashKillSwitch|kill switch]]. In that situation, the sites that are hosting the games might decide to remove the Flash games because the vast majority of people won't be able to play them anymore. As we cannot rely on the assumption that sites might stay up, we're working hard to grab as many games as possible while they're still here. For more information on the road map for Flash's End of Life, see [[Flash EOL]].

'''Q: [[#FlashKillSwitch|{{anchor|FlashKillSwitch|I heard that Flash Player will block all Flash content from running after 2020. Will Flashpoint also stop working?}}]]'''

'''A:''' No. Flashpoint will continue to work in 2021 and beyond. The Flash plugin and projectors that we use do not contain the "kill switch"; this was added in a later version of the plugin.

'''Q: [[#Antivirus|{{anchor|Antivirus|My antivirus flagged Flashpoint! Does Flashpoint have any viruses?}}]]'''

'''A:''' Flashpoint does not have any viruses. However, a number of antivirus programs falsely detect certain files in Flashpoint as viruses. Avast, AVG, and BitDefender are even known to render Flashpoint inoperable; you'll need to follow the instructions for [[Troubleshooting Antivirus Interference]].

'''Q: [[#Legal|{{anchor|Legal|What is the legality of this?}}]]'''

'''A:''' "The only real answer is nobody knows and really, nobody should care. Games that more or less have a ticking clock until they die need to be saved now, as fast as possible."

''- BlueMaxima''

'''Q: [[#ArchivedWebsites|{{anchor|ArchivedWebsites|Where can I see what websites have been archived?}}]]'''

'''A:''' We are working on consolidating and listing all of our scrapes, but for now, there are several places to look.

* The [https://drive.google.com/open?id=1r8I5hpSPCf_9JWECwa6c4E4tQZELd3cx Flashfreeze Google Drive folder] contains all of our early site scrapes, up to August 1, 2018.

* A few more site scrapes are available from [https://archive.org/details/2018_Flash_In_The_Pan_Core_Sample this Archive.org item] and [https://archive.org/details/@bluemaxima BlueMaxima's Archive.org account].

* We track the sites we're saving on [https://docs.google.com/spreadsheets/d/1AwpA21I1HLacnDdQ_lRIMs1Yo3VC1uqRBq-mnRV11JU/edit this spreadsheet]. If you'd like a site saved, just add it to the appropriate column of the sheet.

* The #flashfreeze channel on our Discord server also has some leftover rips people have gotten into our [https://fpfss.unstable.life/web/flashfreeze/files submission system].

'''Q: [[#PlaySWF|{{anchor|PlaySWF|Can I use Flashpoint to play my own SWF or DCR files?}}]]'''

'''A:''' Follow our [[Curation Tutorial]] to add games to Flashpoint! Flashpoint comes with standalone projectors for Flash and Shockwave, and in some cases it will work to simply open an SWF with a Flash projector or open a DCR with a Director projector. But to ensure that games are preserved and work properly, you'll need to curate them.

'''Q: [[#HTML5|{{anchor|HTML5|Won't the games just be converted to HTML5?}}]]'''

'''A:''' No. HTML5 is an entirely different technology, so it's impossible for them to be converted automatically.
Developers could port them over to the platform, but most will not have the time or resources to do it. Besides, the capabilities of HTML5 are different from those of Flash, so a game ported to HTML5 will never be identical to the original.

'''Q: [[#Wayback|{{anchor|Wayback|Can't I use the Wayback Machine to play them?}}]]'''

'''A:''' The game has to be archived there in the first place, which may or may not happen. Wayback is specifically poor at grabbing multi-asset games (games that use more than one file), so chances are that it will not work there.
Games with sitelocks won't work there even if they are archived.

'''Q: [[#CheckTheMasterList|{{anchor|CheckTheMasterList|How do I check whether a game is in Flashpoint?}}]]'''

'''A:''' See [[Searching the Collection]].

'''Q: [[#OnlineMultiplayer|{{anchor|OnlineMultiplayer|Are you able to add/support this game? It's based on Facebook/is online multi-player.}}]]'''

'''A:''' Probably not. To support always online games, the emulation of a server is required. To be able to do that is almost as much work as all of Flashpoint itself, so it really wouldn't be practical to put time into.

'''Q: [[#NoNitrome|{{anchor|NoNitrome|Where are my favorite Nitrome games?}}]]'''

'''A:''' All of Nitrome's games were removed from Flashpoint 8.0 at Nitrome's request. This is in accordance with our [http://bluemaxima.org/flashpoint/faq/ removal policy]. If you disagree with Nitrome's decision, you may contact them and politely ask them to reconsider. ''Please do not harass or behave rudely towards Nitrome. They are within their rights to request removal; please respect that.''

'''Q: [[#ObjectionableContent|{{anchor|ObjectionableContent|Why is <questionable content> included in Flashpoint?}}]]'''

'''A:''' Web games, like any other form of art, have always been used as a medium for indie developers to exercise their freedom of expression. Often, this includes homophobic, racist, sexist, and other objectionable content. As a preservation project, Flashpoint aims to archive as much content as possible from this era. It will not play the role of gatekeeper so that future generations can see what these technologies were really used for. All of these works are a snapshot in time, and provide a window into what humans wanted to create at the turn of the century as the internet was in its infancy. You do not have to agree with nor enjoy said content. In order to responsibly provide the means to organize the vast collection that is Flashpoint, it's required to tag questionable content appropriately so that others may use search filters to exclude it from the rest.

'''Q: [[#NickRobinson|{{anchor|NickRobinson|I watched a video by Nick Robinson on YouTube which said that games in Flashpoint connect to the internet! Is this true?}}]]'''

'''A:''' The short answer is '''no''', this is not true. Games in Flashpoint never connect directly to the internet; they connect to Flashpoint's "fake internet," which is a proxy server running locally on your computer. If you are using Flashpoint '''Infinity''', this proxy server will connect to Flashpoint's server at <code>infinity.unstable.life</code> to download any files that are unavailable locally. Once the game files are downloaded, the game can be played offline. If you are using Flashpoint '''Ultimate''', an internet connection is never required to play games. See [[How Flashpoint Works]] for more information.

To address the specific claims in Nick Robinson's video: Mission in Snowdriftland has been fully archived in Flashpoint since 2019 and is fully playable offline in Flashpoint Infinity once the game files have been downloaded. We have tested this with all network adapters disabled via the Windows Control Panel. Nick Robinson used a third-party "internet killswitch" tool that may have interfered with Flashpoint in an unusual way. He did not speak to us before the publication of the video and did not report any issues with our software to us, but later corrected the claims in his video as a comment on the video's page.

==Setting up Flashpoint==

'''Q: [[#FlashpointEditions|{{anchor|FlashpointEditions|What version of Flashpoint should I get? What's the difference between Infinity and Ultimate?}}]]'''

'''A:''' If you have a lot of free disk space, bandwidth, and time, you should get Flashpoint Ultimate. But if you don't have a lot of free space, want to get Flashpoint up and running quickly, or only want to play a few games, you should get Flashpoint Infinity. See below for a detailed description of each edition of Flashpoint.
* '''Flashpoint Ultimate''': The full package. All games are fully playable offline. Also includes a logo and screenshot for each game. You'll need a few hundred gigabytes of free disk space - see the [https://bluemaxima.org/flashpoint/downloads/ Flashpoint downloads page] for more details.
* '''Flashpoint Infinity''': A minimalist build - games download as you choose to play them. Once games are fully downloaded, they will work offline. Logos and screenshots for games are also downloadable on demand, but Extras are not available.
* '''Flashpoint Core''': A lightweight copy of Flashpoint with one game per platform to aid curation. '''For developers and curators only!'''

'''Q: [[#UpdateFlashpoint|{{anchor|UpdateFlashpoint|How do I update Flashpoint when a new version is released?}}]]'''

'''A:''' If you have Flashpoint Ultimate, you can use [https://bluemaxima.org/flashpoint/downloads/#updater FlashpointUpdater]. There is no updater available for Flashpoint Infinity or Core yet; you'll need to [https://bluemaxima.org/flashpoint/downloads/ download] and extract the new version. You can transfer any playlists you'd like to keep to a new version of Flashpoint by following [[#TransferPlaylists|the instructions below]].

'''Q: [[#TransferPlaylists|{{anchor|TransferPlaylists|How do I move my playlists to a new version of Flashpoint?}}]]'''

'''A:''' If your '''old version''' of Flashpoint is '''8.1 or above''', you'll need to export your playlists first:
# Open your old copy of Flashpoint. Click the appropriate tab, then click the playlist you want to keep.
# Click the "Export playlist to a file" button (this is the 2nd button from the left).
# Repeat the process for any other playlists that you want to save.

To import your playlist files into your new copy of Flashpoint, follow these steps:
# Make sure you've closed your old copy of Flashpoint, then open the new one.
# If you are transferring a Games playlist, click the Games tab of the launcher. If you are transferring an Animations playlist, click the Animations tab.
# Scroll down to the bottom of the left sidebar, then click the "Import Playlist" button.
# Navigate to the folder where your old playlists are stored.
#* If your old version of Flashpoint is '''8.0 or below''', your playlist files will be located inside its <code>Data\Playlists</code> folder.
#* Otherwise, your playlist files will be located in the folder where you exported them.
# Double-click a playlist (JSON file) to import it. Repeat the process for any other playlists that you want to import.

'''Q: [[#UninstallFlashpoint|{{anchor|UninstallFlashpoint|How do I uninstall Flashpoint from my computer?}}]]'''

'''A:''' Flashpoint being a fully portable application, it can be uninstalled by simply deleting its main folder.

'''Q: [[#DownloadUltimate|{{anchor|DownloadUltimate|What's the best way to download Flashpoint Ultimate?}}]]'''

'''A:''' If you're updating to a new version or you're low on disk space, we recommend using [https://bluemaxima.org/flashpoint/downloads/#updater FlashpointUpdater]. In addition to updating an existing copy, it can also be used to download a full copy of Flashpoint Ultimate by pointing it at an empty folder. This lets you avoid downloading and extracting a 7Z file, saving a lot of disk space.

If you want the download to be as quick as possible, we recommend using the [https://bluemaxima.org/flashpoint/downloads/ torrent]. It will be faster, but it comes in the form of a large 7Z file. That means you'll need sufficient free disk space both to download and extract it.

'''Q: [[#Linux|{{anchor|Linux|Can I use Flashpoint on Linux?}}]]'''

'''A:''' Yes, although not all platforms and features are supported. See [[Linux Support]].

'''Q: [[#Mac|{{anchor|Mac|Can I use Flashpoint on Mac?}}]]'''

'''A:''' A heavily experimental Flashpoint package is available for MacOS. See [[Mac Support]].

== Playing games ==

'''Q: [[#LauncherShortcut|{{anchor|LauncherShortcut|How do I create a shortcut to Flashpoint on my desktop/taskbar/start menu?}}]]'''

'''A:''' Go into the <code>Launcher</code> folder that's inside your Flashpoint directory and look for <code>Flashpoint.exe</code>. Right-click it and click <code>Send to > Desktop (create shortcut)</code>, or drag it to your taskbar or start menu. '''CAUTION: Do NOT drag <code>Flashpoint.exe</code> directly to your desktop as that will move the file, which will make the launcher not work.'''

'''Q: [[#GameShortcut|{{anchor|GameShortcut|How do I create a shortcut to a specific game/animation in Flashpoint?}}]]'''

'''A:''' This feature is planned for Flashpoint Launcher, but for now, you'll need to download two separate tools. Follow the steps below:
# Download the [https://github.com/oblivioncth/CLIFp/releases/latest latest release of CLIFp].
# Extract the ZIP file and move <code>CLIFp.exe</code> into your Flashpoint folder.
# Download [https://github.com/maichiu/FlashpointShortcutMaker/archive/main.zip Flashpoint Shortcut Maker].
# Extract the ZIP file and move <code>FlashpointShortcutMaker.vbs</code> into your Flashpoint folder.
Now that you have CLIFp and Flashpoint Shortcut Maker set up, follow the steps below to create a shortcut:
# Open Flashpoint Launcher and find the game/animation that you want to create a shortcut for.
# Right-click the game/animation and click "Copy Game UUID".
# Double-click FlashpointShortcutMaker.vbs.
# Paste the UUID of the game/animation that you copied in step 2. Click OK, and a shortcut will appear on your desktop!

'''Q: [[#GameNotFound|{{anchor|GameNotFound|Why can I not find ''X'' game/animation in the launcher? Why do some games/animations not appear?}}]]'''

'''A:''' There are a few possibilities:

* Make sure you spelled the name of the game/animation correctly when searching. If a search fails, try searching for partial names rather than full names. Varying punctuation is also a common culprit. We are planning on overhauling the Search feature to allow for more customizable and dynamic browsing in the future, so stay tuned!
* If the game/animation has adult content, it might have been marked as Extreme, in which case you'll need to follow [[#ShowExtreme|these instructions]] before it will be visible.
* Make sure you don't have a playlist selected by accident; Searching in a playlist will look for the game ''in that playlist specifically''. So make sure you have ''All Games'' selected in the left-hand column before making your search.
* If you see the game on the [[Searching the Collection|Master List]] but don't see it in Flashpoint Infinity, then it might only be available in Flashpoint Ultimate. Follow [[#GameDisappeared|these steps]] to show broken games in Infinity, then search for the game again. If you see the game and the "Broken (in Infinity)" checkbox is checked, that means the game is only available in Flashpoint Ultimate.
* It's also possible that we don't have the game yet. If you wish to request a game or an animation to be added to Flashpoint, you can do so via the [[Request Form]]. Alternatively, if you want to ensure that the game/animation is added, you can learn how to ''curate'' it yourself by following our [[Curation Tutorial]]. '''In either case, please thoroughly search the master lists above to make sure that we don't have the game or animation already.'''

'''Q: [[#ShowExtreme|{{anchor|ShowExtreme|How do I show/hide Extreme content in Flashpoint?}}]]'''

'''A:''' To show Extreme content in Flashpoint, first click the Config tab of the launcher and turn on "Extreme Content." Next, scroll down to the "Tag Filter Groups" section and turn ''off'' the specific tag filter groups applicable to the content you want to view. Because a lot of Extreme content has not been categorized yet, you may also need to turn off the "Extreme Generic" filter.

To hide extreme content, just reset the settings mentioned above. If you want to hide these settings altogether, for example if you have children using Flashpoint, you can edit the file <code>config.json</code> with any text editor to change the <code>false</code> value next to <code>disableExtremeGames</code> to <code>true</code>, saving the file afterwards.

'''Q: [[#Fullscreen|{{anchor|Fullscreen|Can I play the games in fullscreen? Can I make them bigger?}}]]'''

'''A:''' The answer depends on the type of game you're playing. See below:
* For Flash games that open in the Flash projector, you can drag the corner of the window to resize it. Do your best to maintain the window's original aspect ratio, otherwise some games might behave in unexpected ways.
* For Flash, Shockwave, and Java games, you can play them in fullscreen using [http://tanalin.com/en/projects/integer-scaler/ IntegerScaler]. However, this program doesn't play well with multi-monitor setups.
* For most games that open in a browser, you can press <code>Ctrl</code> + <code>+</code> and <code>Ctrl</code> + <code>-</code> (Ctrl-plus and Ctrl-minus) to zoom in and out. In most cases, fullscreen is not possible for these games.
* Another option for Shockwave is to use SPRS, a version of the Shockwave projector that runs the games in fullscreen. Though keep in mind that this feature is experimental and has only been tested with a handful of games, therefore it may not work well with all games.

To use SPRS:

# Click the pencil icon on the upper right of the game info section for the game you want to play in fullscreen (if you don't see the icon, enable editing on the <code>Config</code> tab).
# Scroll down to the field labeled <code>Application Path</code> and change <code>SPR.exe</code> to <code>SPRS.exe</code>.
# Click the checkmark button at the top to confirm.
# Launch the game.

To close the game, press <code>Esc</code> (or alternatively, <code>Alt</code> + <code>F4</code>).

'''Q: [[#RecentGames|{{anchor|RecentGames|Can I view a list of my recently played games?}}]]'''

'''A:''' Flashpoint does not track your recently played games by default, but you can install the [https://github.com/LeShaps/FPL-History FPL History] extension to add this functionality. See the [[Launcher Extensions]] page for more information.

'''Q: [[#EnableEditing|{{anchor|EnableEditing|How do I edit a game or playlist in my copy of Flashpoint?}}]]'''

'''A:''' Click the Config tab of Flashpoint Launcher, then check the "Enable Editing" box. Then click "Save and Restart." When Flashpoint Launcher re-opens, you'll notice the following changes:
* Dragging a game onto a playlist in the left sidebar will add the game to the playlist.
* Clicking the pencil button on the right sidebar will allow you to edit a game entry.
* Double-clicking the trash icon will allow you to delete a game or playlist.
* When a playlist is selected, double-clicking the X button on the right sidebar will remove the currently selected game from the playlist.

'''Q: [[#GameAssets|{{anchor|GameAssets|Where are the games stored?}}]]'''

'''A:''' If you have Infinity 9.0 or higher the games and all of their assets are stored in the <code>Legacy\htdocs</code> folder within Flashpoint's directory (wherever you extracted it to). In Ultimate non-zipped games are stored in the same place <code>Legacy\htdocs</code>, zipped games are stored in <code>Games</code>. To find the files for a specific game, right-click the game entry in Flashpoint Launcher, then click "Open File Location."

'''Q: [[#SaveData|{{anchor|SaveData|Where is the games' save data kept? How can I delete it/transfer it to another computer/drive?}}]]'''

'''A:''' You can find the location where each platform keeps their save data in [[Save Data Locations]]. For your convenience, there are two batch scripts included in Flashpoint's <code>FPSoftware</code> folder which can be used to back up and restore Flash save data to another computer or drive; Namely ''Saves Manager - Backup.bat'' and ''Saves Manager - Restore.bat''. If you want to delete save data or manage non-Flash data, you are going to have to find it manually at the locations listed on the aforementioned page.

'''Q: [[#HappyWheels|{{anchor|HappyWheels|I want to play Happy Wheels! What should I download?}}]]'''

'''A:''' We have a few options:
* The Happy Wheels Demo is available in Flashpoint Infinity. The demo is missing the user levels and other extra content from the full version.
* The full version of Happy Wheels is included with Flashpoint Ultimate. It includes all user levels up to 2019-03-24.
* We also offer a standalone download called [https://archive.org/download/Happy_Wheels_Offline/Happy%20Wheels%201.1.zip Happy Wheels Offline]. It only includes user levels up to 2018-11-26, but it's only 8GB.

'''Q: [[#MoshiMonsters|{{anchor|MoshiMonsters|I want to play Moshi Monsters! What should I download?}}]]'''

'''A:''' Moshi Monsters is available in [https://bluemaxima.org/flashpoint/downloads/ Flashpoint Ultimate and Infinity]. If you want a full, offline copy of Moshi Monsters but don't want to download Flashpoint Ultimate, you can download our [https://download.unstable.life/static/Moshi.7z standalone Moshi Monsters package].

==Troubleshooting==

'''Q: [[#OldInfinityVersions|{{anchor|OldInfinityVersions|Why doesn't my old version of Flashpoint Infinity work anymore? I can't download games or logos/screenshots.}}]]'''

'''A:''' Due to SSL certificate issues outside of our control, old versions of Flashpoint Infinity (10.0 and below) do not work anymore. You will need to [[#UpdateFlashpoint|update to the latest version of Flashpoint]].

'''Q: [[#WhiteScreenAndNoImages|{{anchor|WhiteScreenAndNoImages|I'm using Flashpoint Infinity, launching games always shows a blank white screen, and no logos and screenshots are loading! How do I fix this?}}]]'''

'''A:''' Follow each of these steps and check to see if Flashpoint works properly after each one. If it still shows a white screen, try the next step.
# Follow the [[Troubleshooting Antivirus Interference|antivirus interference]] steps to prevent an antivirus such as Avast or AVG from interfering with Flashpoint.
# If Flashpoint still doesn't work, your router probably has internet filtering software installed that is blocking our Infinity server. A common one is McAfee Secure Home Platform; [https://service.mcafee.com/webcenter/portal/cp/home/articleview?locale=en_US&articleId=TS102694 here is how to disable it].
# If Flashpoint still doesn't work, you might be experiencing a different problem. Follow the Troubleshooting steps in the [https://bluemaxima.org/flashpoint/Manual.pdf Manual].

'''Q: [[#UltimateBrokenAfterUpdate|{{anchor|UltimateBrokenAfterUpdate|After I updated to Flashpoint 9.0 Ultimate using the updater, no games are working! Is there a fix?}}]]'''

'''A:''' Follow the steps below to fix the problem:
# Download [http://infinity.unstable.life/Flashpoint/Server/alpine.qcow2 this file].
# Replace the existing file in Flashpoint's <code>Server</code> folder with the file that you downloaded.

'''Q: [[#NotWorkingOffline|{{anchor|NotWorkingOffline|I disconnected from the internet and now games don't show up! How do I fix this?}}]]'''

'''A:''' Click the Config tab of Flashpoint Launcher, then uncheck the "On Demand Images" box. Then click "Save and Restart." When Flashpoint Launcher re-opens, the problem will be fixed.

'''Q: [[#LauncherNotOpening|{{anchor|LauncherNotOpening|When I double-click Flashpoint.exe, nothing happens! What can I do?}}]]'''

'''A:''' When you open Flashpoint Launcher, a bug may occur that prevents it from showing the window. If this happens, open Windows Task Manager, click the Details tab, and look for any process named <code>Flashpoint.exe</code>. Then click "End Process", and double-click Flashpoint.exe again to see if it starts normally.

If the issue persists, or if the Launcher doesn't open ''after'' the first time you started it, close all Flashpoint processes again, then look for a 0 KB <code>preferences.json</code> file in the same location as the <code>Start Flashpoint</code> shortcut. If it is 0 KB, replace it with this [https://infinity.unstable.life/Flashpoint/preferences.json default preferences file]. Once done, launch Flashpoint using the <code>Start Flashpoint</code> shortcut and it should now open normally. Note: If you previously changed some settings on the <code>Config</code> tab, you will have to set them again.

If you have Hyper-V/WSL/WSA installed, the problem could be caused by Flashpoint's backend port being in Hyper-V's reserved port range, resulting in Flashpoint receiving an EACCES when it tries to bind. A fix for this is in development, but for now: restarting your computer should reset the reserved port range. For a more long-term solution, add port 12001 to the excluded port range as seen [https://stackoverflow.com/a/54727281 here].

'''Q: [[#MissingFolder|{{anchor|MissingFolder|I extracted Flashpoint into my Downloads folder, but now I can't find it! Where is my Flashpoint folder?}}]]'''

'''A:''' If your Downloads folder is grouped by date, you'll need to scroll down to the "Earlier this year" or "A long time ago" section to find your Flashpoint folder. This is because Flashpoint's files were packed into the installer "a long time ago", so they appear on your computer as being from that date, even though the installer file itself was downloaded to your computer recently.

'''Q: [[#GameDeleted|{{anchor|GameDeleted|I accidentally deleted a game/animation from Flashpoint! How can I reset it?}}]]'''

'''A:''' Follow the steps below:
# [[#TransferPlaylists|Back up any playlists that you want to keep]].
# Get the appropriate database file for your edition of Flashpoint:
#* If you are using Flashpoint Ultimate, download the [http://infinity.unstable.life/Flashpoint/Data/flashpoint.sqlite database file]. Then open your copy of Flashpoint Ultimate and replace the <code>flashpoint.sqlite</code> file inside its <code>Data</code> folder with the file you downloaded.
#* If you are using Flashpoint Infinity, just re-extract it. [https://bluemaxima.org/flashpoint/downloads/ Re-download it first] if you don't have the original file anymore.
# [[#TransferPlaylists|Restore any playlists that you backed up]].

'''Q: [[#GameDisappeared|{{anchor|GameDisappeared|I accidentally marked a game as <code>Broken (in Infinity)</code>, and it disappeared! How do I find it again?}}]]'''

'''A:''' Follow these steps:
# Navigate to the Flashpoint folder.
# Open the <code>preferences.json</code> file in a text editor such as Notepad.
# Find the line that says <code>"showBrokenGames": false,</code> and change <code>false</code> to <code>true</code>.
# Save the file and restart Flashpoint.

'''Q: [[#ToggleSidebars|{{anchor|ToggleSidebars|I can't see the left (or right) sidebar of the launcher anymore! Where did it go?}}]]'''

'''A:''' Click the arrow buttons on the top-right corner of the launcher to toggle the left and right sidebars. --->
[[File:ShowHideSidebars.png]]

'''Q: [[#Logos|{{anchor|Logos|Why can't I see the games' logos/screenshots?}}]]'''

'''A:''' Flashpoint Infinity does not come with the game logos by default due to size reasons. However, they can be downloaded on demand as you use Flashpoint. First, click the Config tab of Flashpoint Launcher and make sure the "On Demand Images" box is checked. Then switch to the ''Grid'' viewing mode using the drop-down menu at the bottom-right corner of the launcher window.

'''Q: [[#OpenTorrentFile|{{anchor|OpenTorrentFile|Why won't my Ultimate torrent open?}}]]'''

'''A:''' You will need a torrent client such as [https://www.qbittorrent.org/ qBittorrent] to open the .torrent file. The .torrent file tells your torrent client how to download Flashpoint Ultimate.

'''Q: [[#IATorrentBad|{{anchor|IATorrentBad|The torrent won't download, even though I'm using a torrent client! What's the problem?}}]]'''

'''A:''' Do '''not''' use the torrent from Archive.org! Because of the size of Flashpoint Ultimate, Archive.org will not seed its torrent. Instead, use the torrent link on [https://bluemaxima.org/flashpoint/downloads/ Bluemaxima.org].

'''Q: [[#FlashpointNotWorking|{{anchor|FlashpointNotWorking|Why is Flashpoint not working after my download?}}]]'''

'''A:''' Make sure you unzip the program, as it will not work while still zipped. Please use [https://www.7-zip.org 7-Zip] when doing this, as WinRAR is known to fail. If Flashpoint is still not working, follow the Troubleshooting steps in the [https://bluemaxima.org/flashpoint/Manual.pdf Manual].

'''Q: [[#Corrupted7ZFile|{{anchor|Corrupted7ZFile|When I try to open the Flashpoint Ultimate 7Z file with 7-Zip, it says "Cannot open as archive." What's the problem?}}]]'''

'''A:''' The download was probably corrupted. Browsers are not designed to download gigantic files like Flashpoint Ultimate, so you'll need to use a download manager such as [https://www.freedownloadmanager.org/ Free Download Manager] to download the file.

'''Q: [[#CheckHash|{{anchor|CheckHash|How can I check whether Flashpoint Ultimate downloaded successfully?}}]]'''

'''A:''' You'll need to check whether the hash of the file you downloaded matches the expected hash. First, install [https://www.7-zip.org 7-Zip] if you don't have it already. Next, follow these steps:
# Right-click the 7Z file that you downloaded.
# Choose "CRC SHA...", then choose SHA1 or CRC32.
# Go to the [https://bluemaxima.org/flashpoint/downloads/ Flashpoint downloads page] and click the button labeled "Mirror" or "Archive.org" underneath the Flashpoint Ultimate heading. This should take you to Flashpoint Ultimate's Archive.org entry.
# Scroll down and find the "Download Options" sidebar on the right. Click the "Show All" link.
# Click the file ending in <code>_files.xml</code>. For example, on Flashpoint 6.3's page, the file is called <code>Flashpoint6.3_files.xml</code>.
# You should see a list of files in XML format. Check the hash listed for the file, and make sure it matches the hash you found in Step 2. For example, if you chose CRC32 in Step 2, make sure the CRC32 hashes are the same.

'''Q: [[#InfinityPartialDownloads|{{anchor|InfinityPartialDownloads|Most games are working, but when I try to open a specific game, I get an error like one of these:}}]]'''
* "The file __ is not a Director file."
* "Error launching Unity Player: bad file length"
* "Failed to initialize player's 3D settings"
* A stuck loading bar
* Partially loaded images, missing elements on a page or in a game, or other problems indicating file corruption

'''A:''' If you are using Flashpoint Infinity, it's very likely that Flashpoint Router failed to download a complete file. To solve the problem, follow these steps:
# Right-click the game that you are trying to play, then click "Open File Location."
# This will open a folder; delete all of the files there.
# Clear the cache by following [[#ClearWinINetCache|these steps]].
# Try launching the game again.
If the problem persists, try [[#UpdateRouter|updating Flashpoint Router]]. If that doesn't help, follow the Troubleshooting steps in the [https://bluemaxima.org/flashpoint/Manual.pdf Manual].

'''Q: [[#UpdateRouter|{{anchor|UpdateRouter|How do I update Flashpoint Router?}}]]'''

'''A:''' Follow these steps:
# Download this file: https://raw.githubusercontent.com/FlashpointProject/Flashpoint-Router/master/router.php
# Place the downloaded file in the <code>Legacy</code> folder of your Flashpoint folder, overwriting the original <code>router.php</code> file.

'''Q: [[#3DVIAAudioBug|{{anchor|3DVIAAudioBug|I am playing a 3DVIA Player webgame and the audio is loud and distorted, how do I fix it?}}]]'''

'''A:''' Your computer has a codec issue with MP3 playback. To resolve this:
# Install K-Lite Codec Pack if you do not already have it installed.
# Open Codec Tweak Tool from the Start Menu.
# In Codec Tweak Tool, go to Codec and Filter Management > Directshow (x86) and check the box for LAV Audio Decoder.
# Click Apply & Close to disable the filter.
# Exit Codec Tweak Tool.

'''Q: [[#ServerExited|{{anchor|ServerExited|Games are not working, and an error like this one appears constantly in the Launcher's logs:}}]]'''
Server exited with code 3221225781

'''A:''' First, make sure that you have installed all of the latest Windows Updates. Next, install the [https://dotnet.microsoft.com/download/dotnet-framework/net47 Microsoft .NET Framework] and the [https://www.microsoft.com/en-us/download/details.aspx?id=48145 Visual C++ 2015 x86 Redistributable]. When you install the Visual C++ Redistributable, '''make sure to install the x86 version''', even if you're on a 64-bit machine!

'''Q: [[#LauncherBlackScreen|{{anchor|LauncherBlackScreen|When I open Flashpoint all I get is a black/grey screen. What should I do?}}]]'''

'''A:''' If your computer has an older graphics card, it may not support the launcher's hardware acceleration. To get around this, disable hardware acceleration by following these steps:

# In your main Flashpoint folder, select the <code>Start Flashpoint</code> shortcut by clicking it once.
# Press <code>Alt</code> + <code>Enter</code> to bring up its properties window.
# In the <code>Target</code> field, add a space at the very end of the field followed by <code>--disable-gpu</code>.
# Click OK
# Launch Flashpoint by double-clicking the <code>Start Flashpoint</code> shortcut.

Note that this change only affects the launcher itself, and shouldn't have any impact on its performance.

'''Q: [[#MarioBrosCrossoverIssue|{{anchor|MarioBrosCrossoverIssue|Most games are working, but when I launch a Flash game such as Super Mario Bros. Crossover, it crashes on a black screen! What's the fix?}}]]'''

'''A:''' Follow the steps below to fix the problem:
# Open your Flashpoint folder and navigate to the <code>Legacy\htdocs</code> folder.
# Delete the <code>data.explodingrabbit.com</code> folder.
# Clear the cache by following [[#ClearWinINetCache|these steps]].

'''Q: [[#UnityUpdatePlugin|{{anchor|UnityUpdatePlugin|Some Unity games ask to update the plugin and will not play the game! What's the fix?}}]]'''

'''A:''' Follow the steps below to fix the problem:
# Open your Flashpoint folder and navigate to the <code>FPSoftware\FlashpointSecurePlayerConfigs</code> folder.
# Extract [https://cdn.discordapp.com/attachments/596548932373577750/802693500218114058/unitywebplayer.7z this file] into the folder, confirm to replace files.
# Restart Flashpoint.

==Work & Curation==

'''Q: [[#SubmitGame|{{anchor|SubmitGame|What is the difference between requesting and curating a game? Can I "submit" a game?}}]]'''

'''A:''' Requesting - This option adds your game to an ever-growing list of ones people want added. You will need to fill out the request form which takes 1-5 minutes. Chances of game being saved by any of the curators is small because there are thousands of games waiting on the list, some of which have been waiting for over a year. If you want to increase the chances of it being saved, we suggest that you try to write an engaging description of the game and/or the reason you want it saved.

Curating - This is the process of actually adding the game to Flashpoint. It requires testing the game using procedures detailed in our curation guides. It takes about 30 minutes to do the first time, but as you learn the process you can get it under 5 minutes.
To get started, follow our [[Curation Tutorial]].
Once you curate a game, it will be saved and added to the next version of Flashpoint.

If you'd like to learn more about the concept of digital curation, read [https://en.wikipedia.org/wiki/Digital_curation this article]. It explains the principles behind what we do.

'''Q: [[#MetadataEdits|{{anchor|MetadataEdits|How do I correct a problem with a game's metadata? Does editing the game in my copy of Flashpoint update it for everyone?}}]]'''

'''A:''' No, editing a game in your copy of Flashpoint does not update it for everyone. To get your change included in the next version of Flashpoint, follow the instructions in the [[Metadata Edits]] page.

'''Q: [[#ScrapeWebsites|{{anchor|ScrapeWebsites|What tools should I use to archive whole websites?}}]]'''

'''A:''' See [[Helpful Tools#Software for Archiving|Helpful Tools]].

'''Q: [[#WhatPlatform|{{anchor|WhatPlatform|How do I tell what platform a game is?}}]]'''

'''A:''' The easiest way to check these kinds of things is to right-click the game window and look at the context menu that appears. If it says something about Flash, it's a Flash game. If it says nothing out of the ordinary or no context menu appeared, it's probably HTML5. See [https://media.discordapp.net/attachments/509676268719964160/692059796957954079/unknown.png this image] for a summary.

You can also use Inspect Element to look at the embed of the game for the following file extensions:

.swf - Flash

.dcr/.dir/.dxr - Shockwave

.unity3d - Unity Web Player

.jar/.class - Java

.stk - ShiVa3D

.xap - Silverlight

.vmo - 3DVIA

If a game runs only in Internet Explorer, references a .cab file, and is not one of the above types of games, it is probably an ActiveX game.

If a game does not require any plugins or ActiveX controls to run, then it is probably an HTML5 (or HTML/JavaScript) game.

If it's something else it may be under one of our other platforms, but these are the most common types.

'''Q: [[#SubmitSWFs|{{anchor|SubmitSWFs|Where can I submit my collection of SWFs?}}]]'''

'''A:''' [http://bluepload.unstable.life/ This is our public upload location.]

It is highly encouraged that you first [[#CheckTheMasterList|check whether each game/animation is already in Flashpoint]] and only upload ones that are not.

'''Q: [[#Decompiler|{{anchor|Decompiler|What is a good tool to decompile/hack SWF files (Flash games)?}}]]'''

'''A:''' The recommended program for this purpose is ''[https://github.com/jindrapetrik/jpexs-decompiler/releases JPEXS Free Flash Decompiler]''.

'''Q: [[#ClearWinINetCache|{{anchor|ClearWinINetCache|How do I clear the Flash projector's cache?}}]]'''

'''A:''' The Flash projectors use WinINet to perform network requests. Some other Flashpoint platforms, such as 3D Groove GX, also use WinINet. To clear the cache for these programs, follow these steps:
# Navigate to the FPSoftware folder within your main Flashpoint folder.
# Double-click the <code>Clear_FP_Cache.bat</code> file to run it.
Alternatively, you can run the command manually by following these steps:
# Press Windows-R to open the Run box.
# Type or paste in the following command, then press Enter: <code>RunDll32.exe InetCpl.cpl,ClearMyTracksByProcess 8</code>
Note that for games that use the Basilisk browser, you will need to [[#ClearBasiliskCache|clear Basilisk's cache]] instead.

'''Q: [[#ClearBasiliskCache|{{anchor|ClearBasiliskCache|How do I clear the Basilisk browser's cache?}}]]'''

'''A:''' Open the Basilisk browser and follow these steps:
# Press the <code>Alt</code> key
# Click "History," then "Clear Recent History..."
# Change the time range to "Everything" using the dropdown menu, then check the boxes next to "Cache" and "Offline Website Data."
# Click "Clear Now."

'''Q: [[#AlternatePlatformCuration|{{anchor|AlternatePlatformCuration|I'm curating an HTML5 version of a Flash game that is already in Flashpoint (or the other way around). Should I submit it as alternate of Flashpoint's existing entry?}}]]'''

'''A:''' No, you will need to submit a new, separate curation. Currently, alternate versions of a game are required to be of the same [[Platforms|Platform (technology)]] as the main game entry.

'''Q: [[#cgibin|{{anchor|cgibin|My curation works fine in Flashpoint Core, but when I import it into Infinity, it doesn't work anymore! Is there a problem with my curation?}}]]'''

'''A:''' Probably not. For Infinity, files need to be placed in the <code>cgi-bin</code> folder, following the same structure as they would in the <code>htdocs</code> folder, if they meet one of these criteria:
* The file has a PHP, PHP5 or PHTML extension. These files are always loaded from cgi-bin.
* The file doesn't have one of these extensions, but does have a PHP script in it that you intend to run.

This restriction exists because it would be unsafe for Infinity to download and execute PHP on demand.

If your curation does not include any PHP scripts and it still isn't working, [[#ClearWinINetCache|clear the cache]] and try launching the game again.

'''Q: [[#cURLsDownloaderBug|{{anchor|cURLsDownloaderBug|After I type a URL or filename into the cURLsDownloader window, it immediately closes! Am I doing something wrong?}}]]'''

'''A:''' This bug is fixed in the latest version of cURLsDownloader. You can find the download link on the [[Helpful Tools#Software for Archiving|Helpful Tools]] page.

'''Q: [[#NoTags|{{anchor|NoTags|I filled out tags for my curation, but after I exported it, I noticed that the tags are missing! Why did this happen?}}]]'''

'''A:''' To add a tag to your curation, first type it into the Tags box, then ''select'' it by either clicking it, or pressing the Tab key and hitting Enter when the tag is highlighted. '''If you type a tag without selecting it, it will not be added to your curation!'''

'''Q: [[#CurateTabWhiteScreen|{{anchor|CurateTabWhiteScreen|I'm using Flashpoint Core, and launching my curations shows a blank white screen. What do I do?}}]]'''

'''A:''' This issue may be caused by your file system not supporting symlinks, which are enabled by Default in Core. To fix this, switch off the "Symlink Curation Content Folder" option on the Curate tab. This issue may arise if you're using Core on an external device such as a USB or portable hard drive. Keep in mind turning off symlink will disallow you from using the MAD4FP curation tool.

==Technical questions==

'''Q: [[#ActiveX|{{anchor|ActiveX|How does Flashpoint's ActiveX support work? What happens when an ActiveX control is registered?}}]]'''

'''A:''' [https://github.com/FlashpointProject/FlashpointSecureTools/tree/master/FlashpointSecurePlayer Flashpoint Secure Player] powers our ActiveX support. It provides a lightweight wrapper around Internet Explorer's engine, so it can load ActiveX controls just like Internet Explorer can. It has a significant advantage over Internet Explorer though: it allows us to use Internet Explorer's engine with Flashpoint but not change your Internet Explorer settings. It can load files through Flashpoint's proxy and load Flashpoint's ActiveX controls that do not work with Internet Explorer's default settings. In addition, Flashpoint Secure Player resets all changes that it makes to your system after it closes, meaning that ActiveX controls can be used without being permanently installed. All of the ActiveX controls supported by Flashpoint are included in the <code>FPSoftware\ActiveX</code> folder; no ActiveX controls are downloaded from the internet.

'''Q: [[#LaunchBox|{{anchor|LaunchBox|How can I add Flashpoint games to my LaunchBox collection?}}]]'''

'''A:''' You can use [https://forums.launchbox-app.com/files/file/2652-obbys-flashpoint-importer-for-launchbox/ this tool] to import games and playlists from Flashpoint into LaunchBox.

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

Extended FAQ

2022-01-18T18:20:07Z

Ardil: Include note about docker-based Linux version uninstallation.

Be sure to check the [https://bluemaxima.org/flashpoint/faq/ main FAQ] if you don't see your question here, then ask in the #flashpoint-help channel of [http://discord.gg/S9uJ794 our Discord] if you are still not satisfied. If you are using an old version of Flashpoint, you might also want to read the [[Extended FAQ/Legacy|Legacy FAQ]].

Note that not all entries here are fully up to date yet.

==General questions about the project==

'''Q: [[#WhyFlashpoint|{{anchor|WhyFlashpoint|Why do I need Flashpoint to play the games offline? Can't I just use a standalone player like the Flash Player projector to play them?}}]]'''

'''A:''' Many web games have what is known as a ''sitelock'', which means that they will not work unless they are being played on the original site they were hosted on. Since the projector is not connected to the Internet and cannot identify those sites, those games will refuse to load on it. Flashpoint gets around this by running the games through a ''local server proxy'' which, simply put, tricks them into thinking they are being played on the original sites they were meant to be played on. Moreover, web games are commonly spread across multiple files rather than just one; those are known as ''multi-asset'' games. Those games are less likely to run with just the projector on its own, but Flashpoint also deals with that. For more details, see [[How Flashpoint Works]].

'''Q: [[#ROM|{{anchor|ROM|Can I have a zip or ROM of a specific game? Can I download just the games I want?}}]]'''

'''A:''' Flashpoint simulates the internet in order to make games think they are playing on their original websites (see the previous answer for a more detailed explanation of that). Since the files are laid out the same way as they would be on the internet, games are not separated cleanly into ZIPs or "ROMs." Flashpoint Infinity downloads games on demand, so you can keep only the games you like by using Flashpoint Infinity.

'''Q: [[#FlashEOL|{{anchor|FlashEOL|Will Flash games disappear from the Internet when December 2020 hits?}}]]'''

'''A:''' They won't disappear by themselves. However, once Flash support is removed from browsers, most people won't be able to use flash content unless they downgrade their browser version. In addition, they will have to downgrade their Flash version to one that does not contain the [[#FlashKillSwitch|kill switch]]. In that situation, the sites that are hosting the games might decide to remove the Flash games because the vast majority of people won't be able to play them anymore. As we cannot rely on the assumption that sites might stay up, we're working hard to grab as many games as possible while they're still here. For more information on the road map for Flash's End of Life, see [[Flash EOL]].

'''Q: [[#FlashKillSwitch|{{anchor|FlashKillSwitch|I heard that Flash Player will block all Flash content from running after 2020. Will Flashpoint also stop working?}}]]'''

'''A:''' No. Flashpoint will continue to work in 2021 and beyond. The Flash plugin and projectors that we use do not contain the "kill switch"; this was added in a later version of the plugin.

'''Q: [[#Antivirus|{{anchor|Antivirus|My antivirus flagged Flashpoint! Does Flashpoint have any viruses?}}]]'''

'''A:''' Flashpoint does not have any viruses. However, a number of antivirus programs falsely detect certain files in Flashpoint as viruses. Avast, AVG, and BitDefender are even known to render Flashpoint inoperable; you'll need to follow the instructions for [[Troubleshooting Antivirus Interference]].

'''Q: [[#Legal|{{anchor|Legal|What is the legality of this?}}]]'''

'''A:''' "The only real answer is nobody knows and really, nobody should care. Games that more or less have a ticking clock until they die need to be saved now, as fast as possible."

''- BlueMaxima''

'''Q: [[#ArchivedWebsites|{{anchor|ArchivedWebsites|Where can I see what websites have been archived?}}]]'''

'''A:''' We are working on consolidating and listing all of our scrapes, but for now, there are several places to look.

* The [https://drive.google.com/open?id=1r8I5hpSPCf_9JWECwa6c4E4tQZELd3cx Flashfreeze Google Drive folder] contains all of our early site scrapes, up to August 1, 2018.

* A few more site scrapes are available from [https://archive.org/details/2018_Flash_In_The_Pan_Core_Sample this Archive.org item] and [https://archive.org/details/@bluemaxima BlueMaxima's Archive.org account].

* We track the sites we're saving on [https://docs.google.com/spreadsheets/d/1AwpA21I1HLacnDdQ_lRIMs1Yo3VC1uqRBq-mnRV11JU/edit this spreadsheet]. If you'd like a site saved, just add it to the appropriate column of the sheet.

* The #flashfreeze channel on our Discord server also has some leftover rips people have gotten into our [https://fpfss.unstable.life/web/flashfreeze/files submission system].

'''Q: [[#PlaySWF|{{anchor|PlaySWF|Can I use Flashpoint to play my own SWF or DCR files?}}]]'''

'''A:''' Follow our [[Curation Tutorial]] to add games to Flashpoint! Flashpoint comes with standalone projectors for Flash and Shockwave, and in some cases it will work to simply open an SWF with a Flash projector or open a DCR with a Director projector. But to ensure that games are preserved and work properly, you'll need to curate them.

'''Q: [[#HTML5|{{anchor|HTML5|Won't the games just be converted to HTML5?}}]]'''

'''A:''' No. HTML5 is an entirely different technology, so it's impossible for them to be converted automatically.
Developers could port them over to the platform, but most will not have the time or resources to do it. Besides, the capabilities of HTML5 are different from those of Flash, so a game ported to HTML5 will never be identical to the original.

'''Q: [[#Wayback|{{anchor|Wayback|Can't I use the Wayback Machine to play them?}}]]'''

'''A:''' The game has to be archived there in the first place, which may or may not happen. Wayback is specifically poor at grabbing multi-asset games (games that use more than one file), so chances are that it will not work there.
Games with sitelocks won't work there even if they are archived.

'''Q: [[#CheckTheMasterList|{{anchor|CheckTheMasterList|How do I check whether a game is in Flashpoint?}}]]'''

'''A:''' See [[Searching the Collection]].

'''Q: [[#OnlineMultiplayer|{{anchor|OnlineMultiplayer|Are you able to add/support this game? It's based on Facebook/is online multi-player.}}]]'''

'''A:''' Probably not. To support always online games, the emulation of a server is required. To be able to do that is almost as much work as all of Flashpoint itself, so it really wouldn't be practical to put time into.

'''Q: [[#NoNitrome|{{anchor|NoNitrome|Where are my favorite Nitrome games?}}]]'''

'''A:''' All of Nitrome's games were removed from Flashpoint 8.0 at Nitrome's request. This is in accordance with our [http://bluemaxima.org/flashpoint/faq/ removal policy]. If you disagree with Nitrome's decision, you may contact them and politely ask them to reconsider. ''Please do not harass or behave rudely towards Nitrome. They are within their rights to request removal; please respect that.''

'''Q: [[#ObjectionableContent|{{anchor|ObjectionableContent|Why is <questionable content> included in Flashpoint?}}]]'''

'''A:''' Web games, like any other form of art, have always been used as a medium for indie developers to exercise their freedom of expression. Often, this includes homophobic, racist, sexist, and other objectionable content. As a preservation project, Flashpoint aims to archive as much content as possible from this era. It will not play the role of gatekeeper so that future generations can see what these technologies were really used for. All of these works are a snapshot in time, and provide a window into what humans wanted to create at the turn of the century as the internet was in its infancy. You do not have to agree with nor enjoy said content. In order to responsibly provide the means to organize the vast collection that is Flashpoint, it's required to tag questionable content appropriately so that others may use search filters to exclude it from the rest.

'''Q: [[#NickRobinson|{{anchor|NickRobinson|I watched a video by Nick Robinson on YouTube which said that games in Flashpoint connect to the internet! Is this true?}}]]'''

'''A:''' The short answer is '''no''', this is not true. Games in Flashpoint never connect directly to the internet; they connect to Flashpoint's "fake internet," which is a proxy server running locally on your computer. If you are using Flashpoint '''Infinity''', this proxy server will connect to Flashpoint's server at <code>infinity.unstable.life</code> to download any files that are unavailable locally. Once the game files are downloaded, the game can be played offline. If you are using Flashpoint '''Ultimate''', an internet connection is never required to play games. See [[How Flashpoint Works]] for more information.

To address the specific claims in Nick Robinson's video: Mission in Snowdriftland has been fully archived in Flashpoint since 2019 and is fully playable offline in Flashpoint Infinity once the game files have been downloaded. We have tested this with all network adapters disabled via the Windows Control Panel. Nick Robinson used a third-party "internet killswitch" tool that may have interfered with Flashpoint in an unusual way. He did not speak to us before the publication of the video and did not report any issues with our software to us, but later corrected the claims in his video as a comment on the video's page.

==Setting up Flashpoint==

'''Q: [[#FlashpointEditions|{{anchor|FlashpointEditions|What version of Flashpoint should I get? What's the difference between Infinity and Ultimate?}}]]'''

'''A:''' If you have a lot of free disk space, bandwidth, and time, you should get Flashpoint Ultimate. But if you don't have a lot of free space, want to get Flashpoint up and running quickly, or only want to play a few games, you should get Flashpoint Infinity. See below for a detailed description of each edition of Flashpoint.
* '''Flashpoint Ultimate''': The full package. All games are fully playable offline. Also includes a logo and screenshot for each game. You'll need a few hundred gigabytes of free disk space - see the [https://bluemaxima.org/flashpoint/downloads/ Flashpoint downloads page] for more details.
* '''Flashpoint Infinity''': A minimalist build - games download as you choose to play them. Once games are fully downloaded, they will work offline. Logos and screenshots for games are also downloadable on demand, but Extras are not available.
* '''Flashpoint Core''': A lightweight copy of Flashpoint with one game per platform to aid curation. '''For developers and curators only!'''

'''Q: [[#UpdateFlashpoint|{{anchor|UpdateFlashpoint|How do I update Flashpoint when a new version is released?}}]]'''

'''A:''' If you have Flashpoint Ultimate, you can use [https://bluemaxima.org/flashpoint/downloads/#updater FlashpointUpdater]. There is no updater available for Flashpoint Infinity or Core yet; you'll need to [https://bluemaxima.org/flashpoint/downloads/ download] and extract the new version. You can transfer any playlists you'd like to keep to a new version of Flashpoint by following [[#TransferPlaylists|the instructions below]].

'''Q: [[#TransferPlaylists|{{anchor|TransferPlaylists|How do I move my playlists to a new version of Flashpoint?}}]]'''

'''A:''' If your '''old version''' of Flashpoint is '''8.1 or above''', you'll need to export your playlists first:
# Open your old copy of Flashpoint. Click the appropriate tab, then click the playlist you want to keep.
# Click the "Export playlist to a file" button (this is the 2nd button from the left).
# Repeat the process for any other playlists that you want to save.

To import your playlist files into your new copy of Flashpoint, follow these steps:
# Make sure you've closed your old copy of Flashpoint, then open the new one.
# If you are transferring a Games playlist, click the Games tab of the launcher. If you are transferring an Animations playlist, click the Animations tab.
# Scroll down to the bottom of the left sidebar, then click the "Import Playlist" button.
# Navigate to the folder where your old playlists are stored.
#* If your old version of Flashpoint is '''8.0 or below''', your playlist files will be located inside its <code>Data\Playlists</code> folder.
#* Otherwise, your playlist files will be located in the folder where you exported them.
# Double-click a playlist (JSON file) to import it. Repeat the process for any other playlists that you want to import.

'''Q: [[#UninstallFlashpoint|{{anchor|UninstallFlashpoint|How do I uninstall Flashpoint from my computer?}}]]'''

'''A:''' Flashpoint being a fully portable application, it can be uninstalled by simply deleting its main folder.

If you're using the docker-based Linux version, you will also need to delete all the <code>fpdocker-*</code> docker images. To do that, run the following in bash: <code>docker images | grep fpdocker | tr -s ' ' | cut -d ' ' -f 1-2 | sed 's/ /:/g' | xargs docker rmi</code>.

'''Q: [[#DownloadUltimate|{{anchor|DownloadUltimate|What's the best way to download Flashpoint Ultimate?}}]]'''

'''A:''' If you're updating to a new version or you're low on disk space, we recommend using [https://bluemaxima.org/flashpoint/downloads/#updater FlashpointUpdater]. In addition to updating an existing copy, it can also be used to download a full copy of Flashpoint Ultimate by pointing it at an empty folder. This lets you avoid downloading and extracting a 7Z file, saving a lot of disk space.

If you want the download to be as quick as possible, we recommend using the [https://bluemaxima.org/flashpoint/downloads/ torrent]. It will be faster, but it comes in the form of a large 7Z file. That means you'll need sufficient free disk space both to download and extract it.

'''Q: [[#Linux|{{anchor|Linux|Can I use Flashpoint on Linux?}}]]'''

'''A:''' Yes, although not all platforms and features are supported. See [[Linux Support]].

'''Q: [[#Mac|{{anchor|Mac|Can I use Flashpoint on Mac?}}]]'''

'''A:''' A heavily experimental Flashpoint package is available for MacOS. See [[Mac Support]].

== Playing games ==

'''Q: [[#LauncherShortcut|{{anchor|LauncherShortcut|How do I create a shortcut to Flashpoint on my desktop/taskbar/start menu?}}]]'''

'''A:''' Go into the <code>Launcher</code> folder that's inside your Flashpoint directory and look for <code>Flashpoint.exe</code>. Right-click it and click <code>Send to > Desktop (create shortcut)</code>, or drag it to your taskbar or start menu. '''CAUTION: Do NOT drag <code>Flashpoint.exe</code> directly to your desktop as that will move the file, which will make the launcher not work.'''

'''Q: [[#GameShortcut|{{anchor|GameShortcut|How do I create a shortcut to a specific game/animation in Flashpoint?}}]]'''

'''A:''' This feature is planned for Flashpoint Launcher, but for now, you'll need to download two separate tools. Follow the steps below:
# Download the [https://github.com/oblivioncth/CLIFp/releases/latest latest release of CLIFp].
# Extract the ZIP file and move <code>CLIFp.exe</code> into your Flashpoint folder.
# Download [https://github.com/maichiu/FlashpointShortcutMaker/archive/main.zip Flashpoint Shortcut Maker].
# Extract the ZIP file and move <code>FlashpointShortcutMaker.vbs</code> into your Flashpoint folder.
Now that you have CLIFp and Flashpoint Shortcut Maker set up, follow the steps below to create a shortcut:
# Open Flashpoint Launcher and find the game/animation that you want to create a shortcut for.
# Right-click the game/animation and click "Copy Game UUID".
# Double-click FlashpointShortcutMaker.vbs.
# Paste the UUID of the game/animation that you copied in step 2. Click OK, and a shortcut will appear on your desktop!

'''Q: [[#GameNotFound|{{anchor|GameNotFound|Why can I not find ''X'' game/animation in the launcher? Why do some games/animations not appear?}}]]'''

'''A:''' There are a few possibilities:

* Make sure you spelled the name of the game/animation correctly when searching. If a search fails, try searching for partial names rather than full names. Varying punctuation is also a common culprit. We are planning on overhauling the Search feature to allow for more customizable and dynamic browsing in the future, so stay tuned!
* If the game/animation has adult content, it might have been marked as Extreme, in which case you'll need to follow [[#ShowExtreme|these instructions]] before it will be visible.
* Make sure you don't have a playlist selected by accident; Searching in a playlist will look for the game ''in that playlist specifically''. So make sure you have ''All Games'' selected in the left-hand column before making your search.
* If you see the game on the [[Searching the Collection|Master List]] but don't see it in Flashpoint Infinity, then it might only be available in Flashpoint Ultimate. Follow [[#GameDisappeared|these steps]] to show broken games in Infinity, then search for the game again. If you see the game and the "Broken (in Infinity)" checkbox is checked, that means the game is only available in Flashpoint Ultimate.
* It's also possible that we don't have the game yet. If you wish to request a game or an animation to be added to Flashpoint, you can do so via the [[Request Form]]. Alternatively, if you want to ensure that the game/animation is added, you can learn how to ''curate'' it yourself by following our [[Curation Tutorial]]. '''In either case, please thoroughly search the master lists above to make sure that we don't have the game or animation already.'''

'''Q: [[#ShowExtreme|{{anchor|ShowExtreme|How do I show/hide Extreme content in Flashpoint?}}]]'''

'''A:''' To show Extreme content in Flashpoint, first click the Config tab of the launcher and turn on "Extreme Content." Next, scroll down to the "Tag Filter Groups" section and turn ''off'' the specific tag filter groups applicable to the content you want to view. Because a lot of Extreme content has not been categorized yet, you may also need to turn off the "Extreme Generic" filter.

To hide extreme content, just reset the settings mentioned above. If you want to hide these settings altogether, for example if you have children using Flashpoint, you can edit the file <code>config.json</code> with any text editor to change the <code>false</code> value next to <code>disableExtremeGames</code> to <code>true</code>, saving the file afterwards.

'''Q: [[#Fullscreen|{{anchor|Fullscreen|Can I play the games in fullscreen? Can I make them bigger?}}]]'''

'''A:''' The answer depends on the type of game you're playing. See below:
* For Flash games that open in the Flash projector, you can drag the corner of the window to resize it. Do your best to maintain the window's original aspect ratio, otherwise some games might behave in unexpected ways.
* For Flash, Shockwave, and Java games, you can play them in fullscreen using [http://tanalin.com/en/projects/integer-scaler/ IntegerScaler]. However, this program doesn't play well with multi-monitor setups.
* For most games that open in a browser, you can press <code>Ctrl</code> + <code>+</code> and <code>Ctrl</code> + <code>-</code> (Ctrl-plus and Ctrl-minus) to zoom in and out. In most cases, fullscreen is not possible for these games.
* Another option for Shockwave is to use SPRS, a version of the Shockwave projector that runs the games in fullscreen. Though keep in mind that this feature is experimental and has only been tested with a handful of games, therefore it may not work well with all games.

To use SPRS:

# Click the pencil icon on the upper right of the game info section for the game you want to play in fullscreen (if you don't see the icon, enable editing on the <code>Config</code> tab).
# Scroll down to the field labeled <code>Application Path</code> and change <code>SPR.exe</code> to <code>SPRS.exe</code>.
# Click the checkmark button at the top to confirm.
# Launch the game.

To close the game, press <code>Esc</code> (or alternatively, <code>Alt</code> + <code>F4</code>).

'''Q: [[#RecentGames|{{anchor|RecentGames|Can I view a list of my recently played games?}}]]'''

'''A:''' Flashpoint does not track your recently played games by default, but you can install the [https://github.com/LeShaps/FPL-History FPL History] extension to add this functionality. See the [[Launcher Extensions]] page for more information.

'''Q: [[#EnableEditing|{{anchor|EnableEditing|How do I edit a game or playlist in my copy of Flashpoint?}}]]'''

'''A:''' Click the Config tab of Flashpoint Launcher, then check the "Enable Editing" box. Then click "Save and Restart." When Flashpoint Launcher re-opens, you'll notice the following changes:
* Dragging a game onto a playlist in the left sidebar will add the game to the playlist.
* Clicking the pencil button on the right sidebar will allow you to edit a game entry.
* Double-clicking the trash icon will allow you to delete a game or playlist.
* When a playlist is selected, double-clicking the X button on the right sidebar will remove the currently selected game from the playlist.

'''Q: [[#GameAssets|{{anchor|GameAssets|Where are the games stored?}}]]'''

'''A:''' If you have Infinity 9.0 or higher the games and all of their assets are stored in the <code>Legacy\htdocs</code> folder within Flashpoint's directory (wherever you extracted it to). In Ultimate non-zipped games are stored in the same place <code>Legacy\htdocs</code>, zipped games are stored in <code>Games</code>. To find the files for a specific game, right-click the game entry in Flashpoint Launcher, then click "Open File Location."

'''Q: [[#SaveData|{{anchor|SaveData|Where is the games' save data kept? How can I delete it/transfer it to another computer/drive?}}]]'''

'''A:''' You can find the location where each platform keeps their save data in [[Save Data Locations]]. For your convenience, there are two batch scripts included in Flashpoint's <code>FPSoftware</code> folder which can be used to back up and restore Flash save data to another computer or drive; Namely ''Saves Manager - Backup.bat'' and ''Saves Manager - Restore.bat''. If you want to delete save data or manage non-Flash data, you are going to have to find it manually at the locations listed on the aforementioned page.

'''Q: [[#HappyWheels|{{anchor|HappyWheels|I want to play Happy Wheels! What should I download?}}]]'''

'''A:''' We have a few options:
* The Happy Wheels Demo is available in Flashpoint Infinity. The demo is missing the user levels and other extra content from the full version.
* The full version of Happy Wheels is included with Flashpoint Ultimate. It includes all user levels up to 2019-03-24.
* We also offer a standalone download called [https://archive.org/download/Happy_Wheels_Offline/Happy%20Wheels%201.1.zip Happy Wheels Offline]. It only includes user levels up to 2018-11-26, but it's only 8GB.

'''Q: [[#MoshiMonsters|{{anchor|MoshiMonsters|I want to play Moshi Monsters! What should I download?}}]]'''

'''A:''' Moshi Monsters is available in [https://bluemaxima.org/flashpoint/downloads/ Flashpoint Ultimate and Infinity]. If you want a full, offline copy of Moshi Monsters but don't want to download Flashpoint Ultimate, you can download our [https://download.unstable.life/static/Moshi.7z standalone Moshi Monsters package].

==Troubleshooting==

'''Q: [[#OldInfinityVersions|{{anchor|OldInfinityVersions|Why doesn't my old version of Flashpoint Infinity work anymore? I can't download games or logos/screenshots.}}]]'''

'''A:''' Due to SSL certificate issues outside of our control, old versions of Flashpoint Infinity (10.0 and below) do not work anymore. You will need to [[#UpdateFlashpoint|update to the latest version of Flashpoint]].

'''Q: [[#WhiteScreenAndNoImages|{{anchor|WhiteScreenAndNoImages|I'm using Flashpoint Infinity, launching games always shows a blank white screen, and no logos and screenshots are loading! How do I fix this?}}]]'''

'''A:''' Follow each of these steps and check to see if Flashpoint works properly after each one. If it still shows a white screen, try the next step.
# Follow the [[Troubleshooting Antivirus Interference|antivirus interference]] steps to prevent an antivirus such as Avast or AVG from interfering with Flashpoint.
# If Flashpoint still doesn't work, your router probably has internet filtering software installed that is blocking our Infinity server. A common one is McAfee Secure Home Platform; [https://service.mcafee.com/webcenter/portal/cp/home/articleview?locale=en_US&articleId=TS102694 here is how to disable it].
# If Flashpoint still doesn't work, you might be experiencing a different problem. Follow the Troubleshooting steps in the [https://bluemaxima.org/flashpoint/Manual.pdf Manual].

'''Q: [[#UltimateBrokenAfterUpdate|{{anchor|UltimateBrokenAfterUpdate|After I updated to Flashpoint 9.0 Ultimate using the updater, no games are working! Is there a fix?}}]]'''

'''A:''' Follow the steps below to fix the problem:
# Download [http://infinity.unstable.life/Flashpoint/Server/alpine.qcow2 this file].
# Replace the existing file in Flashpoint's <code>Server</code> folder with the file that you downloaded.

'''Q: [[#NotWorkingOffline|{{anchor|NotWorkingOffline|I disconnected from the internet and now games don't show up! How do I fix this?}}]]'''

'''A:''' Click the Config tab of Flashpoint Launcher, then uncheck the "On Demand Images" box. Then click "Save and Restart." When Flashpoint Launcher re-opens, the problem will be fixed.

'''Q: [[#LauncherNotOpening|{{anchor|LauncherNotOpening|When I double-click Flashpoint.exe, nothing happens! What can I do?}}]]'''

'''A:''' When you open Flashpoint Launcher, a bug may occur that prevents it from showing the window. If this happens, open Windows Task Manager, click the Details tab, and look for any process named <code>Flashpoint.exe</code>. Then click "End Process", and double-click Flashpoint.exe again to see if it starts normally.

If the issue persists, or if the Launcher doesn't open ''after'' the first time you started it, close all Flashpoint processes again, then look for a 0 KB <code>preferences.json</code> file in the same location as the <code>Start Flashpoint</code> shortcut. If it is 0 KB, replace it with this [https://infinity.unstable.life/Flashpoint/preferences.json default preferences file]. Once done, launch Flashpoint using the <code>Start Flashpoint</code> shortcut and it should now open normally. Note: If you previously changed some settings on the <code>Config</code> tab, you will have to set them again.

If you have Hyper-V/WSL/WSA installed, the problem could be caused by Flashpoint's backend port being in Hyper-V's reserved port range, resulting in Flashpoint receiving an EACCES when it tries to bind. A fix for this is in development, but for now: restarting your computer should reset the reserved port range. For a more long-term solution, add port 12001 to the excluded port range as seen [https://stackoverflow.com/a/54727281 here].

'''Q: [[#MissingFolder|{{anchor|MissingFolder|I extracted Flashpoint into my Downloads folder, but now I can't find it! Where is my Flashpoint folder?}}]]'''

'''A:''' If your Downloads folder is grouped by date, you'll need to scroll down to the "Earlier this year" or "A long time ago" section to find your Flashpoint folder. This is because Flashpoint's files were packed into the installer "a long time ago", so they appear on your computer as being from that date, even though the installer file itself was downloaded to your computer recently.

'''Q: [[#GameDeleted|{{anchor|GameDeleted|I accidentally deleted a game/animation from Flashpoint! How can I reset it?}}]]'''

'''A:''' Follow the steps below:
# [[#TransferPlaylists|Back up any playlists that you want to keep]].
# Get the appropriate database file for your edition of Flashpoint:
#* If you are using Flashpoint Ultimate, download the [http://infinity.unstable.life/Flashpoint/Data/flashpoint.sqlite database file]. Then open your copy of Flashpoint Ultimate and replace the <code>flashpoint.sqlite</code> file inside its <code>Data</code> folder with the file you downloaded.
#* If you are using Flashpoint Infinity, just re-extract it. [https://bluemaxima.org/flashpoint/downloads/ Re-download it first] if you don't have the original file anymore.
# [[#TransferPlaylists|Restore any playlists that you backed up]].

'''Q: [[#GameDisappeared|{{anchor|GameDisappeared|I accidentally marked a game as <code>Broken (in Infinity)</code>, and it disappeared! How do I find it again?}}]]'''

'''A:''' Follow these steps:
# Navigate to the Flashpoint folder.
# Open the <code>preferences.json</code> file in a text editor such as Notepad.
# Find the line that says <code>"showBrokenGames": false,</code> and change <code>false</code> to <code>true</code>.
# Save the file and restart Flashpoint.

'''Q: [[#ToggleSidebars|{{anchor|ToggleSidebars|I can't see the left (or right) sidebar of the launcher anymore! Where did it go?}}]]'''

'''A:''' Click the arrow buttons on the top-right corner of the launcher to toggle the left and right sidebars. --->
[[File:ShowHideSidebars.png]]

'''Q: [[#Logos|{{anchor|Logos|Why can't I see the games' logos/screenshots?}}]]'''

'''A:''' Flashpoint Infinity does not come with the game logos by default due to size reasons. However, they can be downloaded on demand as you use Flashpoint. First, click the Config tab of Flashpoint Launcher and make sure the "On Demand Images" box is checked. Then switch to the ''Grid'' viewing mode using the drop-down menu at the bottom-right corner of the launcher window.

'''Q: [[#OpenTorrentFile|{{anchor|OpenTorrentFile|Why won't my Ultimate torrent open?}}]]'''

'''A:''' You will need a torrent client such as [https://www.qbittorrent.org/ qBittorrent] to open the .torrent file. The .torrent file tells your torrent client how to download Flashpoint Ultimate.

'''Q: [[#IATorrentBad|{{anchor|IATorrentBad|The torrent won't download, even though I'm using a torrent client! What's the problem?}}]]'''

'''A:''' Do '''not''' use the torrent from Archive.org! Because of the size of Flashpoint Ultimate, Archive.org will not seed its torrent. Instead, use the torrent link on [https://bluemaxima.org/flashpoint/downloads/ Bluemaxima.org].

'''Q: [[#FlashpointNotWorking|{{anchor|FlashpointNotWorking|Why is Flashpoint not working after my download?}}]]'''

'''A:''' Make sure you unzip the program, as it will not work while still zipped. Please use [https://www.7-zip.org 7-Zip] when doing this, as WinRAR is known to fail. If Flashpoint is still not working, follow the Troubleshooting steps in the [https://bluemaxima.org/flashpoint/Manual.pdf Manual].

'''Q: [[#Corrupted7ZFile|{{anchor|Corrupted7ZFile|When I try to open the Flashpoint Ultimate 7Z file with 7-Zip, it says "Cannot open as archive." What's the problem?}}]]'''

'''A:''' The download was probably corrupted. Browsers are not designed to download gigantic files like Flashpoint Ultimate, so you'll need to use a download manager such as [https://www.freedownloadmanager.org/ Free Download Manager] to download the file.

'''Q: [[#CheckHash|{{anchor|CheckHash|How can I check whether Flashpoint Ultimate downloaded successfully?}}]]'''

'''A:''' You'll need to check whether the hash of the file you downloaded matches the expected hash. First, install [https://www.7-zip.org 7-Zip] if you don't have it already. Next, follow these steps:
# Right-click the 7Z file that you downloaded.
# Choose "CRC SHA...", then choose SHA1 or CRC32.
# Go to the [https://bluemaxima.org/flashpoint/downloads/ Flashpoint downloads page] and click the button labeled "Mirror" or "Archive.org" underneath the Flashpoint Ultimate heading. This should take you to Flashpoint Ultimate's Archive.org entry.
# Scroll down and find the "Download Options" sidebar on the right. Click the "Show All" link.
# Click the file ending in <code>_files.xml</code>. For example, on Flashpoint 6.3's page, the file is called <code>Flashpoint6.3_files.xml</code>.
# You should see a list of files in XML format. Check the hash listed for the file, and make sure it matches the hash you found in Step 2. For example, if you chose CRC32 in Step 2, make sure the CRC32 hashes are the same.

'''Q: [[#InfinityPartialDownloads|{{anchor|InfinityPartialDownloads|Most games are working, but when I try to open a specific game, I get an error like one of these:}}]]'''
* "The file __ is not a Director file."
* "Error launching Unity Player: bad file length"
* "Failed to initialize player's 3D settings"
* A stuck loading bar
* Partially loaded images, missing elements on a page or in a game, or other problems indicating file corruption

'''A:''' If you are using Flashpoint Infinity, it's very likely that Flashpoint Router failed to download a complete file. To solve the problem, follow these steps:
# Right-click the game that you are trying to play, then click "Open File Location."
# This will open a folder; delete all of the files there.
# Clear the cache by following [[#ClearWinINetCache|these steps]].
# Try launching the game again.
If the problem persists, try [[#UpdateRouter|updating Flashpoint Router]]. If that doesn't help, follow the Troubleshooting steps in the [https://bluemaxima.org/flashpoint/Manual.pdf Manual].

'''Q: [[#UpdateRouter|{{anchor|UpdateRouter|How do I update Flashpoint Router?}}]]'''

'''A:''' Follow these steps:
# Download this file: https://raw.githubusercontent.com/FlashpointProject/Flashpoint-Router/master/router.php
# Place the downloaded file in the <code>Legacy</code> folder of your Flashpoint folder, overwriting the original <code>router.php</code> file.

'''Q: [[#3DVIAAudioBug|{{anchor|3DVIAAudioBug|I am playing a 3DVIA Player webgame and the audio is loud and distorted, how do I fix it?}}]]'''

'''A:''' Your computer has a codec issue with MP3 playback. To resolve this:
# Install K-Lite Codec Pack if you do not already have it installed.
# Open Codec Tweak Tool from the Start Menu.
# In Codec Tweak Tool, go to Codec and Filter Management > Directshow (x86) and check the box for LAV Audio Decoder.
# Click Apply & Close to disable the filter.
# Exit Codec Tweak Tool.

'''Q: [[#ServerExited|{{anchor|ServerExited|Games are not working, and an error like this one appears constantly in the Launcher's logs:}}]]'''
Server exited with code 3221225781

'''A:''' First, make sure that you have installed all of the latest Windows Updates. Next, install the [https://dotnet.microsoft.com/download/dotnet-framework/net47 Microsoft .NET Framework] and the [https://www.microsoft.com/en-us/download/details.aspx?id=48145 Visual C++ 2015 x86 Redistributable]. When you install the Visual C++ Redistributable, '''make sure to install the x86 version''', even if you're on a 64-bit machine!

'''Q: [[#LauncherBlackScreen|{{anchor|LauncherBlackScreen|When I open Flashpoint all I get is a black/grey screen. What should I do?}}]]'''

'''A:''' If your computer has an older graphics card, it may not support the launcher's hardware acceleration. To get around this, disable hardware acceleration by following these steps:

# In your main Flashpoint folder, select the <code>Start Flashpoint</code> shortcut by clicking it once.
# Press <code>Alt</code> + <code>Enter</code> to bring up its properties window.
# In the <code>Target</code> field, add a space at the very end of the field followed by <code>--disable-gpu</code>.
# Click OK
# Launch Flashpoint by double-clicking the <code>Start Flashpoint</code> shortcut.

Note that this change only affects the launcher itself, and shouldn't have any impact on its performance.

'''Q: [[#MarioBrosCrossoverIssue|{{anchor|MarioBrosCrossoverIssue|Most games are working, but when I launch a Flash game such as Super Mario Bros. Crossover, it crashes on a black screen! What's the fix?}}]]'''

'''A:''' Follow the steps below to fix the problem:
# Open your Flashpoint folder and navigate to the <code>Legacy\htdocs</code> folder.
# Delete the <code>data.explodingrabbit.com</code> folder.
# Clear the cache by following [[#ClearWinINetCache|these steps]].

'''Q: [[#UnityUpdatePlugin|{{anchor|UnityUpdatePlugin|Some Unity games ask to update the plugin and will not play the game! What's the fix?}}]]'''

'''A:''' Follow the steps below to fix the problem:
# Open your Flashpoint folder and navigate to the <code>FPSoftware\FlashpointSecurePlayerConfigs</code> folder.
# Extract [https://cdn.discordapp.com/attachments/596548932373577750/802693500218114058/unitywebplayer.7z this file] into the folder, confirm to replace files.
# Restart Flashpoint.

==Work & Curation==

'''Q: [[#SubmitGame|{{anchor|SubmitGame|What is the difference between requesting and curating a game? Can I "submit" a game?}}]]'''

'''A:''' Requesting - This option adds your game to an ever-growing list of ones people want added. You will need to fill out the request form which takes 1-5 minutes. Chances of game being saved by any of the curators is small because there are thousands of games waiting on the list, some of which have been waiting for over a year. If you want to increase the chances of it being saved, we suggest that you try to write an engaging description of the game and/or the reason you want it saved.

Curating - This is the process of actually adding the game to Flashpoint. It requires testing the game using procedures detailed in our curation guides. It takes about 30 minutes to do the first time, but as you learn the process you can get it under 5 minutes.
To get started, follow our [[Curation Tutorial]].
Once you curate a game, it will be saved and added to the next version of Flashpoint.

If you'd like to learn more about the concept of digital curation, read [https://en.wikipedia.org/wiki/Digital_curation this article]. It explains the principles behind what we do.

'''Q: [[#MetadataEdits|{{anchor|MetadataEdits|How do I correct a problem with a game's metadata? Does editing the game in my copy of Flashpoint update it for everyone?}}]]'''

'''A:''' No, editing a game in your copy of Flashpoint does not update it for everyone. To get your change included in the next version of Flashpoint, follow the instructions in the [[Metadata Edits]] page.

'''Q: [[#ScrapeWebsites|{{anchor|ScrapeWebsites|What tools should I use to archive whole websites?}}]]'''

'''A:''' See [[Helpful Tools#Software for Archiving|Helpful Tools]].

'''Q: [[#WhatPlatform|{{anchor|WhatPlatform|How do I tell what platform a game is?}}]]'''

'''A:''' The easiest way to check these kinds of things is to right-click the game window and look at the context menu that appears. If it says something about Flash, it's a Flash game. If it says nothing out of the ordinary or no context menu appeared, it's probably HTML5. See [https://media.discordapp.net/attachments/509676268719964160/692059796957954079/unknown.png this image] for a summary.

You can also use Inspect Element to look at the embed of the game for the following file extensions:

.swf - Flash

.dcr/.dir/.dxr - Shockwave

.unity3d - Unity Web Player

.jar/.class - Java

.stk - ShiVa3D

.xap - Silverlight

.vmo - 3DVIA

If a game runs only in Internet Explorer, references a .cab file, and is not one of the above types of games, it is probably an ActiveX game.

If a game does not require any plugins or ActiveX controls to run, then it is probably an HTML5 (or HTML/JavaScript) game.

If it's something else it may be under one of our other platforms, but these are the most common types.

'''Q: [[#SubmitSWFs|{{anchor|SubmitSWFs|Where can I submit my collection of SWFs?}}]]'''

'''A:''' [http://bluepload.unstable.life/ This is our public upload location.]

It is highly encouraged that you first [[#CheckTheMasterList|check whether each game/animation is already in Flashpoint]] and only upload ones that are not.

'''Q: [[#Decompiler|{{anchor|Decompiler|What is a good tool to decompile/hack SWF files (Flash games)?}}]]'''

'''A:''' The recommended program for this purpose is ''[https://github.com/jindrapetrik/jpexs-decompiler/releases JPEXS Free Flash Decompiler]''.

'''Q: [[#ClearWinINetCache|{{anchor|ClearWinINetCache|How do I clear the Flash projector's cache?}}]]'''

'''A:''' The Flash projectors use WinINet to perform network requests. Some other Flashpoint platforms, such as 3D Groove GX, also use WinINet. To clear the cache for these programs, follow these steps:
# Navigate to the FPSoftware folder within your main Flashpoint folder.
# Double-click the <code>Clear_FP_Cache.bat</code> file to run it.
Alternatively, you can run the command manually by following these steps:
# Press Windows-R to open the Run box.
# Type or paste in the following command, then press Enter: <code>RunDll32.exe InetCpl.cpl,ClearMyTracksByProcess 8</code>
Note that for games that use the Basilisk browser, you will need to [[#ClearBasiliskCache|clear Basilisk's cache]] instead.

'''Q: [[#ClearBasiliskCache|{{anchor|ClearBasiliskCache|How do I clear the Basilisk browser's cache?}}]]'''

'''A:''' Open the Basilisk browser and follow these steps:
# Press the <code>Alt</code> key
# Click "History," then "Clear Recent History..."
# Change the time range to "Everything" using the dropdown menu, then check the boxes next to "Cache" and "Offline Website Data."
# Click "Clear Now."

'''Q: [[#AlternatePlatformCuration|{{anchor|AlternatePlatformCuration|I'm curating an HTML5 version of a Flash game that is already in Flashpoint (or the other way around). Should I submit it as alternate of Flashpoint's existing entry?}}]]'''

'''A:''' No, you will need to submit a new, separate curation. Currently, alternate versions of a game are required to be of the same [[Platforms|Platform (technology)]] as the main game entry.

'''Q: [[#cgibin|{{anchor|cgibin|My curation works fine in Flashpoint Core, but when I import it into Infinity, it doesn't work anymore! Is there a problem with my curation?}}]]'''

'''A:''' Probably not. For Infinity, files need to be placed in the <code>cgi-bin</code> folder, following the same structure as they would in the <code>htdocs</code> folder, if they meet one of these criteria:
* The file has a PHP, PHP5 or PHTML extension. These files are always loaded from cgi-bin.
* The file doesn't have one of these extensions, but does have a PHP script in it that you intend to run.

This restriction exists because it would be unsafe for Infinity to download and execute PHP on demand.

If your curation does not include any PHP scripts and it still isn't working, [[#ClearWinINetCache|clear the cache]] and try launching the game again.

'''Q: [[#cURLsDownloaderBug|{{anchor|cURLsDownloaderBug|After I type a URL or filename into the cURLsDownloader window, it immediately closes! Am I doing something wrong?}}]]'''

'''A:''' This bug is fixed in the latest version of cURLsDownloader. You can find the download link on the [[Helpful Tools#Software for Archiving|Helpful Tools]] page.

'''Q: [[#NoTags|{{anchor|NoTags|I filled out tags for my curation, but after I exported it, I noticed that the tags are missing! Why did this happen?}}]]'''

'''A:''' To add a tag to your curation, first type it into the Tags box, then ''select'' it by either clicking it, or pressing the Tab key and hitting Enter when the tag is highlighted. '''If you type a tag without selecting it, it will not be added to your curation!'''

'''Q: [[#CurateTabWhiteScreen|{{anchor|CurateTabWhiteScreen|I'm using Flashpoint Core, and launching my curations shows a blank white screen. What do I do?}}]]'''

'''A:''' This issue may be caused by your file system not supporting symlinks, which are enabled by Default in Core. To fix this, switch off the "Symlink Curation Content Folder" option on the Curate tab. This issue may arise if you're using Core on an external device such as a USB or portable hard drive. Keep in mind turning off symlink will disallow you from using the MAD4FP curation tool.

==Technical questions==

'''Q: [[#ActiveX|{{anchor|ActiveX|How does Flashpoint's ActiveX support work? What happens when an ActiveX control is registered?}}]]'''

'''A:''' [https://github.com/FlashpointProject/FlashpointSecureTools/tree/master/FlashpointSecurePlayer Flashpoint Secure Player] powers our ActiveX support. It provides a lightweight wrapper around Internet Explorer's engine, so it can load ActiveX controls just like Internet Explorer can. It has a significant advantage over Internet Explorer though: it allows us to use Internet Explorer's engine with Flashpoint but not change your Internet Explorer settings. It can load files through Flashpoint's proxy and load Flashpoint's ActiveX controls that do not work with Internet Explorer's default settings. In addition, Flashpoint Secure Player resets all changes that it makes to your system after it closes, meaning that ActiveX controls can be used without being permanently installed. All of the ActiveX controls supported by Flashpoint are included in the <code>FPSoftware\ActiveX</code> folder; no ActiveX controls are downloaded from the internet.

'''Q: [[#LaunchBox|{{anchor|LaunchBox|How can I add Flashpoint games to my LaunchBox collection?}}]]'''

'''A:''' You can use [https://forums.launchbox-app.com/files/file/2652-obbys-flashpoint-importer-for-launchbox/ this tool] to import games and playlists from Flashpoint into LaunchBox.

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

Extended FAQ

2022-01-18T18:13:13Z

Ardil: Add note about Hyper-V reserved port range.