How To Create Your Own Eagercraft Server

April 14, 2025
18 min read
RigBot
188 views
How To Create Your Own Eagercraft Server

What is Eaglercraft?

Before diving into server setup, let's clear up what Eaglercraft actually is. Eaglercraft is a JavaScript adaptation of Minecraft that runs directly in your browser. It's based on Minecraft 1.8.8, 1.12.2, and was developed by lax1dude. The beauty of Eaglercraft is that it doesn't require any downloads or installations - you can play Minecraft right from your web browser!

Why Create Your Own Eaglercraft Server?

Maybe you want to play with friends at school where game downloads are blocked. Perhaps you're looking for a way to enjoy Minecraft without installing anything. Whatever your reason, running your own Eaglercraft server gives you control over your gameplay environment.

What You'll Need

  1. A computer (even a Chromebook will work for the hosted method)
  2. Internet connection
  3. Basic understanding of copying and pasting (seriously, that's about it!)
  4. About 15-20 minutes of your time

Method 1: Using a Hosting Provider (Easiest)

This is the simplest approach and perfect for beginners or those who don't want to mess with technical details.

Step 1: Set Up Your Minecraft Server

  1. Go to a free hosting provider like Aternos or Magmanode.
  2. Create an account and set up a new Minecraft 1.8.8 server.
  3. For server software, you can choose any type (Spigot, Paper, Vanilla) depending on what plugins you might want to add later.
  4. Important: Turn off "Online Mode" in your server settings. This is crucial for Eaglercraft to work!

Note down your server's IP address and port number - you'll need these later.

Step 2: Set Up the WebSocket Proxy

  1. Visit Replit and create an account if you don't have one already.
  2. Fork the EaglercraftX Bungee template by going to: https://replit.com/@adsservers/bungee
  3. Once forked, you'll see the project files. Look for the "plugins" folder.
  4. Remove the "EaglercraftXBungee.jar" file from the plugins folder (but don't delete the folder itself or the memory leak fix).
  5. Redownload the latest EaglercraftXBungee.jar (version 1.0.6) and add it to the plugins folder.
  6. Open the "config.yml" file and find the server section at the bottom.
  7. Replace the default IP and port with your Minecraft server's IP and port from Step 1.

Step 3: Final Configuration and Launch

(Optional) Want to customize your server? You can:

  1. Change the MOTD (message of the day) in the "listeners.yml" file found in "plugins/EaglercraftXBungee"
  2. Upload a custom server icon
  3. Add plugins to your Minecraft server through your hosting provider
  4. Start your Minecraft server through your hosting provider.
  5. Run your Replit project by clicking the "Run" button.
  6. Your server address will be: wss://[repl-name].[your-username].repl.co

That's it! You can now connect to your server through any Eaglercraft client by entering that address.

Method 2: Self-Hosting (More Advanced)

If you want more control or don't want to rely on Replit (which has limits on its free tier), self-hosting is the way to go. This method is a bit more complex but gives you full control.

Requirements:

  • A computer you can leave running (or a VPS/dedicated server)
  • Basic knowledge of port forwarding
  • Java installed on your computer

Step 1: Set Up Your Minecraft Server

  1. Follow the same process as Method 1, Step 1.

Step 2: Set Up the WebSocket Proxy Locally

  1. Download the latest EaglercraftXBungee
  2. package from the official GitHub repository.
  3. Extract the files to a folder on your computer.
  4. Configure the "config.yml" file to point to your Minecraft server.
  5. Make sure to set the correct port in the "listeners.yml" file.

Step 3: Handle Port Forwarding

For others to connect to your server, you'll need to make it accessible from the internet:

  • Port Forwarding Method: Configure your router to forward the WebSocket port (usually 8081) to your computer.
  • Using Tunneling Services: If port forwarding is difficult (common in dorms or apartments), you can use services like: Cloudflare Tunnels

Your server will be accessible via the URL provided by the tunneling service. Remember to replace "https://" with "wss://" in the address when connecting through an Eaglercraft client.

Common Issues and Solutions

"Connection Refused" Error

  • Check if both your Minecraft server and WebSocket proxy are running
  • Verify your port forwarding settings
  • Make sure "Online Mode" is turned OFF in server settings

"Could not bind to host" Error

  • The port you're trying to use is already in use
  • Try changing the port in your configuration

"404 Not Found" Error

  • This usually means your WebSocket address is incorrect
  • If using Replit, make sure to use the format: wss://[repl-name].[your-username].repl.co
  • Try copying the URL from the error (the https:// one) and replacing https:// with wss://

"Online mode is set to false" Warning

  • This is actually normal and expected! EaglercraftX requires online mode to be off

Advanced Customization

Want to take your server to the next level? Here are some ideas:

  • Add Plugins: Most Bukkit/Spigot plugins for Minecraft 1.8.8 will work with EaglercraftX
  • Custom Login System: Use plugins like AuthMe to add password protection
  • Minigames: Set up different minigames on your server
  • Multiple Servers: Connect multiple Minecraft servers to one BungeeCord proxy for a network experience

Final Thoughts

Creating your own EaglercraftX server isn't as tough as it might seem at first. The hosted method using Replit is perfect for beginners or classroom settings, while self-hosting offers more flexibility for those with a bit more technical knowledge.

RigBot
Administrator

Share this article