# Player client setup

Voxel Slop Alpha 0.3.17 has a self-contained Windows installer and a portable
macOS player archive. Both include the game and the correct graphics libraries.
The Windows installer also includes its own Java runtime.

## Requirements

- a GPU and driver with OpenGL 3.3 support; and
- the username and password supplied with your invitation; and
- internet access to `play.projectslop.xyz`.

## Windows x64

1. Run `VoxelWorld-0.3.17-client-windows-x64-setup.exe`. Choose the install
   directory and whether to add the optional Desktop shortcut; the installer
   always creates Start Menu play and uninstall shortcuts.
2. Launch Voxel Slop from the Start Menu. The play shortcut uses the branded
   `Voxel Slop.exe` application, not a batch file or Command Prompt window.
3. After the pig-and-arrow splash, leave `play.projectslop.xyz` selected and
   enter your username and password.

No separate Java or JDK installation is needed. The setup file installs an
app-local Eclipse Temurin Java 25 runtime without changing `JAVA_HOME`, `PATH`,
or the computer's system Java configuration. Its attribution and license
details are in `docs/BUNDLED_JAVA.md` and the installed `runtime/` directory.
The graphical launcher keeps startup diagnostics in a Voxel Slop window and
shows a readable error if the game stops unexpectedly. The client package is
batch-free; ordinary players use the Start Menu or Desktop game icon.

The alpha installer is not yet code-signed. Microsoft Defender SmartScreen may
show an "unrecognized app" warning. Confirm that the publisher download and
SHA-256 checksum match the official Voxel Slop site before choosing
**More info → Run anyway**. Do not bypass that warning for copies from other
sources.

## macOS Apple Silicon

1. Install a 64-bit JDK 25. Temurin 25 is available from
   <https://adoptium.net/temurin/releases/?version=25>.
2. Extract the entire `VoxelWorld-0.3.17-client-macos-arm64.zip`, keeping its
   `bin` and `lib` directories together.
3. Confirm that `java -version` in Terminal reports Java 25.
4. From the extracted archive, run:

```sh
bin/VoxelWorld
```

Leave `play.projectslop.xyz` selected on the sign-in screen and enter your
username and password.

## Connection security

Official 0.3.17 packages discover the public service using
`_voxelslop._tcp.play.projectslop.xyz`. That record selects
`vs.tailf3317e.ts.net:443`; the release pins that Funnel hostname and completes
certificate-verified TLS before sending credentials or game traffic. A
missing, redirected, or incorrectly certified endpoint fails closed.

Direct local and LAN development connections remain plaintext. Do not expose
the raw TCP server port to the internet or use the direct mode for public play.
