tiny server

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:

```yaml 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: ```makefile X-API-Key: tiny_XXXXXXXXXXXX ``` (where tiny_XXXXXXXXXXXX is your generated key from the file)

---

⚙️ Example `config.yml`

```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!