CraftPanel Web, Minecraft Server Manager

CraftPanel Web

Modern, Lightweight, and Comprehensive Web Administration Panel for Minecraft Servers

Developed by lHawk_

YouTube の動画です。見るためにクリックしたときだけ読み込まれます。

1. Overview

CraftPanel Web is a native, production-grade Minecraft plugin and integrated web administration panel designed to manage, monitor, and configure your Minecraft server directly from any web browser. Inspired by the clean usability and structure of Pterodactyl Panel, CraftPanel Web operates natively from inside your server without requiring separate daemon processes, external panel infrastructures, or heavy background runtimes.

Installed directly into your server's plugins/ folder, CraftPanel Web embeds a high-performance Javalin web server powered by Java 21 and a persistent local SQLite database. It gives server administrators, staff members, and friends full control over console commands, configuration files, plugin management, Modrinth downloads, system health, and backups through a clean, responsive web interface.

2. Key Features

• Single Native Instance: Directly controls the running Minecraft host instance, eliminating the need for complex multi-node daemons or remote agent setups.
• Interactive Real-Time Console: High-performance WebSocket terminal with ANSI and Minecraft color code parsing, CMD-level fidelity, zero-latency log streaming from byte 0, instant search, toggleable autoscroll, and thread-safe command execution with Folia support.
• Dynamic Plugin Loading with Brigadier Sync: Hot-load, enable, and unload plugins at runtime with automatic Bukkit CommandMap registration, Mojang Brigadier tree rebuild (syncCommands), and client packet updates (updateCommands). Installed plugins run their commands immediately without restarting the server.
• Advanced Syntax-Highlighted File Editor: Full-featured in-browser code editor featuring synchronized line numbers, search and replace with match counts, Tab key indentation, and syntax highlighting for YAML (config.yml, spigot.yml, paper-global.yml), Properties (server.properties), JSON, and script files.
• Plugin Manager & Modrinth Integration: Browse, enable, disable, and delete installed plugins with automatic backup preservation and optional configuration folder deletion. Discover, inspect, and install plugins directly from the official Modrinth API v2 with one click.
• Reactive Server Lifecycle Management: Dynamic Start, Stop, and Restart controls that react instantly to server state with an animated transition overlay and automatic process recovery.
• Granular Role-Based Access Control (RBAC): Create and assign user accounts with custom roles (Admin, Server Manager, Operator, Viewer) and fine-grained permissions. Add accounts directly in-game or from console using /craftpanel createuser.
• Real-Time Monitoring & Telemetry: Live metrics tracking CPU load, JVM memory allocation, free disk space, server uptime, and online player count.
• Integrated Backup Engine: Create automated or manual ZIP archives of server files with integrity hashing and instant web download.
• Persistent Audit Logging: Comprehensive record of all logins, file modifications, console commands, and permission changes stored in local SQLite database.
• Internationalization (i18n): English by default with instant runtime language switching to Portuguese.

3. Platform Compatibility

4. Commands and Permissions

5. Step-by-Step Installation

1. Download the latest CraftPanel.jar file.
2. Place the jar into your server's plugins/ folder.
3. Start or restart your Minecraft server.
4. Notice the console message containing your one-time Setup Security Key (e.g. CP-ABCD-1234).
5. Open your web browser and navigate to:

   http://localhost:2222

6. Enter the console security key along with your administrator username and password to create the master account.
7. Log in and start administering your server!

6. Configuration Reference (config.yml)

CraftPanel Web creates a fully commented config.yml file in its plugin folder:

# Language setting ("en" for English, "pt" for Portuguese)
language: "en"

# HTTP network binding (default 0.0.0.0:2222 for immediate remote access)
server:
  host: "0.0.0.0"
  port: 2222

# Security policy
security:
  remote_access_enabled: true
  session_timeout_minutes: 60
  require_secure_cookies: false
  max_failed_login_attempts: 5
  lockout_duration_minutes: 15

# Modrinth official API integration
modrinth:
  enabled: true
  user_agent: "CraftPanel-Web/1.2.2 (contact: minebuilders.com.br/discord)"
  api_url: "https://api.modrinth.com/v2"

# System monitoring
monitoring:
  refresh_interval_seconds: 3

7. Performance and Security Architecture

• Console One-Time Security Key: On first boot, CraftPanel generates a secure temporary key announced directly to the server console, preventing unauthorized players from claiming the administrator account before you do.
• Bidirectional Real-Time Synchronization: File modifications and directory changes synchronize instantly across all connected panel users via WebSocket, including open code editor tabs.
• In-Console Command Autocomplete: Native command suggestion bar and autocomplete matching in-game behavior for effortless command execution.
• Asynchronous Thread Isolation: The Javalin web server, WebSocket handlers, and SQLite database transactions run strictly on background worker threads, never blocking server ticks.
• Folia-Compatible Scheduling: Console command dispatching uses Folia's GlobalRegionScheduler when running on Folia, ensuring complete thread safety.
• Path Traversal Defense: All file reading, writing, renaming, and uploading routines canonicalize paths and verify boundaries to prevent unauthorized filesystem access.
• Argon2 / BCrypt Password Hashing: User passwords are encrypted using modern cryptographic salt hashing.
• Zero Bloat & Hand-Drawn Vector Icons: Built with pure vanilla ES6 JavaScript and clean vector SVGs, with zero emojis and zero external frontend dependencies.

8. Frequently Asked Questions (FAQ)