EmptyNetWeb

EmptyNetWeb

EmptyNetWeb is a lightweight Paper plugin that embeds a zero-dependency HTTP web server directly into your Minecraft server. When the server starts, the plugin automatically launches an HTTP listener that serves static website files from a dedicated directory inside the plugin's data folder.

This means you can host a website, landing page, API documentation, or any static content directly from your Minecraft server — no need for Apache, Nginx, or any external hosting service.

How It Works

The embedded web server uses com.sun.net.httpserver.HttpServer — a built-in JDK class that requires no external dependencies. It:

• Runs in its own cached thread pool
• Serves any file type (HTML, CSS, JS, images, fonts, etc.)
• Automatically detects MIME types based on file extensions
• Prevents directory traversal attacks by normalizing request paths
• Creates a default index.html if the web root is empty
• Supports clean shutdown with a 2-second grace period for in-flight requests

Installation

1. Download the EmptyNetWeb-1.0.0.jar from the releases page
2. Place the JAR file into your server's plugins/ folder
3. Restart your Paper server (or use /reload — though a restart is recommended)
4. The plugin will create the following structure automatically:

/plugins/EmptyNetWeb/
├── config.yml
└── web/
    └── index.html

5. Open your browser and navigate to http://your-server-ip:8080/

Configuration

The plugin's configuration file is located at /plugins/EmptyNetWeb/config.yml:

# The port the embedded web server will listen on.
# Default: 8080
port: 8080

# Whether to print a message in the server console
# when a client connects to the web server.
# Default: true
notify-on-connect: true

# Whether to log client connections to a file.
# Logs are stored in: /plugins/EmptyNetWeb/logs/
# Each entry includes the client's IP address and timestamp.
# Default: false
log-connections: false

Configuration Options

Serving Web Content

Place your static files in /plugins/EmptyNetWeb/web/. The directory structure is entirely up to you.

Example Structure

/plugins/EmptyNetWeb/web/
├── index.html
├── about.html
├── css/
│   └── style.css
├── js/
│   └── script.js
├── images/
│   ├── logo.png
│   └── background.jpg
└── fonts/
    └── custom-font.woff2

URL Mapping

Note: If a directory is requested (e.g., /css/), the server will look for an index.html inside that directory. If none exists, a 404 is returned.

Connection Logging

When log-connections: true is set in config.yml, the plugin records every HTTP request to /plugins/EmptyNetWeb/logs/connections.log.

Log Format

[2026-07-24 12:30:45] Connection from 192.168.1.100 - /index.html
[2026-07-24 12:31:02] Connection from 192.168.1.100 - /css/style.css
[2026-07-24 12:32:18] Connection from 10.0.0.5 - /images/logo.png

Each entry contains:

• Timestamp — Date and time of the request (server local time)
• Client IP — The IP address of the requesting client
• Requested Path — The URI path that was requested

Security

• Directory Traversal Protection: The server normalizes all request paths and rejects any that contain .. sequences, preventing clients from accessing files outside the web root.
• No External Dependencies: The web server uses only JDK built-in classes, reducing the attack surface.
• Configurable Port: You can change the port to avoid conflicts with other services.

Supported File Types

Support

For issues or reviews, go to the form