tiny server

Minecraft 版本： 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

平台： paper purpur spigot

标签： utility

Tiny Server

A lightweight Paper plugin that starts a built-in HTTP server directly from your Minecraft server. Perfect for custom dashboards, status pages, APIs, and simple resource hosting — all from inside your plugin folder!

Available on:

• Modrinth
  

• SpigotMC
  

? Features

• ? Built-in HTTP server with no external dependencies (no NGINX or Apache)

• ? Configurable IP and port via config.yml

• ? Serves static files from plugins/TinyServer/web/

• ? Supports default index.html and custom file paths

• ? Lightweight and easy to use — perfect for monitoring, mini dashboards, simple APIs, and more

• ? REST API protected by a unique secret key passed via HTTP header X-API-Key

• ? When API is enabled, the plugin generates a 12-character secret key (Latin letters and digits) with the prefix tiny_. The key is saved to a file named as per the secret config value

• ? API provides player online stats: current online and min/avg/max for 1, 6, 12, and 24 hours

? Quick Start

1. Install the plugin on your Paper server.

2. Edit plugins/TinyServer/config.yml to enable API and set parameters:

ip: 0.0.0.0
port: 25984
language: en

api:
  enabled: false
  secret: secret.tserv

3. If api.enabled: true, the plugin will generate a secret key file (e.g., plugins/TinyServer/secret.tserv) on first run.

4. Place your static files (like index.html) into plugins/TinyServer/web/.

5. Start your server — HTTP is available at http://your-server-ip:port.

6. To access the API, send requests to http://your-server-ip:port/api with header:

   X-API-Key: tiny_XXXXXXXXXXXX

   (where tiny_XXXXXXXXXXXX is your generated key from the file)

⚙️ Example config.yml

ip: 0.0.0.0
port: 25984
language: en

api:
  enabled: true
  secret: secret.tserv

? Use Cases

• Live server status and statistics display

• Hosting local resources (images, scripts, pages)

• imple API for external dashboards and apps

• Local web control panel for your server

? Plugin Commands

• /tinyserver reload — reload config and language files

• /tinyserver on — start the HTTP server

• /tinyserver off — stop the HTTP server

If you need help with setup or integration, feel free to ask!