ModsJava
⚡ Taberna Connector ⭐ HTTP REST API for Remote Commands ✅ Secure | Paper 1.21+
⚡ Taberna Connector
Execute Minecraft commands remotely via HTTP API
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Sponsored by El-Taberna - Hosting
Premium Minecraft Server Hosting - Fast, Reliable, Affordable
Use code ELBRIGOS for a special discount!
Visit hosting.el-taberna.com to start your server today!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Plugin Statistics
Statistics powered by bStats
Overview
Taberna Connector is a lightweight and secure plugin that allows you to execute Minecraft server commands remotely through a REST API. Perfect for integrating your Minecraft server with external applications, web dashboards, Discord bots, or automation systems.
Use Cases:
- Create web-based admin panels
- Build Discord bots that control your server
- Automate server management tasks
- Integrate with payment systems for automated rewards
- Connect multiple applications to your Minecraft server
✨ Features
- Secure Authentication - API key-based security via HTTP headers
- ⚡ Async Processing - Non-blocking command execution optimized for Paper
- Debug Mode - Comprehensive logging for troubleshooting
- Execution Metrics - Track command execution time and success
- Simple Configuration - Easy setup with YAML config
- Live Reload - Reload configuration without restarting
- ️ Error Handling - Robust error catching and detailed logs
Installation
1. Download & Install
- Download the latest TabernaConnector.jar from the resource page
- Place the JAR file in your server's plugins/ folder
- Restart your server
2. Configure
After the first startup, edit plugins/TabernaConnector/config.yml:
Code (YAML):
# Taberna Connector Configuration
# The port the HTTP server will listen on
port : 8081
# The secret key required in the X-Connector-Key header
# CHANGE THIS TO A SECURE RANDOM STRING!
secret-key : "your-super-secret-key-here"
# Enable debug mode for verbose logging
debug : false
Run /taberna-connector reload to apply changes.
API Usage
Endpoint:
Code (Text):
POST http://your-server-ip:8081/execute
Code (Text):
Content-Type: application/json
X-Connector-Key: your-secret-key-here
Code (json (Unknown Language)):
{
"command": "say Hello World!"
}
Code (Bash):
curl -X POST http: //localhost: 8081 /execute \
-H "Content-Type: application/json" \
-H "X-Connector-Key: your-secret-key-here" \
-d '{"command": "give @a diamond 64"}'
Code (Javascript):
const response = await fetch ( 'http://localhost:8081/execute' , {
method : 'POST' ,
headers : {
'Content-Type' : 'application/json' ,
'X-Connector-Key' : 'your-secret-key-here'
} ,
body : JSON. stringify ( { command : 'say Hello from API!' } )
} ) ;
const result = await response. json ( ) ;
console. log (result ) ; // { "status": "queued", "command": "say Hello from API!" }
Code (Python):
import requests
response = requests. post ( 'http://localhost:8081/execute' ,
headers = {
'Content-Type': 'application/json' ,
'X-Connector-Key': 'your-secret-key-here'
} ,
json = { 'command': 'tp @a 0 100 0' }
)
print (response. json ( ) ) # { "status": "queued", "command": "tp @a 0 100 0" }
Important Security Recommendations:
- Change the default secret key to a strong, random string
- Use a firewall to restrict access to the API port (default: 8081)
- Consider using a reverse proxy with HTTPS for production environments
- Never expose the API directly to the public internet without proper security
- Whitelist IPs at the firewall level for maximum security
Commands & Permissions
Commands:
Code (Text):
/taberna-connector reload - Reload the plugin configuration
Code (Text):
taberna-connector.admin - Access to reload command (default: op)
Enable debug mode in config.yml for detailed logging:
Code (YAML):
debug : true
- Request source IP addresses
- Full request body contents
- Parsed command strings
- Command execution time in milliseconds
- Failed command warnings
- Stack traces for errors
Perfect for troubleshooting integration issues!
Requirements
- Minecraft: 1.21+ (tested on 1.21.10)
- Server: Paper Spigot (recommended) or Spigot
- Java: 21+
❓ FAQ
Q: Can I use this with Bukkit/CraftBukkit?
A: The plugin is designed for Paper Spigot but should work with standard Spigot. Bukkit/CraftBukkit are not officially supported.
Q: Is there rate limiting?
A: No built-in rate limiting. Implement rate limiting in your client application or use a reverse proxy.
Q: Can I execute multiple commands at once?
A: Send multiple API requests. Each request executes one command.
Q: What happens if a command fails?
A: The plugin logs the failure. Enable debug mode to see detailed error information.
Q: Is this compatible with other plugins?
A: Yes! Taberna Connector is lightweight and doesn't interfere with other plugins.
Support
Need help? Found a bug?
- Report Issues: Post in the discussion tab
License
This plugin is released under the MIT License. Free to use for personal and commercial projects.
⭐ If you like this plugin, please leave a review! ⭐
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Made with ❤️ by El_Brigos
Proudly sponsored by El-Taberna - Hosting
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Made with ❤️ by El_Brigos
Proudly sponsored by El-Taberna - Hosting
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
⚡ Taberna Connector ⭐ HTTP REST API for Remote Commands ✅ Secure | Paper 1.21+ is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 30 times (via Spigot). Download it and open it directly in the game.