ServerEasyWeb

Minecraft 版本： 1.8 1.8.1 1.8.2 1.8.3 1.8.4 1.8.5 1.8.6 1.8.7 1.8.8 1.8.9 1.9 1.9.1 1.9.2 1.9.3 1.9.4 1.10 1.10.1 1.10.2 1.11 1.11.1 1.11.2 1.12 1.12.1 1.12.2 1.13 1.13.1 1.13.2 1.14 1.14.1 1.14.2 1.14.3 1.14.4 1.15 1.15.1 1.15.2 1.16 1.16.1 1.16.2 1.16.3 1.16.4 1.16.5 1.17 1.17.1 1.18 1.18.1 1.18.2 1.19 1.19.1 1.19.2 1.19.3 1.19.4 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2

平台： bukkit paper purpur spigot

标签： utility

ServerEasyWeb

A lightweight Minecraft plugin that serves customizable web pages from a local folder, allowing server owners to create a custom web interface for their Minecraft server. Built for compatibility with Minecraft 1.8–26.1 and Java 8–25, it uses Jetty to serve static files (HTML, CSS, JS) from plugins/ServerEasyWeb/web/.

Features

• Customizable Web Interface: Serve static web files (HTML, CSS, JS) from the plugins/ServerEasyWeb/web/ folder.
• Modern Default Design: Includes a responsive default page with Tailwind CSS and basic JavaScript interactivity.
• Reload Command: Use /servereasyweb reload to reload the configuration and restart the web server.
• Lightweight and Compatible: Works with Minecraft 1.8–1.21 (Spigot/Paper) and avoids legacy material warnings in newer versions.
• No Log Spam: File-serving logs are suppressed to keep the server console clean.

Requirements

• Minecraft Server: Spigot or Paper, versions 1.8–26.1.
• Java: Version 8 or higher.
• Port Access: The configured web-port (default: 8080) must be open and not used by other applications.

Installation

1. Download:

   • Grab the latest ServerEasyWeb.jar.

2. Deploy:

   • Place the JAR in the plugins/ folder of your Minecraft server.
   • Delete any existing plugins/ServerEasyWeb/ folder to ensure fresh file extraction.

3. Start the Server:

   • Run your server to generate the plugins/ServerEasyWeb/ folder, including config.yml and the web/ folder with default files (index.html, styles.css, script.js).

4. Verify:

   • Check server logs for:

     [ServerEasyWeb] Loaded configuration: web-port=8080, check-updates=true
     [ServerEasyWeb] Extracted web file: .../plugins/ServerEasyWeb/web/index.html
     [ServerEasyWeb] Web server started on port 8080

   • Access http://<server-ip>:8080/ in a browser to see the default web page.

Configuration

The plugin uses plugins/ServerEasyWeb/config.yml for settings:

web-port: 8080
check-updates: true

• web-port: The port for the web server (default: 8080). Ensure it’s open and not in use.
• check-updates: Enable (true) or disable (false) checking for plugin updates on GitHub.

To apply changes, edit config.yml and run /servereasyweb reload.

Customization

Customize the web interface by editing files in plugins/ServerEasyWeb/web/:

• index.html: The default page, styled with Tailwind CSS (via CDN) and linked to styles.css and script.js.
• styles.css: Additional CSS to complement Tailwind.
• script.js: JavaScript for interactivity (e.g., button click events).
• Additional Files: Add images, extra HTML pages, or other assets to the web/ folder. They will be served automatically (e.g., http://<server-ip>:8080/image.png).

After editing files, refresh the browser to see changes. Use /servereasyweb reload to re-extract default files if needed.

Commands

• /servereasyweb reload:
  • Reloads config.yml, re-extracts web files, and restarts the web server.
  • Permission: servereasyweb.admin (default: operators only).
  • Tab completion: Type /servereasyweb and press Tab to see reload.

Example:

/servereasyweb reload

Permissions

• servereasyweb.admin:
  • Allows use of /servereasyweb reload.
  • Default: Operators (op).

Debugging

If issues occur:

• Web Page Not Loading:
  • Check logs for errors like “Failed to start web server.” or “File not found.”
  • Verify plugins/ServerEasyWeb/web/index.html exists.
  • Ensure the web-port (default: 8080) is open (netstat -tuln | grep 8080 on Linux).
  • Check file permissions (chmod -R u+rw plugins/ServerEasyWeb on Linux).

License

MIT License. See LICENSE for details.