0.6.0-alpha

Mainbrows Paper 0.6.0-alpha Changelog

Release date: July 31, 2026

Automatic Browser Runtime

The Paper plugin now prepares and owns its browser worker automatically. A separately installed Mainbrows sidecar is no longer required for the standard server setup.
Automatically downloads the configured Node.js runtime when it is not already available.
Installs the bundled worker dependencies, Playwright Chromium, and the matching FFmpeg package inside plugins/Mainbrows/runtime.
Verifies downloaded Node.js archives using their official SHA-256 checksums.
Prevents platform-specific node_modules files from being reused after moving a server between Windows, Linux, x64, and ARM64 systems.
Performs startup self-tests for Node.js, Chromium, and FFmpeg before reporting the runtime as ready.
Uses the full Playwright Chromium build and disables the Chromium sandbox for compatibility with managed game-server containers.
Added /display runtime retry to restart runtime preparation after correcting a configuration or container problem.

Added runtime detection for Linux x64 and Linux ARM64 servers.
On supported root-managed Debian/Ubuntu systems, the plugin can install required Chromium system libraries automatically through Playwright.
Detects AMP installations and avoids running an unavailable or blocked apt-get installation inside the AMP instance.
Detects whether the Paper process has root privileges before attempting system package installation.
Checks Chromium with ldd and reports the exact missing Linux libraries when possible.
Runtime failures now explain whether installation was prevented by AMP, missing root privileges, a missing apt-get, or disabled automatic dependency installation.
AMP error messages direct administrators to add the required Debian packages through the instance's Container Packages configuration and restart the instance.

Download progress is written to the server console once per second.
Direct downloads report transferred size, total size, percentage, and transfer speed.
Long-running npm and Playwright commands report their elapsed time and detected percentage when available.
Timeouts now include the last relevant process output instead of only displaying a generic timeout message.
Timed-out setup processes and their child processes are terminated cleanly.
Runtime status reports the active Node.js, Chromium, and FFmpeg state.

The privileged internal control API is restricted to 127.0.0.1.
The client-facing media stream uses WSS with a generated certificate and exact SHA-256 certificate pinning.
runtime.public-host: auto allows Fabric clients to use the Minecraft server address automatically.
Internal and stream ports are validated before the worker starts and may no longer use the same value.
Port conflicts now identify whether runtime.internal-port or runtime.stream-port is occupied.
Startup errors provide the relevant configuration key and distinguish an occupied port from a permission or firewall failure.
If startup fails after opening one listener, the already-open listener is closed cleanly instead of remaining active.
Health checks report success only after both the internal API and secure stream listener are ready.

Multiple viewers of one display share the same server-side Chromium session.
Added synchronized playback preparation and start messages for buffered viewers.
Late viewers can join an existing synchronized playback group.
A buffer underflow rebuilds only the affected viewer's buffer instead of interrupting every connected viewer.
Supports buffer durations from 1 to 30 seconds through /display buffer start [seconds] and /display buffer stop.
Image and audio playback use a shared presentation timeline.
Media packets include the display ID, worker generation, sequence number, presentation timestamp, and keyframe marker.
H.264/Opus streaming includes JPEG/PCM fallback packets for compatible Fabric clients.
The number of simultaneously active browser displays is configurable and defaults to four.

The worker broadcasts committed page navigations to connected Fabric clients.
Periodic synchronization checks the actual Playwright page URL and repairs a stale client toolbar URL.
Reload, history navigation, direct URL navigation, keyboard, pointer, and scroll commands are forwarded to the shared browser session.
Popup navigation is handled inside the existing display session when the destination is allowed.
Navigation failures and blocked targets now provide more useful server log entries.

Stream connections use scoped, signed, expiring access tokens.
Tampered and expired stream tokens are rejected.
Browser downloads are disabled and download attempts are cancelled.
Website blocking supports exact domains and wildcard subdomains.
The blocked website configuration can be reloaded without restarting the server.
Browser profiles remain separated by display ID.

Added browser audio capture and server-side PCM/Opus processing.
Added TikTok codec probing, detailed media error reporting, and a temporary WebM fallback path.
Improved Chromium launch diagnostics for missing libraries and container sandbox restrictions.

Widevine/DRM is not included. DRM-protected services such as Crunchyroll may still fail with errors such as KAT-6005.
TikTok may reject fallback media requests with CDN HTTP 403; affected videos cannot be converted when this occurs.
AMP does not allow the plugin to install system packages inside the running instance. Missing Chromium libraries must be configured under Container Packages, followed by an instance restart.
The initial runtime setup requires outbound internet access and sufficient storage for Node.js, npm dependencies, Chromium, and FFmpeg.
runtime.stream-port must be reachable by players and must not already be used by another process or an old manually started sidecar.

Paper 1.21.11
Java 21 or newer
Windows x64
Linux x64
Linux ARM64
Matching Mainbrows Fabric mod required for in-world browser rendering and interaction