Feature: Exclusive (Whitelisted) Server for Eaglercraft 1.12.2
Goal
Create an exclusive, whitelisted Eaglercraft 1.12.2 server so only invited players can join.
Method B: ngrok Tunnel (Easier, Encrypted)
Ngrok creates a secure tunnel without opening router ports. Perfect for exclusive sessions.
The Translator: A proxy (BungeeCord or Velocity) equipped with the Eaglercraft plugin.
- Download ngrok from ngrok.com.
- Sign up for a free account to get your auth token.
- In terminal, run:
ngrok tcp 8081 - You’ll see something like:
Forwarding: tcp://0.tcp.ngrok.io:12345 -> localhost:8081 - Tell your friends:
ws://0.tcp.ngrok.io:12345
Run the jar file once using Java 11 or higher to generate folders. Configure for Cracked Mode server.properties online-mode=false . This is mandatory for Eaglercraft connections. Install the Eaglercraft Proxy Waterfall proxy (a version of BungeeCord). Download and place the EaglerXBungee plugin into the proxy's Configure the proxy's config.yml to point to your Paper server's IP and port. Enable External Access If hosting locally, you must port forward (usually port ) or use a tool like Cloudflare Tunnels to provide a link for players. Essential Plugins for 1.12.2
- Clients fail to connect: Check WebSocket endpoint, TLS configuration, and firewall rules.
- Valid users rejected: Verify the server checks the same identifiers (username vs. UUID) as your whitelist/gateway maps.
- Tokens not recognized: Ensure the client includes the session token in the WebSocket handshake headers or query string as your server expects.
- Multiple users from same IP: If relying on IP-based allowances, recognize that shared NAT may block legitimate players; switch to token/session validation.
