Skip to content

Th0rgal/mcpanel

Repository files navigation

MCPanel

MCPanel

Open source macOS Minecraft server control panel. Beautiful. Minimal. Native.

Screenshots · Features · Build


Screenshots

Server Monitor

Monitor - Real-time TPS, memory, storage, network stats, and performance timeline


Live Console

Console - Live console with full truecolor ANSI support and command autocomplete


Plugin Manager

Plugins - One-click enable/disable

File Browser

Files - Native file browser

Properties Editor

Properties - Visual config editor

Server Settings

Settings - Connection configuration


What is this?

MCPanel is a native macOS application for managing remote Minecraft servers. It provides a clean, minimal interface with a liquid glass aesthetic that feels right at home on macOS.

This project is fully open source. Clone it, build it, modify it, use it however you like.

Features

Feature Description
Multi-Server Manage multiple remote Minecraft servers
Live Console Real-time log streaming with 24-bit truecolor ANSI support
Server Monitor TPS, memory, CPU, storage, and network metrics at a glance
Plugin Manager Enable/disable plugins with a single click
File Browser Native macOS-style file explorer for server files
Properties Editor Visual editor for server.properties with categories
Version Manager Download and update server JARs via mcjarfiles.com

Requirements

  • macOS 14.0+ (Sonoma)
  • SSH access to your Minecraft server
  • Optional: MCPanelBridge plugin for real-time metrics

MCPanelBridge Plugin

For enhanced server monitoring (TPS, memory, player events), install the companion plugin:

Platform Download
Bukkit/Paper MCPanelBridge-Bukkit.jar
Velocity MCPanelBridge-Velocity.jar

Place the JAR in your server's plugins/ folder and restart.

Building

Quick Build

./build-app.sh

This will:

  1. Build the app in release mode
  2. Create the MCPanel.app bundle
  3. Launch the app automatically

Clean Rebuild

swift package clean && rm -rf .build MCPanel.app && ./build-app.sh

Configuration

Server configurations are stored in:

~/Library/Application Support/MCPanel/

SSH credentials are stored securely in macOS Keychain.

Keyboard Shortcuts

Key Action
⌘N Add new server
⌘⌫ Remove selected server
⌘R Restart server
⌘. Stop server
⌘⏎ Send console command
⌘1-9 Quick switch servers

Project Structure

mcpanel/
├── mcpanel/
│   ├── Models/           # Server, Plugin, ConsoleMessage
│   ├── Services/         # SSH, RCON, FileTransfer, Persistence
│   ├── Views/            # SwiftUI views
│   └── Assets.xcassets/  # App icons and colors
├── build-app.sh          # Build script
└── Package.swift         # Swift Package Manager config

Created by Th0rgal • Also check out Oraxen, MCServerJars, and HackedServer

About

Manage your Minecraft servers from your Mac. Beautiful native interface with live console, real-time monitoring, plugin management, and secure SSH connections.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors