Skip to content

Create, delete, start, stop and do much more with your Minecraft Servers

Notifications You must be signed in to change notification settings

Luckmuc/Blockpanel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

3e13fac · · Aug 24, 2025

History

47 Commits
Aug 6, 2025
Aug 6, 2025
Aug 6, 2025
Aug 6, 2025
Jul 3, 2025
Jul 20, 2025
Jul 29, 2025
Aug 6, 2025
Aug 6, 2025
Jul 20, 2025
Aug 1, 2025
Aug 4, 2025
Aug 2, 2025

Repository files navigation

Blockpanel

A private web panel for Minecraft server hosting. Built with Docker, FastAPI, and a modern UI.

Features (Backend)

  • Start/stop/status servers
  • Upload plugins
  • Read logs
  • Edit server.properties
  • Create worlds

Quickstart

  1. docker-compose up --build
  2. Test the panel at http://localhost:8000/docs

Blockpanel Backend

Features

  • FastAPI backend for Minecraft server panel
  • Multi-server management (Start, Stop, Kill, Restart, Status, Properties, Logs, Plugins, Worlds, EULA, Auth)
  • tmux process handling
  • JWT auth, secure uploads, directory traversal protection
  • Docker and docker-compose ready

Quickstart

  1. Build & Starttart

    docker compose up --build
  2. Test API

    • Login: /login (FormData: username, password)
    • Server APIs: /server/*
  3. Default Login

    • Username: admin
    • Password: admin

Notes

  • Server initialization, Purpur download, etc. is done via the API (/server/create).
  • Plugin upload: Only .jar allowed, max. 10MB, secure paths.
  • tmux must be installed in the container (see Dockerfile).

Security

  • JWT auth for all critical endpoints
  • Rate limiting recommended (optional)
  • Directory traversal protection everywhere

Troubleshooting (Linux/WSL)

  • Stelle sicher, dass alle Shell-Skripte (z.B. entrypoint.sh) mit Unix-Zeilenenden (LF) gespeichert sind. In VS Code unten rechts auf "LF" stellen.
  • Falls Fehler wie Exec format error auftreten, führe im Projektordner aus:
    dos2unix backend/entrypoint.sh
    chmod +x backend/entrypoint.shh
  • Die Dockerfiles und das Compose-File sind so angepasst, dass sie auf Linux und Windows funktionieren.

License

MIT

About

Create, delete, start, stop and do much more with your Minecraft Servers

Resources

Stars

Watchers

Forks

Packages

No packages published