MinecraftREST
1.0.1MinecraftREST, a powerful REST API interface for Minecraft servers that provides secure endpoints for server management and player interactions.
1.0.1latestMinecraftREST 1.0.1Mar 16, 2025 MinecraftREST 1.0.1
Bug Fixes
- Fixed an error that occurs because trying to kick a player from an asynchronous thread (the HTTP request thread) while Bukkit/Spigot requires player operations to be performed on the main server thread. - Fixed similar thread safety issues with the gamemode change endpoint. - Both operations now properly run on the main server thread using BukkitRunnable.Technical Details
- Modified/api/player/kickendpoint to use Bukkit's scheduler - Modified/api/player/gamemodeendpoint to use Bukkit's scheduler - Improved error handling for async operations - Follows the same pattern as the command execution endpoint for thread safetyDeveloper Notes
- If you're using these endpoints in your code, no changes are required on your end - The API interface and responses remain the same - Operations may take a few milliseconds longer due to thread schedulingInstallation
1. Download theminecraft-rest-1.0.1.jarfrom this release 2. Place it in your server'spluginsfolder 3. Start/restart your server 4. Configure the plugin inplugins/MinecraftREST/config.ymlImportant Security Reminder
Remember to change the default security settings inconfig.yml: - Change the JWT secret - Update admin credentials - Consider using HTTPS in productionDocumentation
Full documentation is available in: - README.md in the repository - api-docs/swagger.yaml for API specification1.0.0MinecraftREST 1.0.0Mar 16, 2025 Changelog
[1.0.0] - 2024-03-20 - Initial Release
Added
- Complete RESTful API implementation for Minecraft server management - Secure JWT authentication system - Rate limiting protection (configurable requests per minute) - Comprehensive error handling and loggingAPI Endpoints
- Authentication - POST /api/auth/login - Secure login endpoint with JWT token generation - Server Management - GET /api/server/info - Server status and information - POST /api/server/command - Remote console command execution - POST /api/broadcast - Server-wide message broadcasting - Player Management - GET /api/players - Online player listing with detailed information - POST /api/player/message - Individual player messaging - POST /api/player/kick - Player removal management - POST /api/player/gamemode - Player gamemode controlSecurity Features
- JWT-based authentication system - Configurable rate limiting - Secure password hashing with BCrypt - Request validation and sanitization - Customizable admin credentialsConfiguration
- Flexible config.yml system - Configurable API port - Customizable JWT secret - Adjustable rate limiting - Admin credential managementDocumentation
- Comprehensive README documentation - API endpoint documentation - Security best practices guide - Installation and configuration instructionsTechnical Details
- Built for Spigot/Paper 1.20.4 - Java 17 compatibility - Maven-based build system - MIT License Note: This is the initial release of MinecraftREST. Future versions will build upon this foundation based on community feedback and needs.
Similar projects
Plugin →VeinMiner
Mine the whole vein on mining a single ore/block. Make the tedious mining experience to something satisfying and fun! FTB Ultimine alternative
99.3MSueta
Simple Voice Chat
A working voice chat in Minecraft!
76.8MSueta
Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
25MSueta
Chunky
Pre-generates chunks, quickly and efficiently
18.4MSueta
VeinMiner Enchantment
Veinminer Addon - Adds vineminer enchantment to enchanting tables. Only tools with the enchantment can veinmine
18MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta