Sueta

MinecraftREST

1.0.1

MinecraftREST, a powerful REST API interface for Minecraft servers that provides secure endpoints for server management and player interactions.

·Plugin
  1. 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/kick endpoint to use Bukkit's scheduler - Modified /api/player/gamemode endpoint to use Bukkit's scheduler - Improved error handling for async operations - Follows the same pattern as the command execution endpoint for thread safety

    Developer 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 scheduling

    Installation

    1. Download the minecraft-rest-1.0.1.jar from this release 2. Place it in your server's plugins folder 3. Start/restart your server 4. Configure the plugin in plugins/MinecraftREST/config.yml

    Important Security Reminder ⚠️

    Remember to change the default security settings in config.yml: - Change the JWT secret - Update admin credentials - Consider using HTTPS in production

    Documentation

    Full documentation is available in: - README.md in the repository - api-docs/swagger.yaml for API specification
    87 downloads
  2. 1.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 logging
    API 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 control
    Security Features
    - JWT-based authentication system - Configurable rate limiting - Secure password hashing with BCrypt - Request validation and sanitization - Customizable admin credentials
    Configuration
    - Flexible config.yml system - Configurable API port - Customizable JWT secret - Adjustable rate limiting - Admin credential management
    Documentation
    - Comprehensive README documentation - API endpoint documentation - Security best practices guide - Installation and configuration instructions
    Technical 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.
    38 downloads

Similar projects

Plugin →