# Streamer

Runs a Flashpoint game natively on the server and streams it to the browser with
[Selkies](https://github.com/selkies-project/selkies), for platforms that cannot
run in a browser. One container plays one game, set by `GAME_ID`. It launches
games the way Flashpoint's Linux launcher does, so Java applets, Shockwave and
Flash run, as do Windows games installed under `LocalGames/<name>/` with an
application path of `LocalGames\<name>\<game>.exe`.

## Requirements

A Linux Flashpoint install. The streamer uses the Infinity build's
`Server/FlashpointGameServer`, `FPSoftware/Java` and `FPSoftware/Wine`, which
Ultimate's archives only include for Windows.
`scripts/setup-flashpoint.sh --infinity` adds them without overwriting
anything.

## Running one by hand

The session manager normally starts these. To debug a game on its own:

```sh
docker build -t dotcom-arcade-streamer streaming/streamer
docker run --rm --shm-size 1g -p 3001:3001 \
  -v /path/to/flashpoint:/flashpoint:ro \
  -e GAME_ID=<game id> -e SELKIES_MANUAL_WIDTH=800 -e SELKIES_MANUAL_HEIGHT=600 \
  -e RESTART_APP=true -e NO_DECOR=true \
  dotcom-arcade-streamer
```

Open `https://<host>:3001` and accept the self-signed certificate. The launch
log is at `/config/fp-launch.log` inside the container.

## How it works

`fp-launch` follows the Flashpoint launcher's Linux launch sequence: it starts
the game server, mounts the game's zip through the server's `mountzip` API, and
runs the game's application with its HTTP proxy pointed at the game server.
Selkies restarts the game when it exits (`RESTART_APP`).

`appletviewer` lacks two things applets got from the browser's Java plugin, so
the image adds them: a `netscape.javascript.JSObject` stand-in whose window has
a `document.cookie` that persists to `/config/saves/cookies.txt`, and a policy
allowing HTTP requests through the game server's proxy. The same jar
(`applet-support/`) is loaded as a Java agent that removes appletviewer's menu
bar and status line.

Other games go through `fp-command`, which applies the launcher's rules: it maps
the application path through `Data/execs.json`, swaps `.bat` for `.sh`, and runs
`.exe` files under Flashpoint's bundled Wine. Windows programs run from a
writable mirror of the install, since they write beside themselves; a
Director projector's `Prefs`, where it saves, is linked into `/config/saves`, as
is Flash Player's save directory, so the session manager syncs both to the
player's browser. OldCPUSimulator hangs under Wine, so its target runs under
`cpulimit` at the same share of the CPU. A Flash projector's window is
stretched to the display and moved up by its menu bar's height, which hides the
menu bar. GTK draws the menu bar in the window itself and the movie in a child
window below it, so the movie's offset, read with `xwininfo`, is the menu bar's
height. The window is made override-redirect first, since the window manager
keeps windows on screen, and is kept in place while it's open, since Flash
Player moves it back once the movie has loaded. Its full-screen mode isn't used, since some games, such
as Bloons, don't play right in it. Flashpoint Navigator's toolbars are hidden.