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.

Bukkit 1.5.2 is the game logic backend of an Eaglercraft server. It handles world data, player state, and all plugin execution — exactly like a standard Minecraft 1.5.2 server. EaglercraftBungee proxies WebSocket connections from browser clients to this process, so you need both running at the same time. See the server architecture overview if you haven’t already.

​
Prerequisites

​
Installation

1

Download the stable-download package

Download stable-download.zip from the Eaglercraft repository:
https://github.com/lax1dude/eaglercraft/raw/main/stable-download/stable-download.zip
2

Extract the ZIP to a new folder

Extract the contents of stable-download.zip to a dedicated folder on your machine. All server files live inside this extracted directory.
3

Navigate to java/bukkit_command/

Open the extracted folder and go into the java/bukkit_command/ subdirectory. This is the Bukkit server root — it contains the startup scripts, server JAR, and the plugins/ directory.
4

Launch the Bukkit server

Start Bukkit using the appropriate script for your operating system:
run.bat
A terminal window will open showing the server startup log. Wait until you see a line like Done! For help, type "help" before starting EaglercraftBungee. On some Windows systems the file may appear as just run rather than run.bat — both are the same script.

​
Adding Plugins

Place JAR files built for CraftBukkit 1.5.2 into the java/bukkit_command/plugins/ directory. The server loads them automatically on the next restart. For a curated list of plugins that are known to work with Eaglercraft’s Bukkit backend, visit:
https://github.com/lax1dude/eaglercraft-plugins/

​
Op Security

Bukkit’s /op command is case-insensitive. Running /op LAX1DUDE grants operator privileges to any player whose username matches in any combination of upper and lower case — laX1DUDE, LaX1dUdE, lax1dude, and so on will all receive op. A griefer can exploit this in minutes to take over your server.To prevent privilege escalation:
  1. Move BitchFilterPlugin.jar from the java/bukkit_server/ folder into java/bukkit_command/plugins/.
  2. Always grant op using all-lowercase usernames: /op lax1dude not /op LAX1DUDE.
  3. When joining as an op, your in-game username must also be all lowercase — the plugin will kick you otherwise.
Alternatively, avoid /op entirely and use a dedicated permissions plugin instead.

​
Default Ports

Bukkit listens on port 25569 on localhost. This port is defined as the upstream address in EaglercraftBungee’s config.yml:
config.yml (servers block)
servers:
  lobby:
    address: localhost:25569
    restricted: false
Bukkit should not be exposed directly to the internet — all player traffic reaches it through EaglercraftBungee. Once Bukkit is running, proceed to EaglercraftBungee Setup to start the proxy.

Build docs developers (and LLMs) love

Get started for freeTalk to us