?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
tiny server

tiny server

Simple web server for minecraft

170
5
170
5

Compatibility

Minecraft: Java Edition

1.21โ€“1.21.8

Platforms

Links

Report issues View source
Donate

Tags

Creators

Details

Licensed MIT
Published last year

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:

๐Ÿ”ง 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

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

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

  3. Start your server โ€” HTTP is available at http://your-server-ip:port.

  4. 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!