Player Panel

Player Panel is a self-hosted web control panel for Minecraft Java servers. It combines a responsive web application, a Fabric server mod, optional Crafty Controller integration, and optional BlueMap/squaremap map pickers.

Release status: Beta. Back up your server and Player Panel data before upgrading.

Project origin and public release policy

Player Panel is a vibe-coding project created through an iterative collaboration between the project owner and ChatGPT. The source code and documentation in this repository were written by ChatGPT from the owner's requirements, testing, feedback, and real deployment results.

v1.0.0-beta.1 is intended to be the only official public release from the original project. No additional public releases, updates, maintenance, or support are promised by the original project.

The project is distributed under the MIT License. Anyone is free to use it, study it, modify it, redistribute it, and create a fork. Forks are explicitly encouraged for anyone who wants to fix issues, add features, support other Minecraft versions, or continue development independently. Please retain the required MIT license and copyright notice.

Because this is the only planned public release, pull requests and support requests may not be reviewed. For ongoing development, use your own fork.

What it provides

• Player list, details, inventory, health, food, game mode, teleport, kick, ban, operator, and whitelist actions.
• Saved teleport locations with squaremap thumbnails and map-based coordinate selection.
• World time and weather controls.
• Alerts, action history, sessions, metrics, push notifications, roles, and multi-server profiles.
• Optional Crafty integration for discovery, start/stop/restart, logs, status, and backups.
• Optional BlueMap 3D and squaremap 2D integrations.
• PWA support for desktop, Android, iPhone, and iPad.

Screenshots

Dashboard

The dashboard provides a real-time overview of the selected Minecraft server, including world status, time and weather controls, online players, active alerts, recent sessions, actions, and plugin metrics.

Light and dark modes

Dark mode

Light mode

Player management

Player Panel provides player profiles, live inventory viewing, health and food information, game mode controls, teleportation, whitelist management, operator permissions, kicks, bans, and other moderation actions.

Saved locations and teleportation

Save reusable teleport destinations with world coordinates, orientation, map thumbnails, and direct access to BlueMap or squaremap coordinate selection.

Map-based coordinate selection

BlueMap 3D Select an exact Minecraft block and send its X, Y and Z coordinates directly to Player Panel.

squaremap 2D Choose a destination from a lightweight two-dimensional map with safe Y-coordinate calculation.

Server configuration

Servers can be added through a direct connection to the Player Panel Fabric API or imported from an existing Crafty Controller installation.

Crafty Controller integration

The optional Crafty Controller integration provides server discovery, status and metrics, start, stop and restart actions, recent console output, and backup management.

Responsive mobile interface

Desktop and mobile support Player Panel includes a responsive interface designed for desktop computers, tablets, Android devices, iPhone and iPad. The mobile layout provides: • touch-friendly navigation; • compact server selection; • responsive dashboard cards; • world time and weather controls; • alerts and server status information; • PWA installation support.

Mobile dashboard

Included versions

Component	Version
Full bundle	1.0.0-beta.1
Player Panel Web	1.10.19
Player Panel Fabric	1.1.7
Target Minecraft	26.1.2
BlueMap bridge	v6
squaremap bridge	v7

The repository does not redistribute Minecraft, Crafty Controller, Fabric Loader, Fabric API, BlueMap, or squaremap. The guided installer can download compatible optional dependencies after explicit confirmation.

Installation paths

Choose the path that matches your deployment:

A. Full guided installation

Use this when Crafty and the Minecraft server are on the same machine, or when you want the installer to create a new Crafty deployment.

Download the official full installation package from the v1.0.0-beta.1 release, extract it, and start the guided installer:

VERSION="1.0.0-beta.1"
PACKAGE="player-panel-${VERSION}.zip"
INSTALL_DIR="/tmp/player-panel-${VERSION}"

cd /tmp
rm -rf "${INSTALL_DIR}"
curl -fL \
  "https://github.com/linkzeld17/player-panel/releases/download/v${VERSION}/${PACKAGE}" \
  -o "${PACKAGE}"

mkdir -p "${INSTALL_DIR}"
unzip -q "${PACKAGE}" -d "${INSTALL_DIR}"
cd "$(dirname "$(find "${INSTALL_DIR}" -type f -name install.sh -print -quit)")"
chmod +x install.sh
./install.sh

The installer can:

1. install Docker Engine and Docker Compose v2 on Ubuntu/Debian;
2. reuse an existing Crafty container or install Crafty;
3. discover or select a Fabric 26.1.2 server;
4. configure online/offline authentication and whitelist enforcement;
5. verify or install Fabric API, squaremap, and BlueMap;
6. install the Player Panel Fabric mod and map bridges;
7. install Player Panel Web and display the detected access URLs.

See Full installation.

B. Web panel only

Use this when Crafty/Minecraft run on another server, or when you want to connect everything manually from the web UI.

The full release bundle also includes the web-only installer. Download the official package from the v1.0.0-beta.1 release, extract it, and run install-panel-only.sh:

VERSION="1.0.0-beta.1"
PACKAGE="player-panel-${VERSION}.zip"
INSTALL_DIR="/tmp/player-panel-${VERSION}"

cd /tmp
rm -rf "${INSTALL_DIR}"
curl -fL \
  "https://github.com/linkzeld17/player-panel/releases/download/v${VERSION}/${PACKAGE}" \
  -o "${PACKAGE}"

mkdir -p "${INSTALL_DIR}"
unzip -q "${PACKAGE}" -d "${INSTALL_DIR}"
cd "$(dirname "$(find "${INSTALL_DIR}" -type f -name install-panel-only.sh -print -quit)")"
chmod +x install-panel-only.sh
./install-panel-only.sh

The installer offers three clear starting modes:

1. Direct plugin connection — connect to the Fabric mod API without Crafty.
2. Crafty-assisted setup — register Crafty, discover servers, and optionally add management features.
3. Configure later — install an empty panel and open the Add Server wizard after login.

See Web-only installation and Remote connections.

Quick start

Requirements

• Linux server; Ubuntu 22.04/24.04 or Debian 12 recommended.
• root access or a user with sudo.
• curl and unzip to download and extract the release package.
• Docker Engine and Docker Compose v2, or permission for the installer to install them.
• For the full path: Crafty Controller and a Minecraft Java Fabric 26.1.2 server.
• At least 10 characters for the initial Player Panel administrator password.

Install the web panel only without preconfiguring servers

PLAYER_PANEL_ADMIN_PASSWORD='replace-with-a-strong-password' \
./install-panel-only.sh \
  --setup-mode later \
  --non-interactive \
  --yes

Default access:

http://SERVER_IP:8766

For permanent Internet exposure, place Player Panel behind an HTTPS reverse proxy.

Updating

Update only the web application without changing Minecraft, Crafty, mods, whitelist, or map configuration:

./update-web.sh --install-root /opt/player-panel --yes

Repair a complete local installation while preserving web data and secrets:

./repair-server.sh \
  --install-root /opt/player-panel \
  --container crafty-controller \
  --server-id YOUR_SERVER_UUID \
  --auth-mode keep \
  --yes

See Updating.

Validation

chmod +x tests/*.sh tests/mock-docker
./tests/test-package.sh

For an installed system:

./validate.sh \
  --install-root /opt/player-panel \
  --container crafty-controller \
  --server-id YOUR_SERVER_UUID

Network ports

Default ports used by the full installer:

Service	Port	Protocol
Player Panel Web	8766	TCP/HTTP
Player Panel Fabric API	8765	TCP/HTTP or proxied HTTPS
Crafty Web	8443	TCP/HTTPS
Minecraft Java	25565	TCP
Minecraft Bedrock (optional)	19132	UDP
BlueMap (optional)	8100	TCP/HTTP
squaremap (optional)	8110	TCP/HTTP

Only expose the ports your architecture requires. Prefer HTTPS reverse proxies for public access.

Repository layout

components/fabric/          Fabric mod release JAR
components/web/             Web application and Docker files
integrations/bluemap/       BlueMap browser bridge
integrations/squaremap/     squaremap browser bridge
scripts/lib/                Shared installer helpers
scripts/maps/               Optional map setup scripts
tests/                      Installer and package regression tests
docs/                       Installation and operations documentation
.github/                    GitHub templates and CI workflow

Security

• Never commit .env, SQLite databases, tokens, passwords, VAPID keys, backups, or real installation reports.
• Keep the Fabric API token private.
• Use a dedicated Crafty API token with the minimum required permissions.
• Prefer HTTPS for Player Panel, Crafty, plugin APIs, BlueMap, and squaremap when traffic crosses untrusted networks.
• Review SECURITY.md before publishing an instance.

Documentation

• Full installation
• Web-only installation
• Remote connections
• Updating
• Troubleshooting
• Architecture
• Testing
• Release checklist
• Publishing to GitHub

License

Player Panel is released under the MIT License. Third-party projects retain their own licenses; see THIRD_PARTY_NOTICES.md.