RainKing Panel (雨王面板)

One-click Minecraft server deployment with full-featured web management panel.

A single command deploys a complete Minecraft server with RainKing web panel. Supports Vanilla / PaperMC / Fabric across all versions (1.7.10 through 26.2).

---

Features

One-Click Deploy

• Interactive guided setup: choose version, port, memory allocation
• Command-line mode: --version 1.21.1 --type paper --port 25566 --auto for fully automated install
• Auto-detects OS (Ubuntu / Debian)
• Auto-installs correct Java version (8 / 17 / 21) based on Minecraft version

Web Management Panel

Feature	Description
Dashboard	Server status, MC process memory, system memory, player count, real-time logs
Player Management	Online player list, gamemode, teleport, give items (756 items with Chinese search), XP, effects, kick/ban/op
Console	WebSocket real-time bidirectional console, all Minecraft commands supported
Game Settings	19 gamerules, world environment, whitelist, server properties, online-mode toggle
World Management	Multi-world switching, seed configuration, URL map import (zip), world border
Backup Management	Manual/auto scheduled backups, auto-cleanup, download, upload, restore
Scoreboard	Create, delete, query scoreboards, set player scores
Structure Locate	Locate 24 structure types near spawn or selected player
Player Activity	Join/leave/death/chat/command event tracking from server logs
Server Config	Port, memory, server type (Vanilla/Paper/Fabric), version switching (843 versions)

Multi-Version & Multi-Type

• Vanilla: Official Mojang server, all versions
• PaperMC: Plugin server with performance optimizations
• Fabric: Mod server, lightweight mod support

---

One-Click Install

# Interactive install (recommended)
curl -sL https://raw.githubusercontent.com/PhiRainking/minecraft-panel/main/install.sh | sudo bash

# Command-line quick deploy
curl -sL https://raw.githubusercontent.com/PhiRainking/minecraft-panel/main/install.sh | sudo bash -s -- \
  --version 1.21.1 \
  --type paper \
  --port 25566 \
  --panel-port 24454 \
  --memory 2048 \
  --auto

Parameters

Parameter	Default	Description
--version	1.21.1	Minecraft version
--type	vanilla	vanilla / paper / fabric
--port	25566	Game server port
--panel-port	24454	Web panel port
--memory	auto	Max memory (MB)
--user	admin	Panel username
--pass	random	Panel password
--auto	-	Non-interactive mode

---

Management Commands

# Minecraft service
systemctl start minecraft      # Start
systemctl stop minecraft       # Stop
systemctl restart minecraft    # Restart
systemctl status minecraft     # Status

# Web panel
systemctl start mc-panel
systemctl restart mc-panel

# View logs
tail -f /opt/minecraft/logs/server.log

---

Directory Structure

/opt/minecraft/
├── server.jar              # Server jar
├── start.sh                # Launch script
├── server.properties       # Server configuration
├── eula.txt
├── world/                  # Current world
├── worlds/                 # Multi-world storage
│   ├── survival/
│   └── creative/
├── backups/                # Backup archives
├── plugins/                # PaperMC plugins
├── logs/
│   └── server.log
└── panel/                  # Web panel
    ├── app.js
    ├── package.json
    └── public/
        └── index.html

---

System Requirements

Item	Minimum	Recommended
OS	Ubuntu 20.04 / Debian 11	Ubuntu 24.04
CPU	1 core	2+ cores
Memory	1 GB (Vanilla 1.12)	2+ GB (1.21+)
Disk	2 GB	10+ GB
Java	Auto-installed	OpenJDK 21

Note: PaperMC / Fabric require more memory. 1.21.1 Paper recommends 2GB+.

---

REST API

The panel provides a REST API for automation:

# Server status
curl -u admin:password http://localhost:24454/api/status

# Send command
curl -u admin:password -X POST http://localhost:24454/api/command \
  -H 'Content-Type: application/json' -d '{"cmd":"time set day"}'

# Create backup
curl -u admin:password -X POST http://localhost:24454/api/backups

---

Development

git clone https://github.com/PhiRainking/minecraft-panel.git
cd minecraft-panel

# Deploy panel only (existing MC server)
cd panel && npm install && node app.js

---

Roadmap

• One-click install script
• Vanilla / Paper / Fabric support
• Web panel (dashboard, players, console, settings)
• World management (switch, seed, import)
• Backup & restore
• Scoreboard management
• World border
• Whitelist & ban management
• Auto-backup scheduler
• Structure locate
• Player activity tracking
• Server type & version switching from panel
• Plugin manager (Paper)
• Dynmap integration
• Multi-user panel permissions
• Docker deployment

---

License

MIT (c) RainKing