Mainbrows Online

Mainbrows Online brings real browser displays to Minecraft. You can open and view websites directly inside your Minecraft world and watch them together with other players.

Status: Mainbrows Online is currently in alpha. Bugs, changes, and limitations may still occur.

---

What is Mainbrows Online?

Mainbrows Online is a browser display project for Minecraft 1.21.11 with Java 21.

It allows you to create display surfaces in the world that work like a real browser.

In singleplayer, the browser runs locally through the Fabric mod. On servers, the Paper plugin renders the website centrally and sends video and audio to players using the Fabric mod.

---

Project Parts

Part	Description
Fabric mod	Local displays in singleplayer and client support for server displays
Paper plugin	Shared server displays, permissions, sessions, and browser controls
Sidecar	Invisibly managed Chromium worker
Protocol	Shared message formats between the mod and plugin

Chrome, Node, and FFmpeg do not need to be installed manually. The required runtimes are downloaded and checked automatically on the first start.

---

Features

Browser Display

• Browser displays directly inside Minecraft

• Singleplayer displays through Fabric

• Shared server displays through Paper

• Open websites by URL

• Browser bar with:

  • Back
  • Forward
  • Reload
  • URL field
  • Ping display
  • Buffer status

Quality and Performance

• Adjustable display quality

• Adjustable FPS:

  • 15 FPS
  • 30 FPS
  • 60 FPS

• Configurable viewer range

• Buffer system for smoother playback

• H.264 / Opus support

• JPEG / PCM fallback support

Audio

• Audio streaming

• Volume control

• Audio device selection

• Audio modes:

  • Mono
  • Stereo
  • Off

Server Features

• Permission system
• Session system
• Owner, controller, and control request system
• Website blacklist for blocked domains
• Automatic runtime installation
• Checksum verification for downloaded runtimes

---

Requirements

Client

• Minecraft 1.21.11
• Java 21
• Fabric Loader 0.19.3 or newer
• Fabric API
• Mainbrows Online Fabric mod

Server Displays

For shared server displays, the server owner also needs:

• Paper server for Minecraft 1.21.11
• Mainbrows Online Paper plugin
• Mainbrows Online Fabric mod installed on every client

First Start

Internet access is required on the first browser start to download the required runtimes.

---

Getting Started

1. Install the mod

Install:

• Fabric Loader
• Fabric API
• Mainbrows Online Fabric mod

2. Start Minecraft

Start Minecraft with the Fabric profile.

3. Create a display

Use these commands:

/display wand
/display create <Name>

4. Open a website

/display open <http(s)://URL>

5. Shared server displays

For shared displays, the server owner must also install the Paper plugin.

---

Important Commands

Command	Description
/display wand	Gives you the display selection tool
/display create <Name>	Creates a new display
/display connect <Code>	Connects to a server display
/display open <http(s)://URL>	Opens a website
/display quality <360p|HD|FullHD|WidthxHeight>	Changes display quality
/display fps <15|30|60>	Changes display FPS
/display range <2-128>	Changes viewer range
/display buffer <on seconds|off>	Enables or disables buffering
/display keyboard	Opens keyboard input
/display browserstatus	Shows browser status
/display runtime retry	Retries runtime installation
/display session clear	Clears the current session

---

Videos

Video 1: Creating a display and opening a website

(Only in German, but I will make an English version too.)

Example: A short clip showing how a display is created and a website is opened.

(Coming soon)

Video 2: Server display with multiple players

(Coming soon)

Example: A short clip showing multiple players viewing and using the same display together.

---

Images

Singleplayer Display

Website Display

Audio Settings

---

Security and Privacy

All viewers of a server display see the same browser content and hear the same audio.

Because of this, you should not open the following on public server displays:

• Personal accounts
• Private messages
• Passwords
• Admin panels
• Sensitive data
• Private websites

For security reasons, these features are disabled in the shared server browser:

• Downloads
• File uploads
• Camera access
• Microphone access

Server admins can block websites through this file:

plugins/Mainbrows/blocked-websites.json

In local singleplayer mode, browser data does not leave your own computer.

---

Limitations

Mainbrows Online is still alpha software. Some websites or systems may work better than others.

The following features are currently best effort:

• DRM / Widevine
• Captchas
• WebGL websites
• Very high resolutions
• Multiple displays at the same time
• 60 FPS on weaker systems

These features may require more CPU, RAM, and bandwidth:

• High resolution
• 60 FPS
• Multiple displays
• Fallback codecs
• Audio streaming

---

Help and Bug Reports

When reporting bugs, please include:

• Mainbrows Online version
• Minecraft version
• Whether Fabric, Paper, or both are being used
• A short description of what happened
• The last steps before the issue occurred
• logs/latest.log

Before sending logs or screenshots, please remove:

• Login data
• Tokens
• Private browser content
• Personal information

---

License

Mainbrows Online is licensed as:

All rights reserved.