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. ## Linux and AMP Support - 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 and Setup Reporting - 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. ## Networking and Port Handling - 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. ## Browser Sessions and Streaming - 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. ## Navigation and Browser Controls - 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. ## Security and Administration - 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. ## Media Compatibility - 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. ## Known Limitations - 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. ## Compatibility - 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

Mainbrows Fabric 0.6.0-alpha Changelog Release date: July 31, 2026 ## Controls - Corrected browser scrolling so that it now follows the mouse wheel direction. - Leaving browser control mode now requires holding `ESC` for two seconds. - While `ESC` is held, the action bar displays the remaining time before browser control mode is closed. - A short `ESC` press is still forwarded to the website, for example to exit a fullscreen video. - Right-clicking a display now connects the player to its local browser session in single-player worlds. - A clear chat message confirms when the player connects to a display. ## Browser Toolbar - The toolbar height now adapts to the display size and aspect ratio. - Small displays no longer receive an unnecessarily one-block-high toolbar. - Back, forward, and reload buttons scale together with the toolbar. - Fixed the broken reload button. - The displayed URL now updates automatically after navigation within a website. - Periodic URL synchronization corrects the toolbar if a navigation event is missed. - Minecraft latency, stream latency, and buffer status are displayed compactly in the toolbar. ## Audio - Completely redesigned the audio settings interface. - Each display has its own card with display selection, volume control, and audio mode. - Available audio modes: Stereo, Mono, and Off. - The playback device can be selected separately for each display. - The status indicates whether the selected display is connected and whether stream audio is being received. - Long display lists can be navigated using the mouse wheel or scrollbar. - During buffered playback, audio packets are queued ahead of time and continuously supplied to JavaSound instead of being submitted at the last moment. - Audio output now pauses correctly while playback is paused or the buffer is being rebuilt. ## Buffering and Playback - The client now calculates the actual remaining buffered media time from the playback timeline. - Short network interruptions consume only the corresponding amount of buffered time instead of triggering an underflow after a fixed 500 milliseconds. - Rebuffering begins only when playback actually reaches the safety margin. - Audio packets older than the agreed playback start position are discarded. - Buffered playback uses consistently timestamped JPEG and PCM packets, preventing irregular FFmpeg output chunks from causing brief stutters. - The buffer indicator and playback clock continue to update during playback. - Added three regression tests covering buffer consumption, the underflow threshold, and loading progress. ## Media Compatibility - Improved TikTok codec detection and media error diagnostics. - Added a temporary WebM fallback for TikTok media that cannot be played directly. - H.264/Opus and JPEG/PCM transport paths are selected according to the playback mode. ## Known Limitations - Widevine/DRM is not included in this release. DRM-protected services such as Crunchyroll may therefore still fail with errors such as `KAT-6005`. - TikTok may block the WebM fallback with a CDN `HTTP 403` response. Affected videos still cannot be played when this happens. - Enabling a playback buffer intentionally delays visible input responses and media playback by the configured buffer duration. ## Compatibility - Minecraft 1.21.11 - Java 21 or newer - Fabric Loader 0.19.3 or newer - Fabric API required - Paper servers require the matching Mainbrows Paper plugin.

### Erster Upload von Fabric Mod

### Erster Upload von dem Plugin