Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/lDEVinux/eaglercraft/llms.txt

Use this file to discover all available pages before exploring further.

Multiplayer in Eaglercraft works just like vanilla Minecraft — open the Multiplayer screen from the main menu, pick a server, and join. Under the hood, the Eaglercraft client communicates over WebSocket to EaglercraftBungee, a modified version of BungeeCord that translates WebSocket connections into the raw TCP connections that standard Bukkit 1.5.2 servers understand. This means Eaglercraft clients can connect to normal 1.5.2 Bukkit servers without any changes to the Bukkit side.
Have questions or want to find community servers? Join the Eaglercraft Discord: https://discord.gg/Ekzcgs3DKZ

​
Public Servers

The easiest way to discover and join servers is through one of the official Eaglercraft clients, which come pre-loaded with a built-in public server list: Simply open any of these clients, navigate to Multiplayer, and browse the servers already listed. Community-hosted servers are best discovered through the official client’s built-in server list.

​
Direct Connect

You can connect to any Eaglercraft-compatible server directly without it being in your server list:
  1. From the main menu, click Multiplayer.
  2. Click Direct Connect.
  3. Enter the server address in host:port format — for example, 127.0.0.1:25565.
  4. Click Join Server.

​
Auto-Join via URL

Eaglercraft supports an optional ?server= URL query parameter that automatically connects a player to the specified server as soon as they finish setting their username and skin. This is useful for sharing a direct link to your server with your community. Example: 
https://g.deev.is/eaglercraft/?server=127.0.0.1:25565
When a player visits this URL, the client reads the server parameter and sets joinServer in eaglercraftOpts accordingly:
index.html
var s = q.get("server");
if(s) window.eaglercraftOpts.joinServer = s;
The player will be taken through the usual username/skin setup screen and then dropped directly into the specified server — no need to navigate the server list.

​
Server Requirements

To host an Eaglercraft-compatible multiplayer server, you need:
  • A standard CraftBukkit 1.5.2 server (the game backend)
  • EaglercraftBungee (a modified BungeeCord) sitting in front of it — this is what translates WebSocket traffic from browser clients into TCP traffic for Bukkit
You cannot use vanilla BungeeCord. Only EaglercraftBungee understands the WebSocket-based protocol that browser clients use. The server address players connect to must be in host:port format and the connection is made over WebSocket (ws:// or wss://), not a plain TCP socket.
EaglercraftBungee supports the full range of standard Bukkit 1.5.2 plugins on the backend, so you can run the same plugins you would on any 1.5.2 CraftBukkit server.

Build docs developers (and LLMs) love

Get started for freeTalk to us