Minecraft server administration has evolved far beyond simple command-line tweaks and in-game operator commands. As multiplayer communities grow, the need for remote monitoring, automation, and seamless integration with external tools becomes critical. Enter ServerTap, a powerful REST API plugin ...
Minecraft server administration has evolved far beyond simple command-line tweaks and in-game operator commands. As multiplayer communities grow, the need for remote monitoring, automation, and seamless integration with external tools becomes critical. Enter ServerTap, a powerful REST API plugin designed for Bukkit, Spigot, and PaperMC servers that transforms how you interact with your Minecraft world from outside the game client.
What Is ServerTap and Why Should You Care?
ServerTap is essentially a bridge between your Minecraft server and any application that speaks HTTP. By dropping a single JAR file into your server's plugins directory, you unlock the ability to query server stats, manage players, adjust whitelists, and even execute commands remotely using simple REST semantics. Whether you are building a custom web dashboard, automating administrative tasks, or integrating server data into a Discord bot, ServerTap provides the foundational API layer that makes it all possible.
The plugin self-hosts comprehensive API documentation through Swagger, accessible right from your server's address on port 4567. This means you can explore every available endpoint and even test requests directly from a clean user interface before writing a single line of code.
Core Features That Set ServerTap Apart
Comprehensive REST Endpoints
ServerTap exposes a wide array of endpoints covering nearly every aspect of server management. Here are some of the most practical capabilities you can leverage:
- Ping the server to check responsiveness and uptime
- Get, add, or remove operators without touching the console
- Manage the whitelist by viewing and adding players remotely
- List, save, and retrieve information about all worlds on the server
- Read and list scoreboard data for competitive gameplay tracking
- Broadcast messages to all online players
- Find players by name or UUID and retrieve detailed player statistics
- Interact with economy plugins to get balances, pay players, or handle debts
- List all installed plugins for inventory and compatibility checks
Real-Time Websocket Console
One of the standout features is the bi-directional websocket interface. Instead of polling the server repeatedly for log updates, you can open a persistent connection to receive server log lines in real time. Each message arrives as a structured JSON object containing the log text, timestamp, logger name, and severity level. The last 1000 log messages are buffered and sent immediately upon connection, ensuring you never miss critical context. You can even send commands back through the websocket, effectively creating a remote admin console that updates live.
Webhooks for Event-Driven Automation
ServerTap supports configurable webhooks that fire in response to specific server events. Define a listener URL and select from events like PlayerJoin, PlayerQuit, PlayerDeath, PlayerChat, and PlayerKick. When an event triggers, ServerTap sends a POST request with a clean JSON payload containing player details and event-specific information. This opens the door to automated welcome messages, logging player activity to external databases, or triggering custom scripts when certain players connect.
Security Considerations and TLS Support
Exposing server controls over a network demands robust security measures. ServerTap addresses this with built-in TLS support via Java keystore files. By generating a self-signed certificate using the keytool utility and configuring the plugin accordingly, you can encrypt all traffic between clients and your server. The plugin also supports Server Name Indication for advanced TLS setups, though most administrators can safely leave this option disabled.
For authentication, ServerTap offers a key-based system where you define a long random string in the configuration file. Every API request must then include a matching key header. Websocket connections, which cannot carry custom headers, authenticate through a cookie named x-servertap-key set on the hosting page. Without authentication enabled, you risk exposing an open remote console to the internet, which is strongly discouraged.
Installation and Getting Started
Setting up ServerTap is refreshingly straightforward. Download the latest plugin JAR and place it into your server's plugins/ServerTap directory. After a server restart or reload, the API becomes available on port 4567 by default. You can immediately test it using curl, Postman, or any HTTP client. For example, querying the server endpoint returns a wealth of information including the server name, MOTD, version, health metrics like CPU count and memory usage, and lists of banned players.
For those who prefer a streamlined setup experience, the foxygame.net launcher offers a convenient way to manage mods and plugins directly from its menu, making it a flexible and modern choice for Minecraft enthusiasts who want to keep their server tools organized without digging through file directories manually.
Configuring CORS and Webhooks
By default, ServerTap permits cross-origin requests from any origin, which is handy during development but may need tightening for production use. The corsOrigins setting accepts an array of allowed domains, giving you granular control over which web applications can communicate with your server. Webhooks are equally simple to configure: specify a listener URL and the events you want to monitor, and ServerTap handles the rest.
Why ServerTap Matters for Modern Minecraft Communities
The days of managing a Minecraft server solely through in-game commands are fading. ServerTap empowers administrators to build sophisticated external tools, integrate server data into websites, and automate repetitive tasks. Its combination of REST endpoints, real-time websockets, and event-driven webhooks creates a versatile platform that adapts to countless use cases. The self-hosted Swagger documentation lowers the barrier to entry, letting you explore the API interactively before committing to a development project.
Whether you are running a small private server for friends or a large public network with complex infrastructure, ServerTap provides the remote access layer that makes advanced management possible. The plugin's active community on Discord and open-source nature on GitHub ensure that it continues to evolve alongside the Minecraft server ecosystem. By adopting ServerTap, you are not just installing a plugin; you are unlocking a new dimension of control and creativity for your Minecraft world.