JavalinMC

JavalinMC

Embed a full Javalin web server inside your Minecraft Paper server.

No external web server, no root access, no Docker. Just drop the plugin in, configure it, and start serving sites.

What Is JavalinMC

JavalinMC embeds a Javalin 7 web server (built on Jetty) inside a running Paper/Minecraft Bukkit plugin. It shares the same JVM as your game server and serves HTTP/HTTPS requests from inside the Minecraft process.

Key capabilities:

• Serve static websites (HTML, CSS, JS, images) from a Web/ folder
• Auto-generate self-signed SSL certificates
• Obtain real certificates from Let's Encrypt
• Clone and pull git repositories into the web root
• Load standard Javalin plugins at runtime
• Custom HTML error pages, CORS, compression, security headers
• Automatic HTTP-to-HTTPS redirect with HSTS
• IP allowlist / blacklist, maintenance mode, and reverse-proxy header trust
• Built-in rate limiting and config-driven API-key / Basic-auth protection
• Define static routes, redirects and reverse-proxy rules straight in config.yml
• Bukkit/Paper metrics endpoint (TPS, tick times, players, memory, worlds) with a permission gate
• WebSocket echo endpoint for testing proxies
• Graceful drain on stop with a /javalinmc forcestop escape hatch
• WebPermissions helper so other plugins can gate routes without hardcoding permission checks

Getting Started

To get started with JavalinMC, please refer to the official documentation and setup guide available on the wiki:

👉 https://codeberg.org/Vextoly/JavalinMC/wiki/Getting-Started