Currently maintained by ayunami2000
online-mode=false
in their server.properties to allow free login but now that’s their legal screw up instead of mine(right click the link and press ‘Save link as…’ to download the file)
For any questions you can join the discord server and hit us up there https://discord.gg/Ekzcgs3DKZ
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.
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.
Link: https://g.deev.is/eaglercraft/
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.
wss://relay.deev.is/
wss://relay.lax1dude.net/
wss://relay.shhnowisnottheti.me/
I got tired of closing duplicate ‘how to maek sever’ issues almost every day so I disabled it because honestly I don’t really care anymore, join discord if you’ve got an issue to report that you are confident can be backed up with source code
java/bungee_command
folderrun.bat
. It should open a new terminal windowcd
command to navigate to java/bungee_command
chmod +x run_unix.sh
and then run ./run_unix.sh
. It should start the same serverjava/bukkit_command
folder that was also extracted from the ZIPrun.bat
in the folder. It should open a second terminal window.java/bukkit_command
folder127.0.0.1:25565
and press ‘Join Server’stable-download/web
folderstable-download/web
to the URL you want to have Eaglercraft onwindow.eaglercraftOpts
variable in index.html
.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?server=
variable to the URL, like (for example): https://g.deev.is/eaglercraft/?server=127.0.0.1:25565 will automatically join ws://127.0.0.1:25565/
as soon as the player finishes setting their username and skinmotd1:
tag of the listener config in java/bungee_command/config.yml
, and replace server-icon.png
in the folder where the config file is. Use &
to add color/formatting codes. The server list will downscale your icon to 64x64 pixelsmotd2:
to define a second linejava/bukkit_command/plugins
java/bungee_command/plugins
voice_enabled: false
in the bungeecord config.yml/login
and /register
, install AuthMe and carefully read it’s documentation to set it up correctlyeag-ban <username>
eag-ban-ip <ip>
, or eag-ban-ip <name>
to ban the IP of a player automaticallyeag-ban-ip 192.168.0.0/8
eag-ban-wildcard <text>*
or eag-ban-wildcard *<text>
or eag-ban-wildcard *<text>*
eag-ban-regex <regex>
with a regular expression to match the username in lowercasews://
or wss://
URL instead of ip:port
, set up nginx as a reverse proxy to the ip:port
of you EaglercraftBungee server you want the URL to connect to. Use a location URL template with the proxy_pass
directive.127.0.0.1
is the same as typing ws://127.0.0.1:80/
X-Real-IP
header on the request to websocket when it is proxiedrun.bat
. Wait for the window to say Press any key to continue...
and close it. Then, go to ../javascript
in the repository and copy javascript/assets.epk
to the assets.epk
on your websitecd
and run chmod +x run_unix.sh
and then ./run_unix.sh
to do this, then copy the same javascript/assets.epk
to the assets.epk
on your websiteEaglercraftBungee translates WebSockets to a raw Minecraft 1.5.2 TCP connection. It is just regular BungeeCord with more config.yml
options, and a built in plugin for syncing people’s custom skins between clients so people can see each other’s skins
voice_enabled: false
in config.ymlTo enable the /login and /register commands in EaglercraftBungee, you can edit this portion of config.yml
authservice:
enabled: false
register_enabled: true
authfile: auths.db
ip_limit: 0
join_messages:
- '&3Welcome to my &aEaglercraftBungee &3server!'
login_timeout: 30
enable
Turns login commands on and off
register_enabled
Turns register command on and off
authfile
Sets the authentication database file, which is compatible with AuthMe
ip_limit
Sets the max number of registrations per IP, 0 = unlimited
join_messages
List of messages to show the player when they join
login_timeout
Sets how many seconds players have to log in before they are kicked
EaglercraftBungee has a built in domain blacklist that updates automatically, you can disable it by setting this in config.yml:
enable_web_origin_blacklist: false
To block all clients on replit from joining, set this to true in config.yml:
origin_blacklist_block_replit_clients: true
To block all offline-download clients, set this to true in config.yml:
origin_blacklist_block_offline_download: true
To block the debug runtime (or other desktop clients), set this to true in config.yml:
origin_blacklist_block_missing_origin_header: true
To add your own blacklisted domains, create a file called origin_blacklist.txt
in your bungeecord directory and put the regular expressions inside, one on each line. There ‘s also a domain
command in the console to view a player’s domain, and a block-domain
and block-domain-name
and unblock-domain
command to manage the local origin_blacklist.txt
from the bungee console (if you don’t know how to edit a file on your own). The list reloads automatically when changes to the file are detected.
origin_blacklist_use_simple_whitelist: true
origin_blacklist_simple_whitelist
like this:origin_blacklist_simple_whitelist:
- type the name of your client's domain here
origin_blacklist_block_offline_download: true
add_header X-Frame-Options "SAMEORIGIN";
add_header Referrer-Policy "strict-origin";
add_header X-XSS-Protection "1; mode=block";
add_header Content-Security-Policy "default-src 'self' 'unsafe-inline'; img-src 'self' 'unsafe-inline' data: blob:; connect-src 'self' ws: wss:; upgrade-insecure-requests";
(not fully tested, excuse the scroll bar)
forward_ip
and pass a X-Real-IP header from your proxy to the bungeecord’s websocket portNginx example: add proxy_set_header X-Real-IP $remote_addr
to your proxy configuration
The server has built in DoS protection, reset it via typing ‘eag-ratelimit reset’ in the bungee console
ratelimit:
ip:
enable: true
period: 90
limit: 60
limit_lockout: 80
lockout_duration: 1200
exceptions: []
enable
enable rate limiting
period
and limit
set the number of requests (limit
) can be made in (period
) number of seconds
limit_lockout
and lockout_duration
set the number of requests (limit_lockout
) that can be made in (period
) seconds before the IP is blocked for lockout_duration
number of seconds
exceptions
a list of IP addresses that should never get rate limited. Local IPs like 127.0.0.1 and 192.168.*.* and such are set as exceptions by default
you need forward_ip
configured to use rate limiting, otherwise it will be disabled by default
If you would like to signal the client to disconnect from your bungeecord and reconnect to a different bungeecord, configure an entry in the servers
part of config.yml like this:
test:
redirect: wss://ServerHere/
restricted: false
In this example, sending a player to the server test
, such as when they enter a portal or type /server test
, will trigger their client to disconnect from your bungeecord and then automatically reconnect to wss://ServerHere/
as if it was entered via “Direct Connect”
To develop a plugin, download stable-download/java/bungee_command/bungee_dist.jar and add it to the Build Path of your Java IDE. Develop the plugin just like a regular BungeeCord plugin, see EaglerMOTD for an example.
Test your plugin by exporting it as a jar and putting it in the ‘/plugins’ directory of EaglercraftBungee and then clicking ‘run.bat’
net.md_5.bungee.api.event.WebsocketMOTDEvent: Triggered when a client or website requests the MOTD
net.md_5.bungee.api.event.WebsocketQueryEvent: Triggered when a client or website requests a query. This happens when a site opens a text WebSocket to a listener and sends a single string Accept: <query>
packet. Can be used to provide additional custom statistics to server list sites supporting integrated WebSocket queries
Register event handlers using the standard BungeeCord @EventHandler
annotation in your Listener
class
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
The origin-whitelist
config variable is a semicolon (;
) seperated list of domains used to restrict what sites are to be allowed to use your relay. When left blank it allows all sites. Add offline
to allow offline download clients to use your relay as well, and null
to allow connections that do not specify an Origin:
header. Use *
as a wildcard, for example: *.deev.is
allows all domains ending with “deev.is” to use the relay.
To compile for the web, run the gradle ‘teavm’ compile target to generate the classes.js file.
To complile to regular desktop Java for quick debugging, using native OpenGL for rendering instead of WebGL:
-Djava.library.path=natives
, and make sure the working directory for the run configuration is the lwjgl-rundir folder.To modify the game’s resource pack (javascript/assets.epk), view the readme in the /epkcompiler directory
All I really have to say is, tabs not spaces, and format the code to be like the eclipse auto format tool on factory settings, but also run-on lines of code long enough to go off the screen and single line if statements and other format violations in that category are welcome if it helps enhance the contrast between the less important code and the more important code in a file. Don’t commit changes to javascript/classes.js
or javascript/classes_server.js
or javascript/assets.epk
or anything in stable-download/
. I’ll recompile those myself when I merge the pull request.