http-commands

REST HTTP API

A powerful HTTP API plugin for Paper servers that lets you execute Minecraft commands remotely via REST API.

Overview

HTTP Commands bridges your Minecraft server with external tools, web dashboards, and automation scripts. Execute any server command instantly using simple HTTP requests - perfect for server management, integrations, and custom tools.

Features

🚀 Execute Commands Remotely

Send commands to your Minecraft server via HTTP POST requests. Build custom admin panels, Discord bots, or automation scripts that interact directly with your server.

📊 Server Information API

Access real-time server statistics:

• Current player count and max players
• Server version
• List of online players

⏳ Command Queuing

Queue commands to execute when specific players join - even if they're offline right now. Perfect for automated player management and onboarding flows.

🔒 Secure by Design

• Bearer token authentication protects all API endpoints
• HTTPS enforcement (configurable) for secure communications
• Input validation on all requests

🛠️ Easy Integration

Simple JSON-based API that works with any programming language or tool that can make HTTP requests - Python, Node.js, PHP, cURL, and more.

Use Cases

Web Dashboards

Build custom admin control panels that execute commands with a button click.

Discord Integration

Create Discord bots that run server commands when users use slash commands or buttons.

Automation Scripts

Automate routine tasks like backups, player management, or scheduled announcements.

External Tools

Connect third-party services or custom applications to your Minecraft server.

Delayed Command Execution

Queue commands to run automatically when players join for seamless onboarding experiences.

API Documentation

You can access the API documentation from here: https://minecraft-http-commands-plugin-api-doc.lenaic.me

Configuration

The plugin creates a simple config.yml file on first launch, you must change the bearer token before using it.

Security Recommendations

1. Change the default token - Use a strong, random string in production
2. Use HTTPS - Deploy behind a reverse proxy (Nginx, Caddy) with TLS/SSL
3. Firewall - Restrict access to trusted IP addresses when possible

Requirements

• Server Software: Paper 1.21+ (or compatible fork)
• Java Version: Java 21 or higher

Installation

1. Download the latest release from the page
2. Drop the JAR file into your server's plugins folder
3. Restart your server
4. Configure your bearer token in plugins/http-commands/config.yml

Commands

Permission: httpcommands.reload

Need Help?

• Check the GitHub repository for documentation
• Open an issue for bugs or feature requests

HTTP Commands - Bridge your Minecraft server with the web.