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.

There are three ways to get into Eaglercraft: open a public hosted client in your browser right now, download a single offline HTML file for play without any server, or spin up your own full server stack locally. Choose the path that fits your situation — you can always move to the next tier later.

​
Play Instantly

The fastest way to play is to visit the official hosted client: https://g.deev.is/eaglercraft/ Open the link, set your username and skin, then press Singleplayer to create a new world or Multiplayer to browse the pre-loaded public server list. No download, no account, no installation needed.
Your singleplayer worlds are saved to browser local storage for the domain g.deev.is. They persist across browser restarts but are tied to that origin. Use Export World in the pause menu to save an .epk backup you can re-import on any Eaglercraft client.

​
Offline Client

If you need to play without reliable internet access, or want a copy that cannot disappear if the hosting domain changes, download the self-contained offline file: Download Offline_Download_Version.html
Right-click the link above and choose “Save link as…” — do not left-click it, as that will open the raw HTML in your browser tab rather than downloading it to disk.
Once saved, open the file directly in your browser. The entire game — engine, assets, and singleplayer runtime — is bundled inside that single HTML file.
The offline client works for singleplayer only when opened from the filesystem (file:///). To connect to a multiplayer server you must serve the client over HTTP or HTTPS. Some server operators also block offline-client connections via the origin_blacklist_block_offline_download setting in EaglercraftBungee.

​
Run a Local Server

Running your own server gives you full control over gameplay, plugins, and who can connect. The stable-download.zip bundle includes both the Bukkit backend and the EaglercraftBungee proxy pre-configured to work together.
Want to skip local setup entirely? Use the community-maintained Replit template to launch a server in the cloud in seconds: https://replit.com/@ayunami2000/eaglercraft-server
1

Verify Java is installed

EaglercraftBungee and Bukkit are both Java applications. Open a terminal and run:
java -version
If Java is not found, download and install it from https://www.java.com/en/download/ before continuing.
2

Download the stable-download bundle

Download the pre-packaged ZIP that contains both server components:stable-download.zipSave it somewhere easy to find, such as your Desktop or a dedicated eaglercraft-server folder.
3

Start the Bukkit backend

Extract the ZIP to a new folder, then navigate into java/bukkit_command/ and start the Bukkit server:
REM Double-click run.bat, or from a Command Prompt:
cd java\bukkit_command
run.bat
A terminal window will open. Wait until you see the Done! message — Bukkit is ready when it prints that line. Leave this window open.
By default Bukkit listens on localhost:25569. EaglercraftBungee is pre-configured to connect to that address, so no changes are needed for a local test setup.
4

Start EaglercraftBungee

In a second terminal, navigate into java/bungee_command/ and start the proxy:
REM Double-click run.bat, or from a Command Prompt:
cd java\bungee_command
run.bat
EaglercraftBungee will start and bind its WebSocket listener on 0.0.0.0:25565. Keep both terminal windows open — closing either one will stop that component.
EaglercraftBungee is not vanilla BungeeCord. It is a custom fork that adds WebSocket support. Players connecting with a standard Minecraft client (not Eaglercraft) will not be able to join through this proxy.
5

Connect and play

Open any Eaglercraft client (the hosted client, the offline HTML file, or a locally served copy), then:
  1. On the main menu, click Multiplayer.
  2. Click Direct Connect.
  3. Enter the address: 127.0.0.1:25565
  4. Click Join Server.
You should connect immediately. If not, check both terminal windows for error messages — common issues are Java not having permission to bind the port, or Bukkit still starting up when BungeeCord tries to connect.

​
Next Steps

Once your server is running you may want to:
  • Add Bukkit plugins — place CraftBukkit 1.5.2 .jar files in java/bukkit_command/plugins/. Community-maintained plugins compatible with Eaglercraft are listed at https://github.com/lax1dude/eaglercraft-plugins/.
  • Customise your server listing — edit the motd1: field in java/bungee_command/config.yml and replace server-icon.png to set your server name and icon.
  • Host your own web client — upload the contents of stable-download/web/ to any HTTP/HTTPS server and edit index.html to set your default server address in eaglercraftOpts.
  • Enable LAN worlds — the three public relay servers (wss://relay.deev.is/, wss://relay.lax1dude.net/, wss://relay.shhnowisnottheti.me/) are pre-configured in the official client and work without any additional setup.

Build docs developers (and LLMs) love

Get started for freeTalk to us