Minecraft Server Web Management Panel

A lightweight Minecraft server web management panel with modern UI and comprehensive server management features.

Currently Supported Servers:

• ✅ Minecraft Bedrock Server
• Minecraft Java Server

🚀 Features

🌍 Minecraft Server Download

• Server Download Support for downloading specific server versions directly from the management page
• Server Version Switching Support for one-click server version switching

🎮 Server Control

• One-click Start/Stop/Restart Minecraft Bedrock server
• Real-time Status Monitoring Display server running status

⚙️ Configuration Management

• Support for all major configuration options:
  • Server name and description
  • Game mode (Survival/Creative/Adventure)
  • Difficulty settings (Peaceful/Easy/Normal/Hard)
  • Maximum player count
  • Server port configuration
  • Cheats and whitelist toggles
• Server Configuration File Management Automatically maintains server.properties file

👥 Whitelist Management

• Add/Remove Players Manage the list of players allowed to join the server
• Whitelist File Management Automatically maintains allowlist.json file

🛡️ Permission Management

• Three-tier Permission System:
  • Visitor - Basic game permissions
  • Member - Standard player permissions
  • Operator - Full administrative permissions
• Player Permission Settings Assign permission levels to specific players
• Permission File Management Automatically maintains permissions.json file

🌍 World Management

• World File Upload Support for .zip and .mcworld formats with automatic extraction
• World Switching One-click activation of different worlds
• World Deletion Safe deletion of unwanted world files
• Current World Identification Clear display of the currently active world

🌍 Resource Pack Management

• Resource File Upload Support for .zip and .mcpack formats
• Resource Activation One-click activation of different resource packs
• Resource Deletion Safe deletion of unwanted resource packs

📋 Server Logs

• Real-time Log Viewing Monitor Minecraft server logs in real-time through the web interface
• Auto-scroll Option to automatically scroll to the latest log entries

💻 Command Execution

• Direct Command Input Execute Minecraft server commands directly from the web interface
• Command History View and reuse previously executed commands
• Quick Commands Access frequently used commands through categorized quick access buttons

🔐 Authentication & Security

• Login System Secure access to the management panel with password authentication
• Session Management Automatic session handling with secure token-based authentication
• Access Control Protect server management functions from unauthorized access

📋 System Requirements

Server Environment

• Operating System: Windows 10+ or Ubuntu 18.04+ (Linux)
• Memory: At least 2GB RAM
• Storage: At least 10GB available space
• Network: Open ports 8080 (management panel) and 19132 (Minecraft server)

🛠️ Installation Guide

Quick Start (Recommended)

1. Download Pre-built Release:

   • Download the appropriate version for your operating system from the Releases page
   • minecraft-server-manager-windows.exe for Windows
   • minecraft-server-manager-linux for Linux

2. Run the Application:

   # For Linux
   chmod +x minecraft-server-manager-linux
   ./minecraft-server-manager-linux
   
   # For Windows
   minecraft-server-manager-windows.exe

Docker Deployment

1. Using Docker directly (Recommended):

   # Create data directory for persistent storage
   mkdir -p data
   
   # Run the container using the published image
   docker run -d \
     --name minecraft-easyserver \
     -p 8080:8080 \
     -p 19132:19132/udp \
     -p 19133:19133/udp \
     -v ./data:/data/bedrock-server \
     -v ./config:/data/config \
     ifanzhe/minecraft-easyserver:latest

2. Using Docker Compose:

   # Create docker-compose.yml file
   cat > docker-compose.yml << EOF
   version: '3.8'
   services:
     minecraft-server-manager:
       image: ifanzhe/minecraft-easyserver:latest
       container_name: minecraft-easyserver
       ports:
         - "8080:8080"
         - "19132:19132/udp"
         - "19133:19133/udp"
       volumes:
         - ./data:/data/bedrock-server
         - ./config:/data/config
       environment:
         - TZ=Asia/Shanghai
       restart: unless-stopped
       healthcheck:
         test: ["CMD", "curl", "-f", "http://localhost:8080"]
         interval: 30s
         timeout: 10s
         retries: 3
   EOF
   
   # Start with Docker Compose
   docker-compose up -d

3. Access the application:

   • Open browser and visit: http://localhost:8080
   • Server data will be persisted in the ./data directory

Build from Source (For Developers)

1. Prerequisites:

   • Go 1.21 or higher
   • Node.js 16+ and npm (for frontend compilation)

2. Clone Repository:

   git clone https://github.com/ckfanzhe/bedrock-easy-server.git
   cd minecraft-easy-server

3. Build All Platforms (Recommended):

   chmod +x build.sh
   ./build.sh

   This script will:

   • Install frontend dependencies (npm install)
   • Build the Vue.js frontend (npm run build)
   • Copy built assets to the embed directory
   • Compile Go binaries for all platforms with embedded frontend

4. Manual Build Steps (if you prefer step-by-step):

   # Build frontend first
   cd minecraft-easyserver-web
   npm install
   npm run build
   cd ..
   
   # Copy frontend build output
   rm -rf web/*
   cp -r minecraft-easyserver-web/dist/* web/
   
   # Build Go binary
   go build -o minecraft-server-manager

Note: The build process now includes frontend compilation using webpack, which bundles all Vue.js components, styles, and assets into optimized files that are then embedded into the Go binary for single-file deployment.

🚀 Usage Guide

Start Management Panel

1. Run the Application:

   # For Linux
   ./minecraft-server-manager-linux
   
   # For Windows double-click to run
   minecraft-server-manager-windows.exe

2. Access Management Interface:

   • Open browser and visit: http://localhost:8080
   • The management panel will load automatically

🔥 Firewall Configuration

Windows Firewall

On some systems, when you wish to connect to the server using a client running on the same machine as the server is running on, you will need to exempt the Minecraft client from UWP loopback restrictions:

CheckNetIsolation.exe LoopbackExempt -a -p=S-1-15-2-1958404141-86561845-1752920682-3514627264-368642714-62675701-733520436

Ensure the following ports are open in the firewall:

• 8080: Management panel access port
• 19132: Minecraft Bedrock server default port
• 19133: Minecraft Bedrock server IPv6 port

📝 Additional Information

TODO Planned Features

• ✅ Support for one-click mcpackage mod import
• ✅ Linux operating system support
• ✅ Real-time Bedrock server log viewing
• ✅ Direct command execution to Bedrock server through web interface
• 🔄 Player online status monitoring
• ✅ Server performance monitoring
• 🔄 Automatic world backup functionality
• ✅ Multi-language interface support
• 🔄 Java Server Support - Support for Minecraft Java Edition servers
• ✅ Docker Support - Containerized deployment support

🤝 Contributing

Welcome to submit issue reports, feature suggestions, and code contributions!

Development Environment Setup

1. Fork the project repository
2. Create a feature branch: git checkout -b feature/new-feature
3. Commit changes: git commit -am 'Add new feature'
4. Push branch: git push origin feature/new-feature
5. Create Pull Request

Code Standards

• Use Go standard code formatting
• Add appropriate comments and documentation
• Ensure code passes tests
• Follow the project's architectural patterns

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Gin Web Framework - High-performance Go web framework
• Tailwind CSS - Utility-first CSS framework
• Font Awesome - Icon library
• Minecraft Bedrock - Game server

👀 Management Panel Preview

Screenshots of some features, more features are welcome to be experienced in person.