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 | Command | Description | |---------|-------------| | `/http-commands reload` | Reload the plugin configuration | 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.*