frenchpress - Spiral Knights Steam login shim and UI

A simple, lightweight, and functional Java shim library that shadows Spiral Knights' steam_api library calls from froth-foamy and passes them to JavaSteam to facilitate Steam-linked account logins without requiring an entire native Steam process running in the background.

Requirements

• Maven
• JDK 25

Building

mvn package

Usage

Place frenchpress.jar first in the classpath when invoking the JVM to run Spiral Knights along with the flag -Dcom.threerings.froth.disable_steam_api=true to prevent it from trying to load the actual steam_api calls, otherwise it will fail without an actual Steam client running.

For example:

java --class-path frenchpress.jar:all:other:required:Spiral:Knights:JAR:files \
    -Dcom.threerings.froth.disable_steam_api=true \
    -Dorg.lwjgl.util.NoChecks=true \
    -Dsun.java2d.d3d=false \
    -Dappdir=/your/Spiral/Knights/directory \
    -Dresource_dir=/your/Spiral/Knights/directory/rsrc \
    -Dcrucible.dir=/your/Spiral/Knights/directory/crucible \
    --add-opens=java.base/java.lang=ALL-UNNAMED \
    --add-opens=java.base/java.util=ALL-UNNAMED \
    --enable-native-access=ALL-UNNAMED \
    com.threerings.projectx.client.ProjectXApp client

Credentials

On first launch (or after a stored token expires/is revoked) frenchpress needs Steam credentials. It tries the following in order:

1. Stored token : Written automatically after a successful login.
2. Environment variables : FRENCHPRESS_STEAM_USER and FRENCHPRESS_STEAM_PASS.
3. Interactive prompt : A login dialog is shown automatically on desktop JVMs. Android hosts or applications that wish to customize the prompt may call CredentialPrompt.register(impl) early with a native dialog implementation.

If Steam Guard 2FA is required, a second dialog appears and the user can either approve the sign-in from the Steam Mobile App or enter their 2FA code.

Submitting the dialog with no username skips Steam login entirely and lets Spiral Knights proceed with a Three Rings / Grey Havens web account.

References

Three Rings Design / Grey Havens

• Spiral Knights : A really cool MMO you should play
• froth : The OG implementation of Spiral Knights' Steam API Java calls
• froth-foamy : The new, cooler, and current implementation of Spiral Knights' Steam API Java calls

Longi94 and Contributors

• JavaSteam : Java port of SteamKit2