Eaglercraft Github

This page serves as a copy of the original Eaglercraft Github page for reference. Most links are broken since the Github was deleted by its author.

This repository will be deleted imminently

Create a fresh fork ASAP to preserve it, you MUST fork a 100% fresh copy in order for the repository to be considered genuine

Please read LAX1DUDE_SIGNATURE.txt for instructions to verify this is an original copy, if the file is not present then do not use this copy of the project

LAX1DUDE's PGP key is here: https://deev.is/certs/LAX1DUDE_eagler_public.asc

Do not edit this README, modifying any file will invalidate the repository's checksum

Download your worlds off of https://g.deev.is/eaglercraft/ and alts in case of a URL change for the demo client



Eaglercraft is real Minecraft 1.5.2 that you can play in any regular web browser. That includes school chromebooks, it works on all chromebooks. It supports both singleplayer and multiplayer.

Currently maintained by ayunami2000 For any questions you can join the discord server and hit us up there https://discord.gg/Ekzcgs3DKZ

Quick Start

Client: https://g.deev.is/eaglercraft/

Offline Client Download: Offline_Download_Version.html

(right click the link and press 'Save link as...' to download the file)

Play Minecraft Beta Singleplayer: https://g.deev.is/eaglercraft/beta/


Simply press the 'Singleplayer' button on the main menu and you can create a regular vanilla minecraft and play it any time.

Importing and Exporting Worlds

The worlds are stored in your browser's local storage, you can export them as EPK files and import them again on all other Eaglercraft sites that also support singleplayer. You can even copy an exported world to an entirely different computer, or send it to a friend, and import it and continue playing with all your progress saved.

Lan Worlds

Eaglercraft fully supports LAN worlds, you can share your world with any player and they can connect directly to it as if you are running a server in your browser.

LAN worlds will work between any two devices connected to the internet, you are not limited to only players connected to your Wi-Fi network.

To open your world to LAN, go to the pause menu and click 'Open to LAN'. You can configure the gamemode and cheats and if you would like to hide your LAN world. When you do not hide your LAN world, it will appear on the Multiplayer screen from the main menu to anybody else also on your Wi-Fi network. Set the world hidden if you are at school or something and don't want everyone else in your class to join as well and start griefing.

When you open the world to LAN it will give you a 'join code'. Simply share the code with your friends and they can visit the Multiplayer screen from the main menu and click 'Direct Connect' and enter the code and they will be able to join your world.

Make sure they add the relay server your game opens the LAN world on to their "Network Settings" menu accessable from the Multiplayer screen. You simply must send them the URL indicated in the pause menu once the world is opened and they can use the "Add Relay" option to add the URL to their list.


Public LAN Relays

Here are some public relay servers you can use:

  • wss://relay.deev.is/
  • wss://relay.lax1dude.net/
  • wss://relay.shhnowisnottheti.me/

Creating a LAN Relay

Simply download stable-download/sp-relay.jar and run java -jar sp-relay.jar

Run java -jar sp-relay.jar --debug to view debug info like all the IPs of incoming connections, as it is not shown by default because logging all that info will reduce performance when the relay is being pinged many times a second depending on it's popularity.

Edit the relayConfig.ini file generated on first launch to change the port and configure ratelimiting and such, and relays.txt to change the list of STUN and TURN relays reported to clients connecting to the relay, which are required to correctly establish a P2P LAN world connection in browsers.


Multiplayer functions like vanilla Minecraft, allowing you to join normal Minecraft servers like a normal client.

Public Clients and Servers

There are multiple official clients hosted by lax1dude, here is a small list:

  • Main: https://g.deev.is/
  • https://eaglercraft.net/
  • https://eaglercraft.org/
  • https://eaglercraft.me/
  • https://g.lax1dude.net/eaglercraft/

There are also multiple community hosted servers, the best way to discover those is to use the official clients.

Alternatively, there is a server list to find servers.

Creating Your Own Server

There are multiple parts to a server, mainly consisting of a regular 1.5.2 Bukkit server, and a modified version of Bungeecord called EaglercraftBungee, which on top of the regular Bungeecord functionality, it translates WebSocket connections to raw TCP connections which Bukkit can understand.

You may also want to set up your own client, allowing you to control default server listings, resource packs, and an overall faster connection due to less load.

If you want to use a domain for your server, a reverse proxy can be set up to enable extra functionality within EaglercraftBungee. NGINX is recommended, and a tutorial is included here. This is optional, and can be skipped by just connecting with the IP.

Creating a Server - Bukkit

  1. Check if Java is installed. You can download it from https://www.java.com/en/download/
  2. Download the stable-download/stable-download.zip file from this repository
  3. Extract the ZIP file you downloaded to a new folder
  4. Open the new folder, go into the java/bukkit_command folder
  5. In Windows, double-click run.bat. It should open a new terminal window run.bat
    Some computers may just say 'run' instead of 'run.bat', both are correct
  6. On macOS or Linux, google how to open the terminal and use the cd command to navigate to java/bukkit_command
    Then, in that folder, run chmod +x run_unix.sh and then run ./run_unix.sh. It should start the same server
  7. To add some bukkit plugins, download the plugin's JAR file for CraftBukkit 1.5.2 and place it in java/bukkit_command/plugins (See https://github.com/lax1dude/eaglercraft-plugins/ to download some supported plugins)

Creating a server - EaglercraftBungee

  1. In the same new folder, go into the java/bungee_command folder.
  2. In Windows, double-click run.bat. It should open a second terminal window.
    Keep both the first and second terminal window you opened, just minimize them, don't close
  3. On macOS or Linux, repeat step 7 in Creating a Server - Bukkit, but navigate to java/bungee_command this time
  4. To add some bungee plugins, download the plugin's JAR file and place it in java/bungee_command/plugins

There are alot more configurations in bungeecord, but this should set you up.

Your server is now ready. Visit any client, and go to 'Multiplayer' from the main menu. Select 'Direct Connect', type and press 'Join Server'. It should allow you to connect, if not, check the two terminal windows for errors.

Creating a Client

  1. To install, upload the contents of stable-download/web to a web server.

    There are multiple ways of setting up a web server. NGINX is a powerful web server, but alternatives like Web Server for Chrome may be easier to set up.

    A quick crash course on setting up NGINX is provided here, FOLLOW STEPS 1 AND 2 ONLY, then navigate to /var/www/html and upload the contents of stable-download/web there.

    If you had installed NGINX earlier as a reverse proxy, you can also use it to host the client, follow the steps above ^^^

    Make sure that the URL to connect to the client and the server are separate, preferably with a path, like

  2. The 'web' folder will not work if you open it in your browser locally! If you see 'file:///' in the URL you are doing it wrong. You need to upload the folder to an HTTP or HTTPS server and access it over the internet via http:// or https://. The game will not load otherwise, this is not a bug.
  3. To modify the list of default servers, modify the window.eaglercraftOpts variable in index.html.
  4. A full guide on how to configure eaglercraftOpts is coming soon, but it should be fairly intuitive to figure out how to set it up based on what the default values already are when you look in stable-download.
  5. To create a link to your site that automatically joins the server, add a ?server= variable to the URL, like (for example): https://g.deev.is/eaglercraft/?server= will automatically join ws:// as soon as the player finishes setting their username and skin.

EaglercraftBungee Configuration